Merge pull request #2349 from DARMA-tasking/2347-release-vt-v150

#2347: Release vt v1.5.0

.github/workflows/build-docs.yml

@@ -30,6 +30,6 @@ jobs:
       TOKEN: ${{ secrets.GH_PAT }}
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build the Docker image
-      run: docker-compose run ubuntu-docs
+      run: docker compose run ubuntu-docs

.github/workflows/build-statistics.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Generate build stats
         uses: DARMA-tasking/build-stats@master

.github/workflows/check-commit-format.yml

@@ -7,7 +7,7 @@ jobs:
     name: Check commit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           ref: ${{ github.event.pull_request.head.sha }}

.github/workflows/check-include-guards.yml → .github/workflows/check-include-guards-and-license.yml

@@ -1,4 +1,4 @@
-name: Check header guards
+name: Check header guards and license
 
 on: pull_request
 
@@ -8,15 +8,12 @@ jobs:
     steps:
 
       - name: Checkout source code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup Dependencies
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
             python-version: '3.7'
 
-      - name: Install checkguard
-        run: pip install guardonce
-
-      - name: Check that include guards are properly named
+      - name: Check that for correct include guards and license
         run: ./scripts/check_guards.sh $(pwd)

.github/workflows/check-trailing-whitespace.yml

@@ -7,7 +7,7 @@ jobs:
     name: Find Trailing Whitespace
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: DARMA-tasking/find-trailing-whitespace@master
         with:
           exclude: "sketches;lib"

.github/workflows/macosx-clang-mpich.yml

@@ -32,14 +32,14 @@ jobs:
       CMAKE_BUILD_PARALLEL_LEVEL: 4
 
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/cache@v3
+      - uses: actions/checkout@v4
+      - uses: actions/cache@v4
         with:
           path: ~/.ccache
           key: ${{ runner.os }}-macosx-clang-14-ccache-${{ secrets.GH_ACTIONS_CACHE_VERSION }}-${{ hashFiles('**/*') }}
           restore-keys: |
             ${{ runner.os }}-macosx-clang-14-ccache-${{ secrets.GH_ACTIONS_CACHE_VERSION }}
-      - uses: actions/cache@v3
+      - uses: actions/cache@v4
         id: mpich-cache
         with:
           path: ~/.mpich

.github/workflows/pushdockerimage.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Docker Build & Push
         uses: jerray/publish-docker-action@master
         with:

.github/workflows/run-git-check.yml

@@ -7,7 +7,7 @@ jobs:
     name: Run git check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           ref: ${{ github.event.pull_request.head.sha }}

.gitignore

