Track source#

Header obdeect/sources/track.hpp. A line segment emitting Cherenkov light at a fixed angle to its direction of motion; only photons that reach a sphere are generated (importance sampling).

Track{start (upper end), direction (unit), length_m, cos_theta (= 1/(n beta)), beta, time_ns (emission time at start), spectrum, photons (mean emitted into 4 pi), target SphereTarget}.

Validation (validate(track))#

photons finite, 0..2^53; start within limits, direction finite and unit to 1e-9; 0 <= length within limits; 0 < cos_theta <= 1; 0 <= beta <= 1; time_ns within limits; sphere centre within limits and radius positive-within-limits; spectrum is Fixed (positive-within-limits) or InverseSquare (0 < low < high, within limits), nothing else.

Hit arc#

For emission point P = start + direction s: D = |centre - P|; if D <= R every azimuth hits (hit, centre 0, half pi). Else cos_alpha = sqrt(1 - (R/D)^2), unit = (centre - P)/D, cos_b = dot(direction, unit), perp = unit - direction cos_b, sin_b = |perp|, phi0 = atan2(dot(perp, e2), dot(perp, e1)) with (e1,e2) = orthonormal_basis(direction), a = cos_alpha - cos_theta cos_b, b = sin_theta sin_b. If b <= 0: all azimuths if a < 0, none otherwise. Else x = a/b: none if x >= 1; all if x <= -1; else centre = phi0, half = acos(x). Photons with azimuth within phi0 +- half hit; fraction half/pi. The result agrees with a brute-force azimuth scan to 2e-5.

Emission (emit_track(track, seed, event, telescope, out))#

Validates; n = track_count (rounding rule with mean photons). For photon k = 0..n-1 (all draws keyed by k): s = length * target_u0; compute the arc; if no hit, skip (no row, index k is consumed). Else phi = centre + half (2 direction_u0 - 1); position start + direction s; direction direction cos_theta + (e1 cos phi + e2 sin phi) sin_theta; time time_ns + s / (beta c) if beta > 0 else time_ns; weight half/pi; wavelength from the spectrum (wavelength stream). The emission angle to the axis is acos(cos_theta) to 1e-12.

expected_track_weight(track, steps = 20000) = photons * mean over midpoints of half/pi (0 for zero length or zero photons) (midpoint rule over s).