simtools-derive-ctao-array-layouts

Derive CTAO array layouts definitions using CTAO common identifiers repository.

Retrieves the CTAO array layouts definitions from the CTAO common identifiers repository and synchronizes them with the model parameter definition in ‘array_layouts’ for all CTAO sites.

Requires access to the CTAO common identifiers repository. Future versions of the common identifiers might be stored in a CTAO technical repository.

Command line arguments

site (str)

CTAO site (North or South).

parameter_version (str)

Model parameter version.

repository_url (str)

URL or path of the CTAO common identifiers repository.

repository_branch (str)

Repository branch to use for CTAO common identifiers.

updated_parameter_version (str)

Updated parameter version.

Example

Derive the CTAO array layouts definitions for the North site using the CTAO common identifiers repository. Merge the retrieved array layouts with the model parameter definition in ‘array_layouts’ (in this example for site North and parameter version 2.0.0). Write the updated array layouts and metadata using the parameter version indicated by the ‘updated_parameter_version’ argument.

simtools-derive-ctao-array-layouts --site North \
    --repository_url "https://gitlab.cta-observatory.org/" \
    "cta-computing/common/identifiers/-/raw/" \
    --repository_branch main \
    --site North --parameter_version 2.0.0 \
    --updated_parameter_version 3.0.0

Command line arguments

options

–help

show this help message and exit

–repository_url

URL or path of the CTAO common identifiers repository.

Default: https://gitlab.cta-observatory.org/cta-computing/common/identifiers/-/raw/.

–repository_branch

Repository branch to use for CTAO common identifiers.

Default: main.

simulation model

–model_version

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

–parameter_version

model parameter version

–updated_parameter_version

updated parameter version

–site

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

output

–output_file

Output data file.

–output_file_format

file format of output data

Default: ecsv.

–skip_output_validation

skip output data validation against schema

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

Derive North array layouts from the repository

Generate North-site array-layout parameters from the official layout repository with updated parameter versions.

Application: simtools-derive-ctao-array-layouts

Integration test: derive_ctao_array_layouts.yml

Command

simtools-derive-ctao-array-layouts --config tests/integration_tests/config/derive_ctao_array_layouts.yml

Configuration

output_path: simtools-output
parameter_version: 2.0.0
repository_branch: main
site: North
updated_parameter_version: 1.0.99