Examples

Example hps-mc jobs can be found in the examples directory of the repository.

To run an example, follow these steps:

# Setup the environment
. /my/local/install/bin/hps-mc-env.sh

# Change to example directory
cd hps-mc/examples/slic

# Run the example and store the log output to a file
./run.sh &> job.log

Examples will not work without modifying several local files.

First, you must specify where you have installed local external tools.

In each example directory is a file .hpsmc which contains configuration information that is specific to your local environment.

For instance, in the slic example, the following must be customized in the configuration file:

[SLIC]
slic_dir = /path/to/your/slic/install
hps_fieldmaps_dir = /path/to/hps-fieldmaps
detector_dir = /path/to/hps-java/detector-data/detectors

Additionally, you must specify StdHep input files that exist where you are running the job:

"input_files": {
    "/path/to/data/tritrig_1.stdhep": "tritrig.stdhep"
}

Examples will eventually be updated so that they run "out of the box" at SLAC or JLAB.