Building XGC

Please open a Github issue if you encounter any bugs or other problems. Thanks! Before getting started, please make sure you have CMake v3.16 or newer installed.

Contents

• Build Instructions
  • Environment at HPC facilities
    • Aurora
    • Frontier
    • Greene
    • Perlmutter (GPU)
    • Perlmutter (CPU)
    • Polaris
    • Stellar
    • Traverse
  • Build instructions for XGC-S
    • Stellar
    • Perlmutter
• 3rd Party Software Installations
• Maintaining shared installations
• Installation instructions
  • PETSc
  • ADIOS2
  • FFTW
  • Kokkos
  • Cabana
  • GTest
  • Ginkgo
• Adding a new source file
• Adding support for another HPC facility
• Adding a new configuration option
• Updating Test Data
  • Generate new test data
    • Make whatever changes are necessary to the testing data.
    • Create a tarball of the new version of the test data
  • Upload new version to data.kitware.com
    • Register an account on data.kitware.com if you don’t already have one.
    • Navigate to your public folder
    • Upload the newly created tarball to your public directory
  • Update the version of the test data used in XGC
    • Get the checksum of this new version
    • Record the new checksum in XGC
    • Commit, push, and make a PR for this change