CLI Documentation

panama

Command line interface for PANAMA, providing useful CORSIKA utilities.

For examples see the PANAMA repository:

https://github.com/The-Ludwig/PANAMA#readme

panama [OPTIONS] COMMAND [ARGS]...

Options

-d, --debug

Enable debug output

hdf5

Convert CORSIKA7 DAT files to hdf5 files.

INPUT: One or more CORSIKA7 datfiles OUTPUT: The filename of the hdf5 output file

For examples see the PANAMA repository:

https://github.com/The-Ludwig/PANAMA#readme

panama hdf5 [OPTIONS] [INPUT]... OUTPUT

Options

-n, --noadd

Don’t parse Corsika information into additional collumns like e.g. pdgid.

-m, --mother

Parse mother information into additional collumns if they are provided with the EHIST option of CORSIKA

-dm, --dropMother

Drop mother particles that don’t reach observation level. (EHIST)

-dp, --dropNonParticles

Drop all rows which don’t really represent a particle. (Like decay or additional information)

Arguments

INPUT

Optional argument(s)

OUTPUT

Required argument

run

Run CORSIKA7 in parallel.

The TEMPLATE argument must point to a valid CORSIKA7 stiring card, where {run_idx}, {first_event_idx} {n_show} {seed_1} {seed_2} and {dir} will be replaced accordingly.

For examples see the PANAMA repository:

https://github.com/The-Ludwig/PANAMA#readme

panama run [OPTIONS] TEMPLATE

Options

-n, --events <events>

Number of shower-events to generate per primary particle.

-p, --primary <primary>

PDGid of primary to inject. Default is proton. Can be a python dict with diffrerent primaries as keys and values the number of events to generate for that. In this case, –events is ignored. Example with proton and iron: {2212: 100_000, 1000260560: 1000}

-o, --output <output>

Path to store the CORSIKA7 DAT files

-j, --jobs <jobs>

Number of jobs to use

-c, --corsika <corsika>

Path to the CORSIKA7 executable. Can also be set using the CORSIKA_PATH environment variable.

-s, --seed <seed>

Seed to use. If none, will use system time or other entropic source

-t, --tmp <tmp>

Path to the default temp folder to copy corsika to. Can also be set using the TMP_DIR environment variable.

-d, --debug

Enable debug output

Arguments

TEMPLATE

Required argument