Sky-level layer#
Header obdeect/sources/sky_sources.hpp. Shared by point-source, beam-scan, laser-beam, night-sky.
Helpers#
rotate_y(v, a) = (x cos a + z sin a, y, z cos a - x sin a);rotate_z(v, a) = (x cos a - y sin a, x sin a + y cos a, z).direction_from_altitude(alt, az) = (cos alt cos az, cos alt sin az, sin alt)(rad).fiducial_super_radius(telescopes) = max over telescopes of (|centre| + radius), 0 for none.spectrum_rangeas in the stream-writer page.shared_telescope_key = 0: every sky emission is generated once with telescope key 0; the same photons are written for every telescope (telescopes only select them).
Types#
SkyTelescope{id=1, centre, radius_m}.SkyRun{run_number=1 (i64), observation_level_m=2150, atmosphere_id=-1 (i64), wavelength_min_nm=0, wavelength_max_nm=0, telescopes, extra (Metadata)}.SourceEmission{source, seed, bunch=1, time_offset_ns=0}:count(event) = photon_count(source, seed, event, 0);fill(event, first, rows, chunk)=emit(..., telescope 0, ...)then for each roww = float(w) * float(bunch)andt = float(t) + float(time_offset_ns)(float32 arithmetic).SkyPlan<Emission>{run, events_per_case=1, cases};write_plan(out, producer, plan)writes the stream with events numbered 1, 2, … continuing across cases: each case is writtenevents_per_casetimes.
Stream layout#
run keys: run_number i64, observation_level_m f64, atmosphere_id i64,
refraction_applied i64 = 0, curvature_applied i64 = 0, n_telescopes i64,
telescope_x_m/y_m/z_m/r_m
vector<double>; wavelength_min_nm and wavelength_max_nm f64 only if
wavelength_max_nm > 0; then all extra entries inserted without overwriting existing keys
(extra may add doubles and strings).
Per event (number n): event {event_number i64 = n}. Counts of all emissions of the case
are computed once (count(n)); then for each telescope in run order: telescope record
(telescope_id, frame = 0, x_m, y_m, z_m, r_m), for each emission in order its rows
in chunks of at most 65536 (first_index = rows of earlier emissions + offset in the emission),
telescope_end {telescope_id, photons = sum of float32 w of the block}; event_end {}.
The telescope id of a chunk is the telescope’s id.
An error inside count or fill (source validation) occurs after the header was written;
partial output is allowed in that case. Errors raised while building the plan write nothing.