submit simulation examples

This page is generated from docs/submit-simulation/examples.md. Do not edit it directly; change the repository source and let automation publish the Wiki.

Submission examples

Run these commands with run.csh on ifarm. Preview is the default and should be the first action for every sample.

Preview a completed run

source run.csh \
    --workflow submit \
    --lund-dir /path/to/run/lundfiles

Submit the first five files

source run.csh \
    --workflow submit \
    --lund-dir /path/to/run/lundfiles \
    --num-jobs 5 \
    --execute

Execution replaces this run's mchipo/ and reconhipo/, but preserves lundfiles/.

Override detector inputs

source run.csh \
    --workflow submit \
    --lund-dir /path/to/run/lundfiles \
    --gemc-version 5.14 \
    --coatjava-version 10.0.7 \
    --gemc-target-variation rgm_fall2021_Ar \
    --gcard config/detector/GEMC_GCARDs_6GeV/5.14/rgm_fall2021_Ar_6GeV.gcard \
    --yaml config/detector/COATJAVA_YAML_configs_6GeV/10.0.7/rgm_fall2021-ai_6Gev.yaml \
    --torus -1.0

The rgm_fall2021_Ar_6GeV.gcard controls GEMC detector simulation. The rgm_fall2021-ai_6Gev.yaml controls COATJAVA reconstruction.

Preview two independent arrays

source run.csh \
    --workflow submit \
    --lund-dir /path/to/run-a/lundfiles \
    --lund-dir /path/to/run-b/lundfiles \
    --num-jobs 2

Test a custom clas12Tags checkout

source run.csh \
    --workflow submit \
    --lund-dir /path/to/run/lundfiles \
    --clas12tags-dir /path/to/clas12Tags

Use this only for a reviewed detector-development study. It changes the GEMC data directory passed to Slurm.

The submission all-options tutorial demonstrates every public option, including manual metadata and farm-log cleanup. The production command lists pair the uniform and physical creation examples with their corresponding submissions.