calculate_trigger_rate

Calculates array or single-telescope trigger rates.

The applications reads from a simtel_array output file, a list of simtel_array output files ou from a file containing a list of simtel_array files.

Command line arguments

simtel_file_names (str or list):

Path to the simtel_array file or a list of simtel_array output files. Files can be generated in simulate_prod using the --save_file_lists option.

save_tables (bool):

If true, save the tables with the energy-dependent trigger rate to a ecsv file.

area_from_distribution (bool):

If true, the area thrown (the area in which the simulated events are distributed) in the trigger rate calculation is estimated based on the event distribution. The expected shape of the distribution of events as function of the core distance is triangular up to the maximum distance. The weighted mean radius of the triangular distribution is 2/3 times the upper edge. Therefore, when using the area_from_distribution flag, the mean distance times 3/2, returns just the position of the upper edge in the triangle distribution with little impact of the binning and little dependence on the scatter area defined in the simulation. This is special useful when calculating trigger rate for individual telescopes. If false, the area thrown is estimated based on the maximum distance as given in the simulation configuration.

Example

Calculate trigger rate from simtel_array file

simtools-calculate-trigger-rate --simtel_file_names tests/resources/ \\
run201_proton_za20deg_azm0deg_North_test_layout_test-prod.simtel.zst

Expected final print-out message:

System trigger rate (Hz): 9.0064e+03 pm 9.0087e+03 Hz