Skip to content

Conversation

@pkicsiny
Copy link

@pkicsiny pkicsiny commented Dec 8, 2025

Added installation documentation for S3DF cluster following the structure of the instructions for other clusters.
https://github.com/pkicsiny/WarpX/tree/s3df_docs/Docs/source/install/hpc/s3df.rst

Added files:

  • Tools/machines/s3df-slac/s3df_gpu_warpx.profile.example
  • Tools/machines/s3df-slac/install_gpu_dependencies.sh
  • Tools/machines/s3df-slac/s3df_cpu_warpx.profile.example
  • Tools/machines/s3df-slac/install_cpu_dependencies.sh
  • Tools/machines/s3df-slac/s3df_cpu.sbatch
  • Tools/machines/s3df-slac/s3df_gpu.sbatch

Document the setup and usage of the S3DF cluster for WarpX.
Removed instructions for building WarpX with FFTW support.
Clarify instructions for toggling options in CMakeLists.txt.
Updated installation instructions for WarpX to include additional packages and installation steps.
Updated references and commands for building and running WarpX.
Updated the job submission command to request 2 nodes instead of 1 and added instructions for running WarpX after resource allocation.
Emphasize the need for MPI to be loaded before installing or running WarpX.
Clarified MPI loading instructions and updated job submission command details.
Updated interactive job command and bash script example for clarity.
Updated the explanation of account usage and resource allocation for S3DF. Added example command for running WarpX after resource allocation.
Peter Kicsiny and others added 26 commits November 19, 2025 14:39
Removed note about Perlmutter GPU project naming convention.
Updated installation instructions for S3DF to recommend installing WarpX in the project directory and added details about project and user name placeholders.
Updated installation instructions for WarpX to include Python module installation steps.
Removed redundant CMake options section for CPU nodes to streamline documentation.
Updated instructions for running jobs on the iana pool, including interactive and script-based methods. Clarified resource allocation and provided example submission script.
Updated instructions for setting the WORK variable in .bashrc for easier access to project directories.
Updated command for running an interactive job to request 1 node instead of 2.
Updated environment variables and module loads in the profile example. Removed commented-out lines and adjusted paths for clarity.
Updated environment variables and module loading for GPU setup.
@aeriforme aeriforme self-requested a review December 8, 2025 23:18
@aeriforme aeriforme self-assigned this Dec 8, 2025
@aeriforme aeriforme added component: documentation Docs, readme and manual machine / system Machine or system-specific issue labels Dec 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component: documentation Docs, readme and manual machine / system Machine or system-specific issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants