simtools-generate-array-config

Generate sim_telarray configuration files for a given array.

The applications generates the sim_telarray configuration files for a given array, site, and model_version using the model parameters stored in the simulation-model repository.

Command line arguments

sitestr

Site name (e.g., North, South).

array_layout_namestr

Name of the layout array (e.g., test_layout, alpha, 4mst, etc.).

array_element_listlist

List of array elements (e.g., telescopes) to plot (e.g., LSTN-01 LSTN-02 MSTN).

Example

North - 5.0.0:

simtools-generate-array-config --site North --array_layout_name alpha --model_version 5.0.0

The output is saved in simtools-output/test/model.

Command line arguments

options

–help

show this help message and exit

simulation model

–model_version

Simulation production model version(s). Use –show_options model_version.

–overwrite_model_parameters

JSON string with model parameters to overwrite

–site

Observatory site (e.g., North, South). Use –show_options site.

–array_layout_name

Array layout name(s) (e.g., CTAO-North-Alpha, LSTN-01). Telescope names are assumed as single-telescope layouts. Use –show_options array_layout_name.

–array_element_list

list of array elements (e.g., LSTN-01, LSTN-02, MSTN).

model repository

–simulation_models_path

Path containing the simulation-model repository to read.

–simulation_models_git_path

Path to a local normal, bare, or mirror Git repository containing simulation models.

–simulation_models_git_revision

Git tag, ref, or commit to read from the simulation-model repository.

application

–show_options

Print available values for a supported option and exit.

Example

Generate a North Alpha array configuration

Resolve the version-appropriate North Alpha layout and write its sim_telarray array configuration.

Application: simtools-generate-array-config

Integration test: generate_array_config_run.yml

Command

simtools-generate-array-config --config tests/integration_tests/config/generate_array_config_run.yml

Configuration

array_layout_name:
  by_version:
    <7.0.0: alpha
    '>=7.0.0': CTAO-North-Alpha
model_version: 6.0.2
output_path: simtools-output
site: North