Set up a Workspace

To setup an experiment workspace you must first initialize the system you will be running on. Next, initialize the experiment you plan to run with the appropriate programming model. Finally, set up the workspace in a directory for your experiment.:

benchpark system init --dest=</output/path/to/system_def_dir> <SystemName> compiler=<Compiler>
benchpark experiment init --dest=</output/path/to/experiment_def_dir> <Benchmark> +/~<Boolean Variant> <String Variant>=<value> --system=</output/path/to/system_def_dir>
benchpark setup </output/path/to/experiment_def> </output/path/to/system_def> </output/path/to/workspace>

where:

• <Benchmark>: amg2023 | saxpy | etc. (specified choices in Benchmarks and Experiments)

• <System>: Cts | Tioga | etc. (specified systems in System Specifications)

This command will assemble a Ramble workspace per experiment with a configuration for the specified benchmark and system with the following directory structure:

experiments_root/
    ramble/
    spack/
    <Benchmark/ProgrammingModel>/
        <System>/
            workspace/
                configs/
                    (everything from system_def_dir)
                    (everything from experiment_def_dir>)

benchpark setup will output instructions to follow:

. <experiments_root>/setup.sh

The setup.sh script calls the Spack and Ramble setup scripts. It optionally accepts parameters to ramble workspace setup as documented in Ramble, including --dry-run and --phases make_experiments.

Now you are ready to compile your experiments as described in Build an Experiment.