simtools-generate-regular-arrays#
Make a regular array of telescopes and save it to file.
Arrays can consist of single (central) telescopes, square grids or star-like (with telescopes arranged on main axes) patterns. All telescopes in the array are of the same type and are placed at regular distances.
Output files are saved as astropy tables in ASCII ECSV format and in the simtools format required to be used for the overwrite model parameter configuration.
Command line arguments
- telescope_type (str)
Type of telescope (e.g., LST, MST, SST).
- number_of_telescopes (int)
Number of telescopes in the array.
- telescope_distance (float)
Distance between telescopes in the array (in meters).
- array_shape (str)
Shape of the array (‘square’, ‘star’).
- site (str, required)
observatory site (e.g., North or South).
- model_version (str, optional)
Model version to use (e.g., 6.0.0). If not provided, the latest version is used.
Example
Runtime < 10 s.
simtools-generate-regular-arrays --site=North
Command line arguments#
options#
- –help
show this help message and exit
- –telescope_type
Type of telescope (e.g., LST, MST, SST).
Default: LST.
- –number_of_telescopes
Number of telescopes in the array.
Default: 4.
- –telescope_distance
Distance between telescopes in the array (in meters).
Default: 50.0.
- –array_shape
Shape of the array (e.g., ‘square’, ‘star’).
Default: square. Choices: square, star.
simulation model#
- –model_version
Simulation production model version(s). Use –show_options model_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
application#
- –show_options
Print available values for a supported option and exit.
Examples#
Generate a 40-MST star array#
Place 40 medium-sized telescopes in a regular star pattern for a North-site simulation layout.
Application: simtools-generate-regular-arrays
Integration test: generate_regular_arrays_run_north_40mst_star.yml
Command
simtools-generate-regular-arrays --config tests/integration_tests/config/generate_regular_arrays_run_north_40mst_star.yml
Configuration
model_version: 6.0.2
telescope_type: MST
number_of_telescopes: 40
telescope_distance: 50.0
array_shape: star
output_file: generate_regular_arrays_North_40MST.ecsv
output_path: simtools-output
site: North
Generate a single-SST array#
Create a South-site simulation layout containing one small-sized telescope.
Application: simtools-generate-regular-arrays
Integration test: generate_regular_arrays_run_south_1sst.yml
Command
simtools-generate-regular-arrays --config tests/integration_tests/config/generate_regular_arrays_run_south_1sst.yml
Configuration
model_version: 6.0.2
telescope_type: SST
number_of_telescopes: 1
telescope_distance: 50.0
output_file: generate_regular_arrays.ecsv
output_path: simtools-output
site: South
Generate a four-LST square array#
Place four large-sized telescopes in a regular square pattern for a South-site simulation layout.
Application: simtools-generate-regular-arrays
Integration test: generate_regular_arrays_run_south_4lst_square.yml
Command
simtools-generate-regular-arrays --config tests/integration_tests/config/generate_regular_arrays_run_south_4lst_square.yml
Configuration
model_version: 6.0.2
telescope_type: LST
number_of_telescopes: 4
telescope_distance: 50.0
output_file: generate_regular_arrays.ecsv
output_path: simtools-output
site: South