Quick start#

Three steps: create photons, look at them, move them through the atmosphere. Install obdeect first (Installation).

1. Create photons#

A point light source 10 km above the telescope, 50 events:

$ obdeect sources point-source -N 50 -o point-source.pst

The result is a photon stream: a binary file of runs, events, telescopes and photons. The extension .pst is only a convention. Every obdeect command also reads and writes streams on standard input and output, so commands combine with pipes.

2. Look inside#

$ obdeect stream cat --summary point-source.pst

The summary lists the records per type and the photons and weight per telescope.

3. Propagate through the atmosphere#

obdeect propagation run moves the photons to the telescope and applies timing and extinction. It needs an atmospheric transmission table for the observation level (2150 m, the default of point-source):

$ obdeect propagation run --transmission atm_trans.dat --site-altitude 2150 --seed 1 \
    -i point-source.pst -o ground.pst

Next#

  • Pipelines: combine components, and feed sim_telarray.

  • Light sources: what you can simulate besides a point source.

  • Ray tracing: trace the photons through a telescope.