simtools-validate-telescope-throughput#

Calculate total on-axis telescope throughput, including optics and shadowing.

Calculates overall telescope throughput from camera and optical efficiencies, including telescope shadowing, and derives the reference night-sky-background pixel rate. Plots show throughput for Cherenkov (left) and night-sky-background light (right) as a function of wavelength.

../../_images/validate_telescope_throughput_North-MST-NectarCam-D_cherenkov.png

../../_images/validate_telescope_throughput_North-MST-NectarCam-D_nsb.png

Command line arguments

site (str, required): North or South.
telescope (str, required): Telescope model name (e.g. LSTN-01, SSTS-15)
model_version (str, optional): Simulation model version
zenith_angle (float, optional): Zenith angle in degrees (between 0 and 180).
azimuth_angle (float, optional): Telescope pointing direction in azimuth.
nsb_spectrum (str, optional): File with NSB spectrum to use for the efficiency simulation.

Example

MSTN-01 5.0.0

Runtime < 1 min.

simtools-validate-telescope-throughput --site North \\
    --azimuth_angle 0 --zenith_angle 20 \\
    --nsb_spectrum average_nsb_spectrum_CTAO-N_ze20_az0.txt \\
    --telescope MSTN-01 --model_version 5.0.0

The output is saved in simtools-output/validate_telescope_throughput.

Command line arguments#

options#

–help: show this help message and exit
–nsb_spectrum: File with NSB spectrum for the efficiency simulation. Expected format: two columns with wavelength in nm and NSB flux in [1e9 * ph/m2/s/sr/nm]. If more than two columns are present, the first and third are used and the second is ignored (native sim_telarray behavior).
–skip_correction_to_nsb_spectrum: Skip correction to the NSB spectrum for the altitude difference between the reference B&E spectrum and the observation level at the CTAO sites.
–write_reference_nsb_rate_as_parameter: Write the NSB pixel rate obtained for reference conditions as a model parameter

simulation model#

–model_version

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

–parameter_version

model parameter version

–overwrite_model_parameters

JSON string with model parameters to overwrite

–site

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

Required.

–telescope

telescope model name (e.g., LSTN-01, SSTS-design, …)

Required.

simulation configuration#

–zenith_angle

Zenith angle in degrees (between 0 and 180).

Default: 20.0 deg.

–azimuth_angle

Telescope pointing direction in azimuth. It can be in degrees between 0 and 360 or one of north, south, east or west. North is 0 degrees and the azimuth grows clockwise (East is 90 degrees).

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.

Examples#

Validate the LSTN-02 telescope throughput#

Calculate LSTN-02 optical throughput and derive its reference night-sky-background rate.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_lstn-02.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_lstn-02.yml

Configuration

log_level: info
model_version: 7.0.0
nsb_spectrum: ${prepared:nsb_reference_spectrum-1.0.0-OBS-North.ecsv}
output_path: simtools-output
site: North
telescope: LSTN-02
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 0.0

Validate the LSTN-02 telescope throughput#

Calculate the LSTN-02 optical throughput and reference NSB rate after applying model-parameter overrides.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_lstn-02_overwrite.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_lstn-02_overwrite.yml

Configuration

log_level: debug
model_version: 6.0.2
output_path: simtools-output
site: North
telescope: LSTN-02
overwrite_model_parameters: tests/resources/static/info_test_camera_efficiency_change_LSTN-02.yml
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 0.0

Validate the LSTS-02 camera efficiency#

Calculate LSTS-02 optical throughput and derive its reference night-sky-background rate.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_lsts-02.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_lsts-02.yml

Configuration

log_level: info
model_version: 7.0.0
output_path: simtools-output
site: South
telescope: LSTS-02
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 0.0

Validate the MSTx-FlashCam camera efficiency#

Calculate South FlashCam optical throughput and reference NSB rate using the configured sky spectrum.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_mstx_flashcam_south.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_mstx_flashcam_south.yml

Configuration

figure_format:
- pdf
- png
log_level: debug
model_version: 7.0.0
nsb_spectrum: ${prepared:nsb_reference_spectrum-1.0.0-OBS-South.ecsv}
output_path: simtools-output
site: South
telescope: MSTx-FlashCam
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 0.0

Validate the MSTx-NectarCam camera efficiency#

Calculate North NectarCam optical throughput and derive its reference night-sky-background rate.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_mstx_nectarcam_north.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_mstx_nectarcam_north.yml

Configuration

figure_format:
- pdf
- png
log_level: debug
model_version: 7.0.0
nsb_spectrum: ${prepared:nsb_reference_spectrum-1.0.0-OBS-North.ecsv}
output_path: simtools-output
site: North
telescope: MSTx-NectarCam
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 0.0

Validate the SSTS-design camera efficiency#

Calculate South SST camera optical throughput and reference NSB rate at 20 deg zenith angle.

Application: simtools-validate-telescope-throughput

Integration test: validate_telescope_throughput_ssts.yml

Command

simtools-validate-telescope-throughput --config tests/integration_tests/config/validate_telescope_throughput_ssts.yml

Configuration

figure_format:
- pdf
- png
log_level: debug
model_version: 7.0.0
output_path: simtools-output
site: South
telescope: SSTS-design
parameter_version: 0.0.99
write_reference_nsb_rate_as_parameter: true
zenith_angle: 20.0