simtools-simulate-flasher#

Simulate flasher devices used e.g. for camera flat fielding.

The flasher simulation allows for two different run modes:

  1. Direct injection of light into the camera (bypassing the telescope optics).

  2. Simulation of the full light path (using the light-emission package from sim_telarray).

The direct injection mode uses a simplified model for the flasher light source. Both run modes provide events in sim_telarray format that can be processed by standard analysis steps or visualized using e.g. the ‘simtools-plot-simtel-events’ application.

Example Usage#

  1. Simulate flashers for a telescope (direct injection):

    simtools-simulate-flasher --run_mode direct_injection \
--light_source MSFx-FlashCam --model_version 6.0.0 \
--array_layout_name subsystem_msts --site South \
--run_number 3

  2. Simulate flashers for a telescope (detailed simulation):

    simtools-simulate-flasher --run_mode full_simulation \
--light_source MSFx-NectarCam --model_version 6.0 \
--telescope MSTS-04 --site South --run_number 1 \
--array_layout_name 1mst

Command Line Arguments#

run_mode (str, required)

Run mode, either “direct_injection” or “full_simulation”.

telescope (str, required)

Telescope model name (e.g. LSTN-01, MSTN-04, SSTS-04, …)

site (str, required)

Site name (North or South).

light_source (str, required)

Calibration light source, e.g., MSFx-FlashCam

number_of_events (int, optional):

Number of events to simulate (default: 1).

output_prefix (str, optional):

Prefix for output files (default: empty).

model_version (str, optional)

Version of the simulation model.

array_layout_name (str, optional)

Name of the array layout to use (required for direct injection mode).

run_number (int, optional)

Run number to use (default: 1, required for direct injection mode).

telescope (str, optional)

Telescope name (required for full simulation mode).

simulate_flasher.main()[source]#

Simulate flasher devices.