@@ -5,6 +5,7 @@ lib/*-build
 lib/checkpoint
 lib/googletest
 lib/kokkos
+lib/vt-tv
 .emacs.desktop
 .clangd/
 .vscode/
@@ -21,6 +22,7 @@ compile_commands.json
 *.lo
 *.o
 *.obj
+*.pyc
 
 # Precompiled Headers
 *.gch

CITATION.cff

@@ -0,0 +1,32 @@
+cff-version: 1.2.0
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+title:  DARMA/vt => Virtual Transport
+authors:
+  - family-names: DARMA Team
+url: https://darma-tasking.github.io/docs/html/index.html
+preferred-citation:
+  type: conference-paper
+  title: "Design and implementation techniques for an MPI-oriented AMT runtime"
+  authors:
+  - given-names: Jonathan
+    family-names: Lifflander
+  - given-names: Phil
+    family-names: Miller
+  - given-names: Nicole Lemaster
+    family-names: Slattengren
+  - given-names: Nicolas
+    family-names: Morales
+  - given-names: Paul
+    family-names: Stickney
+  - given-names: Philippe P
+    family-names: P{\'e}ba{\"y}
+  collection-title: "2020 Workshop on Exascale MPI (ExaMPI)"
+  collection-type: proceedings
+  year: 2020
+  start: 31 # First page number
+  end: 40 # Last page number
+  publisher:
+    name: "IEEE"
+  url: "https://www.osti.gov/servlets/purl/1825838"

CMakeLists.txt

@@ -68,7 +68,7 @@ include(cmake/configure_options.cmake)
 include(cmake/check_compiler.cmake)
 include(cmake/nvcc_no_deprecated_gpu_targets.cmake)
 include(cmake/load_bundled_libraries.cmake)
-
+include(cmake/load_local_packages.cmake)
 
 # Primary VT build
 add_subdirectory(src)

LICENSE

@@ -1,8 +1,8 @@
-                          DARMA Toolkit v. 1.0.0
+                          DARMA Toolkit v. 1.5.0
                        DARMA/vt => Virtual Transport
                     For version number see VERSION file
 
-Copyright 2019-2021 National Technology & Engineering Solutions of Sandia, LLC
+Copyright 2019-2024 National Technology & Engineering Solutions of Sandia, LLC
 (NTESS). Under the terms of Contract DE-NA0003525 with NTESS, the U.S.
 Government retains certain rights in this software.
 

README.md

@@ -51,3 +51,48 @@ runtime.
 
 [Learn how to build](https://darma-tasking.github.io/docs/html/vt-build.html)
 *vt* with `cmake` or `docker`.
+
+## References
+
+Lifflander, J., M. Bettencourt, N. Slattengren, G. Templet, P. Miller,
+P. P. Pébaÿ, M. Perrinel, and F. Rizzi. 2019. “DARMA-EMPIRE Integration
+and Performance Assessment – Interim Report.” Sandia Report
+SAND2019-1134. https://www.osti.gov/servlets/purl/1493825.
+https://doi.org/<https://doi.org/10.2172/1493825>.
+
+Lifflander, Jonathan, Phil Miller, Nicole Lemaster Slattengren, Nicolas
+Morales, Paul Stickney, and Philippe P Pébaÿ. 2020. “Design and
+Implementation Techniques for an MPI-Oriented AMT Runtime.” In *2020
+Workshop on Exascale MPI (ExaMPI)*, 31–40.
+https://www.osti.gov/biblio/1825838: IEEE.
+
+Lifflander, Jonathan, Nicole Lemaster Slattengren, Philippe P Pébaÿ,
+Phil Miller, Francesco Rizzi, and Matthew T Bettencourt. 2021.
+“Optimizing Distributed Load Balancing for Workloads with Time-Varying
+Imbalance.” In *2021 IEEE International Conference on Cluster Computing
+(CLUSTER)*, 238–49. https://www.osti.gov/servlets/purl/1870576: IEEE.
+https://doi.org/<https://doi.org/10.1109/Cluster48925.2021.00039>.
+
+Lifflander, J., and P. P. Pébaÿ. 2020. “<span class="nocase">DARMA/vt
+FY20</span> Mid-Year Status Report.” Sandia Report SAND2020-3967.
+https://www.osti.gov/servlets/purl/1615717.
+https://doi.org/<https://doi.org/10.2172/1615717>.
+
+Pébaÿ, P. L., J. Lifflander, P. P. Pébaÿ, and Sean T. McGovern. 2023.
+“<span class="nocase">vt-tv: A New C++ Application to Efficiently
+Visualize and Analyze Asynchronous Many-Task Work Distributions and
+Attendant Quantities of Interest</span>.” Sandia Report SAND2023-09312.
+
+Pébaÿ, P. L., N. Slattengren, Sean T. McGovern, and J. Lifflander. 2023.
+“<span class="nocase">Modeling Workloads of a LinearElectromagnetic Code
+for Load BalancingMatrix Assembly</span>.” Sandia Report SAND2023-10469.
+
+Pébaÿ, P. P., and J. Lifflander. 2019a. “Using
+<span class="nocase">Sandia’s Automatic Report Generator</span> to
+Document EMPIRE-Based Electrostatic Simulations.” Sandia Report
+SAND2019-4269. https://www.osti.gov/servlets/purl/1762099.
+https://doi.org/<https://doi.org/10.2172/1762099>.
+
+———. 2019b. “Some Results about Distributed Load Balancing.” Sandia
+Report SAND2019-5139. https://www.osti.gov/servlets/purl/1762597.
+https://doi.org/<https://doi.org/10.2172/1762597>.

References.bib

@@ -0,0 +1,85 @@
+@TechReport{pebay:sand10469,
+  author = {P. L. Pébaÿ and N. Slattengren and Sean T. McGovern and J. Lifflander},
+  title = {{Modeling Workloads of a LinearElectromagnetic Code for Load BalancingMatrix Assembly}},
+  year = 2023,
+  type = {Sandia Report},
+  number = {SAND2023-10469},
+  month = oct,
+  address = {}
+}
+
+@TechReport{pebay:sand09312,
+  author = {P. L. Pébaÿ and J. Lifflander and P. P. Pébaÿ and Sean T. McGovern},
+  title = {{vt-tv: A New C++ Application to Efficiently Visualize and Analyze Asynchronous Many-Task Work Distributions and Attendant Quantities of Interest}},
+  year = 2023,
+  type = {Sandia Report},
+  number = {SAND2023-09312},
+  month = aug,
+  address = {}
+}
+
+@inproceedings{lifflander2021optimizing,
+  title={Optimizing Distributed Load Balancing for Workloads with Time-Varying Imbalance},
+  author={Lifflander, Jonathan and Slattengren, Nicole Lemaster and P{\'e}ba{\"y}, Philippe P and Miller, Phil and Rizzi, Francesco and Bettencourt, Matthew T},
+  booktitle={2021 IEEE International Conference on Cluster Computing (CLUSTER)},
+  pages={238--249},
+  year={2021},
+  organization={IEEE},
+  address={https://www.osti.gov/servlets/purl/1870576},
+  doi = {https://doi.org/10.1109/Cluster48925.2021.00039}
+}
+
+@inproceedings{lifflander2020design,
+  title={Design and implementation techniques for an MPI-oriented AMT runtime},
+  author={Lifflander, Jonathan and Miller, Phil and Slattengren, Nicole Lemaster and Morales, Nicolas and Stickney, Paul and P{\'e}ba{\"y}, Philippe P},
+  booktitle={2020 Workshop on Exascale MPI (ExaMPI)},
+  pages={31--40},
+  year={2020},
+  organization={IEEE},
+  address={https://www.osti.gov/biblio/1825838}
+}
+
+@TechReport{lifflander:sand3967,
+  author = {J. Lifflander and P. P. Pébaÿ},
+  title = {{DARMA/vt FY20} Mid-Year Status Report},
+  year = 2020,
+  month = apr,
+  type = {Sandia Report},
+  number = {SAND2020-3967},
+  address = {https://www.osti.gov/servlets/purl/1615717},
+  doi = {https://doi.org/10.2172/1615717}
+}
+
+
+@TechReport{pebay:sand5139,
+  author = {P. P. Pébaÿ and J. Lifflander},
+  title = {Some Results About Distributed Load Balancing},
+  year = 2019,
+  month = may,
+  type = {Sandia Report},
+  number = {SAND2019-5139},
+  address = {https://www.osti.gov/servlets/purl/1762597},
+  doi = {https://doi.org/10.2172/1762597}
+}
+
+@TechReport{pebay:sand4269,
+  author = {P. P. Pébaÿ and J. Lifflander},
+  title = {Using {Sandia's Automatic Report Generator} to Document {EMPIRE}-based Electrostatic Simulations},
+  year = 2019,
+  month = apr,
+  type = {Sandia Report},
+  number = {SAND2019-4269},
+  address = {https://www.osti.gov/servlets/purl/1762099},
+  doi = {https://doi.org/10.2172/1762099}
+}
+
+@TechReport{lifflander:sand1134,
+  author = {J. Lifflander and M. Bettencourt and N. Slattengren and G. Templet and P. Miller and P. P. Pébaÿ and M. Perrinel and F. Rizzi},
+  title = {{DARMA-EMPIRE} Integration and Performance Assessment -- Interim Report},
+  year = 2019,
+  month = jan,
+  type = {Sandia Report},
+  number = {SAND2019-1134},
+  address = {https://www.osti.gov/servlets/purl/1493825},
+  doi = {https://doi.org/10.2172/1493825}
+}

VERSION

@@ -1 +1 @@
-1.4.0
+1.5.0