simtools-maintain-simulation-model-write-array-element-positions#

Read array element positions from file and write model parameter files for each element.

This is an application for experts and should not be used by the general user. Reading of input is fine-tuned to the array element files as provided by CTAO.

Writes one model parameter file per array element into a directory structure compatible with the simtools model parameter repository.

Command line arguments

array_element_positions_filestr: File containing a table of array element positions.
output_pathPath: Directory for generated model parameter files.
parameter_versionstr: Parameter version.
coordinate_systemstr: Coordinate system of array element positions (ground or utm).

Examples

Add array element positions to repository (ground coordinates):

simtools-maintain-simulation-model-write-array-element-positions             --array_element_positions_file tests/resources/telescope_positions-North-ground.ecsv             --output_path /path/to/repository             --parameter_version 0.1.0             --coordinate_system ground

Add array element positions to repository (utm coordinates):

simtools-maintain-simulation-model-write-array-element-positions             --array_element_positions_file tests/resources/telescope_positions-North-utm.ecsv             --output_path /path/to/repository             --parameter_version 0.1.0             --coordinate_system utm

Command line arguments#

options#

–help

show this help message and exit

–array_element_positions_file

File containing a table of array element positions.

Required.

–coordinate_system

Coordinate system of array element positions (utm or ground).

Default: ground. Choices: ground, utm.

simulation model#

–parameter_version: model parameter version

application#

–show_options: Print available values for a supported option and exit.

Examples#

Write ground array-element positions to a model repository#

Convert a North-site ground position table into versioned array-element model-parameter files.

Application: simtools-maintain-simulation-model-write-array-element-positions

Integration test: maintain_simulation_model_write_array_element_positions_ground.yml

Command

simtools-maintain-simulation-model-write-array-element-positions --config tests/integration_tests/config/maintain_simulation_model_write_array_element_positions_ground.yml

Configuration

array_element_positions_file: ${static:telescope_positions-North-ground.ecsv}
coordinate_system: ground
output_path: simtools-output
parameter_version: 0.1.0

Write UTM array-element positions to a model repository#

Convert a North-site UTM position table into versioned array-element model-parameter files.

Application: simtools-maintain-simulation-model-write-array-element-positions

Integration test: maintain_simulation_model_write_array_element_positions_utm.yml

Command

simtools-maintain-simulation-model-write-array-element-positions --config tests/integration_tests/config/maintain_simulation_model_write_array_element_positions_utm.yml

Configuration

array_element_positions_file: ${static:telescope_positions-North-utm.ecsv}
coordinate_system: utm
output_path: simtools-output
parameter_version: 0.1.0