GrOptics and GrISU#
GrOptics traces photons through the telescope optics of
the GrISU simulation chain, and GrISUDet simulates the camera. obdeect stream to-grisu writes a
photon stream as the photon text that GrOptics reads, so the obdeect atmosphere and light
sources can feed that chain, in place of sim_telarray.
obdeect stream to-grisu writes ground-frame photons as GrISU photon text. The
atmosphere must be applied upstream and the wavelength assigned, for example by
obdeect propagation run:
$ zstd -dc run.corsika.zst | obdeect stream from-corsika \
| obdeect propagation run --transmission atm.dat --site-altitude 2156 --seed 1 \
--envelope qe=qe_envelope.dat -i - -o - \
| obdeect stream to-grisu --telescope-config TLLOC.dat > run.grisu
Output (one header block, then S and P lines):
* HEADF <-- Start of header flag
* Produced by obdeect stream to-grisu 0.1.0 from a photon stream written by obdeect stream from-corsika 0.1.0
* CORSIKA run number: 5
* Energy range [TeV]: 0.1 10
* Spectral slope: -2
* Primary id: 14
* Primary zenith [deg]: 20
* Primary azimuth [deg, CORSIKA]: 0
* Observation height [m]: 2200
* DATAF <-- end of header flag
R 1
H 2200
S 1 -50 -100 0 -0.34202014 25000 -1 -1 -1
P -20.5 -11.5 -0.5 +0 +20000 +12.5 400 3 7
Ris the global QE factor (--qe, default 1). It is written, not applied.S E_TeV x y dcos dsin h_first -1 -1 -1: one line per shower position (per array reuse), with core position [m] and primary direction cosines in the GrISU frame.h_firstis the event keyfirst_interaction_m[m a.s.l.].--event-detailsaddsC h_first X_first shower_id;X_firstis -1 (not carried by the stream) andshower_idis the event number.P x y dcx dcy zem t lambda 3 tel: one line per photon.x,y[m] are the telescope position plus the photon position;zemthe emission height [m];tthe arrival time [ns];lambdathe wavelength [nm, integer];3the emitter type (unknown);telthe GrISU telescope id (1-based).A bunch with weight above 1 is an error unless
--expand-buncheswritesround(w)copies. A weight below 1 is an error: thin the photons upstream.Numbers use 9 significant digits. Values below 1e-8 in magnitude are written as 0.
Frames: the CORSIKA ground frame (x north, y west) maps to GrISU by x_g = -y_c, y_g = -x_c.
Azimuths map by az_g = (3 pi / 2 - az_c) mod 2 pi, with az_c = atan2(cy, cx) for photons; the
written direction cosines are sin(ze) cos(az_g) and sin(ze) sin(az_g), with
sin(ze) = sqrt(cx^2 + cy^2). The primary uses the event zenith and azimuth the same way.
--telescope-config FILE reads * TLLOC id x y z offset px py lines (x east, y north [m]; other
lines are comments). A stream telescope gets the id of the closest line within 0.5 m of its
position (transformed as above). Other telescopes are skipped and reported on stderr. Without the
file, tel is the stream telescope id.
In Python: obdeect.stream.stream_to_grisu(run.pst, run.grisu, telescope_config="TLLOC.dat").