simtools-simulate-illuminator#

Simulate illuminator (distant calibration light source).

Illuminators are calibration light sources not attached to a particular telescope. Two types of illuminators are supported:

  1. Illuminator as foreseen at CTAO with fixed positions as defined in the simulation models database.

  2. Illuminator at a configurable position relative to the array center. Note that in this case the telescope pointing is fixed towards zenith.

Example Usage#

  1. Simulate illuminator with positions as defined in the simulation models database:

    simtools-simulate-illuminator --light_source ILLN-01 \
--telescope MSTN-04 --site North \
--model_version 6.0.0

  2. Simulate at a configurable position (1km above array center) and pointing downwards:

    simtools-simulate-illuminator --light_source ILLN-01 \
--light_source_position 0. 0. 1000. \
--light_source_pointing 0. 0. -1. \
--telescope MSTN-15 --site North \
--model_version 6.0.0

Command Line Arguments#

light_source (str, optional)

Illuminator in array, e.g., ILLN-01.

number_of_events (int, optional)

Number of events to simulate.

telescope (str, required)

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

site (str, required)

Site name (North or South).

model_version (str, optional)

Version of the simulation model.

light_source_position (float, float, float, optional)

Light source position (x,y,z) relative to the array center (ground coordinates) in m. If not set, the position from the simulation model is used.

light_source_pointing (float, float, float, optional)

Light source pointing direction. If not set, the pointing from the simulation model is used.

output_prefix (str, optional)

Prefix for output files (default: empty).

simulate_illuminator.main()[source]#

Simulate light emission from illuminator.