Pipelines#
Each obdeect command reads a photon stream and writes one, so you build a
simulation by piping commands together. obdeect stream to-simtel closes the pipe: it turns
a stream into sim_telarray input.
source ──▶ atmosphere ──▶ optics ──▶ to-simtel ──▶ sim_telarray
Which steps you need depends on the frame in which the source writes its photons:
Frame |
Written by |
Steps before |
|---|---|---|
sky |
CORSIKA ( |
atmosphere ( |
telescope (T) |
|
none |
camera (C) |
|
none |
obdeect stream to-simtel prints the sim_telarray option (Bypass_Optics) that each telescope
needs. Replace <config> below with your sim_telarray configuration.
Air showers through the full chain#
$ zstd -dc run.corsika.zst \
| obdeect stream from-corsika \
| obdeect propagation run --transmission atm.dat --site-altitude 2156 --seed 1 \
| obdeect ray-tracing trace-stream --model telescope.json --seed 7 \
--pointing-zenith-deg 20 --pointing-azimuth-deg 0 \
| obdeect stream to-simtel --camera-map cam.txt > sim.simtel
telescope.jsonis a compiled optical model.cam.txtis the camera map: it lists the telescopes whose photons are in the camera frame. See Command line.
Flasher on the dish#
$ obdeect sources flasher --type dish --photons 1e6 \
| obdeect propagation run --transmission atm.dat --site-altitude 2156 --seed 1 \
| obdeect ray-tracing trace-stream --model telescope.json --seed 7 \
| obdeect stream to-simtel --camera-map cam.txt > sim.simtel
With --frame camera, the flasher sends photons in a straight line to the camera plane
(no atmosphere, arrival time = emission time + path / c) and sim_telarray takes over from there:
$ obdeect sources flasher --type dish --frame camera --distance 1600 --photons 2.5e6 \
| obdeect stream to-simtel --camera-map cam.txt \
| sim_telarray -c <config> -C Bypass_Optics=3 -
Flasher at the camera corners (dual-mirror telescopes)#
The four flashers fire onto the secondary mirror. The photons are in the telescope frame, and
obdeect stream to-simtel needs a camera map that marks the telescope as dual-mirror
(details):
$ obdeect sources flasher --type secondary --fire all --delays 0,0,0,0 \
| obdeect stream to-simtel --camera-map cam.txt \
| sim_telarray -c <config> -C Bypass_Optics=1 -
LED in front of camera pixels#
The LED source needs the pixel positions and trigger groups, so it reads the sim_telarray
camera definition (--camera-file cam.dat). obdeect stream to-simtel does not read that
file. It needs only the camera map (--camera-map cam.txt), a three-column list of the
telescopes with camera-frame photons:
$ obdeect sources led --camera-file cam.dat --use-trg-all --photons 500 \
| obdeect stream to-simtel --camera-map cam.txt \
| sim_telarray -c <config> -C Bypass_Optics=3 -
Point source, beam, laser, night sky and muon#
These sources write sky-frame photons. If sim_telarray applies the extinction itself, run the
atmosphere step with --no-extinction, which moves the photons to the telescope and nothing
more:
$ obdeect sources point-source -z 10000000 -n 1e7 \
| obdeect propagation run --no-extinction --site-altitude 2150 --seed 1 \
| obdeect stream to-simtel \
| sim_telarray -c <config> -
The same pipeline works for beam-scan, laser-beam, night-sky and muon-track.