simtools-simulate-calibration-events

Simulate calibration events like pedestal or flasher events.

Use sim_telarray to simulate calibration events for an array of telescopes. The following types of calibration events are supported:

• Pedestal events (includes night-sky background and camera noise)

• Dark pedestal events (closed camera lid, camera noise only)

• Flasher events (simulated flasher light source)

Example

Simulate pedestal events for alpha North. The assumed level night-sky background is 2.0 times the nominal value. A list of stars can be provided to simulate additional contributions.

simtools-simulate-calibration-events --run_mode=pedestals \\
    --run_number 10 --number_of_events 1000 \\
    --array_layout_name alpha --site North \\
    --model_version 6.0.0 \\
    --zenith_angle 20 --azimuth_angle 0 \\
    --nsb_scaling_factor 2.0

Simulate flasher events for alpha South. Note that the same flasher configuration is used for all telescopes.

simtools-simulate-calibration-events --run_mode=flasher \\
    --run_number 10 --number_of_events 1000 \\
    --array_layout_name subsystem_msts --site South \\
    --model_version 6.0.0 \\
    --zenith_angle 20 --azimuth_angle 0 \\
    --flasher_photons 500 --flasher_var_photons 0.05 \\
    --flasher_exp_time 1.59 --flasher_sig_time 0.4

Command Line Arguments

run_mode (str, required)

Run mode, e.g. “pedestals” or “flasher”.

run_number (int, required)

Run number for the simulation.

number_of_events (int, required)

Number of calibration events to simulate.

array_layout_name (str, required)

Array layout name, e.g. “alpha”.

site (str, required)

Site name.

model_version (str, optional)

Version of the simulation model.

nsb_scaling_factor (float, optional)

Scaling factor for the night-sky background rate. Default is 1.0, which corresponds to the nominal (dark sky) NSB rate.

stars (str, optional)

Path to a file containing a list of stars (azimuth, zenith, weighting factor separated by whitespace). If provided, the stars will be used to simulate additional contributions to the night-sky background. For details on the parameters, see the sim_telarray manual.

zenith_angle (float, optional)

Zenith angle in degrees.

azimuth_angle (float, optional)

Azimuth angle in degrees.

flasher_photons (float, optional)

Number of photons in the flasher pulse at each photodetector.

flasher_var_photons (float, optional)

Relative variance of the number of photons in the flasher pulse.

flasher_exp_time (float, optional)

Exponential decay time of the flasher pulse in nano-seconds.

flasher_sig_time (float, optional)

Sigma of Gaussian-shaped flasher pulse in nano-seconds.