simtools-plot-production-grid#

Plot production-grid points on sky coordinate projections.

Overview#

This application reads an ECSV production grid, produced by simtools-production-generate-grid, and creates plots of the grid pointings and production limits.

Horizontal grids use azimuth_angle and zenith_angle. HA/Dec grids use ha and dec. If both coordinate systems are present, both panels are shown.

Input and output#

Role

Argument or filename

Format

Description

Input

--grid_points_file

ECSV

Production-grid table.

Output

production_grid_sky_projection.png

PNG

Sky coverage in local Alt/Az, with an HA/Dec panel when available.

Output

production_grid_altaz_<value>.png

PNG

Alt/Az points colored by each supported value column.

Output

showers_vs_zenith_*.png

PNG

Total showers per pointing versus zenith, for a selected azimuth interval and all azimuths.

Output

showers_per_run_vs_zenith_single_row.png

PNG

Showers per run versus zenith, colored by azimuth.

The shower-statistics plots are made when the grid contains Alt/Az coordinates and a showers_per_run column. Use azimuth_center and azimuth_width to choose the interval for the selected-azimuth plot; their defaults are 180 degrees and 1 degree.

The input follows the job grid schema.

Command line arguments#

options#

–help

show this help message and exit

–grid_points_file

Path to the ECSV file containing grid points.

Required.

–azimuth_center

Azimuth-bin center in degrees for the selected shower-statistics plot.

Default: 180.0.

–azimuth_width

Azimuth-bin width in degrees for the selected shower-statistics plot.

Default: 1.0.

application#

–show_options

Print available values for a supported option and exit.

Example#

Plot an observing-coordinate production grid#

Visualize simulated pointings and their energy, view-cone, and core-scatter limits across zenith and azimuth.

Application: simtools-plot-production-grid

Integration test: plot_production_grid.yml

Command

simtools-plot-production-grid --config tests/integration_tests/config/plot_production_grid.yml

Configuration

grid_points_file: tests/resources/generated/production_grid_points_horizontal.ecsv
output_path: simtools-output