muon-track: specification#
Options and examples: muon-track. Source: track.
Writer C, producer obdeect sources muon-track. Namespace obdeect::sources::muon_track.
Option parsing#
Aliases and values are in the program options. An option without a value:
option <arg> needs a value. Unknown option:unknown option <arg>.parse_command_line(args)returns{options, output, help}and throwsinvalid_argument.Errors on stderr as
obdeect sources muon-track: <message>plus usage, exit 1.
Parameter rules#
Theta:
0 <= theta < 90deg. Phi: finite. Impactx, y: finite. Start altitude> 0.Refraction
v: if1 < v < 1.0003,n-1 = v-1; if0 < v < 0.0003,n-1 = v; elseinvalid refraction index: <v>. Finaln-1must lie in(0, 0.0003).Atmosphere: only
constor-1; atmosphere tables are not supported.Wavelengths:
200 <= wlmin <= wlmax <= 2000nm. Charge!= 0. Mass in[0.0005, 100]GeV.Momentum
-p> 0;beta = p / sqrt(p^2 + m^2)with the final mass, applied after all options.--betain(0, 1];--betawith-p:--beta and --momentum are exclusive.--primary ID|NAME: a text starting with a digit is a CORSIKA id, else a name. Sets mass and charge at that point; later-mor-qoverride. Names:gamma1,positron2,electron3,muon/mu-6,mu+5,proton14; other names:unknown primary name: <name>.mass_charge(id)(mass [GeV], charge): 3: -1, 0.000511; 2: +1, 0.000511; 6: -1, 0.105658; 5: +1, 0.105658; 8: +1, 0.13957; 11: +1, 0.493677; 14: +1, 0.938272; 13 and 25: 0, 0.939565; 9: -1, 0.13957; 12: -1, 0.493677; 10 and 16: 0, 0.497648; 15: -1, 0.938272; 66-69, 133, 134: 0, 1e-11; 130: +1, 1.777; 131: -1, 1.777; 7: 0, 0.134; 17: 0, 0.54751; 50: 0, 0.78265; 51: 0, 0.7755; 52: +1, 0.7755; 53: -1, 0.7755; other ids in(1,100)or(110,199): 0, 1.2; ids100..110and>= 199(nuclei): chargeid mod 100, mass(0.931494 - 0.000511) floor(id/100)(id 402:0.931845 x 4); ids<= 1: 0, 0.Scatter (
--enable-scatter) and-I...: rejected.--rscatmust be 0;--nscatmust be 1.validate(Options): finite impact position; ranges above; a non-empty profile needs equal sizes, at least two nodes, strictly increasing altitudes and positiven-1; bunch> 0.Index profile file: whitespace-separated numbers. Errors:
index profile <name>: expected 'altitude n-1' lines,has no data,a value is missing its pair.
Geometry#
direction = (-sin(theta) cos(phi), -sin(theta) sin(phi), -cos(theta)),dist = h_start / cos(theta).Impact point
I = (x, y, 0).Constant index:
n = 1 + n1,cos_ct = 1/(n beta). Ifcos_ct > 1, there are no segments (events contain empty telescope blocks). Otherwise oneTrackwithstart = I - direction dist,length = dist,time = -dist/(beta c),cos_theta = cos_ct.Profile:
steps = ceil(dist/10),step = dist/steps. Walking up fromI:upper = lower - direction step,mid = lower - direction step/2,travelled += step,n = 1 + index_at(mid.z),cos_ct = 1/(n beta); ifcos_ct <= 1emit a Track (start = upper,length = step,time = -travelled/(beta c)). Segments are in order, lowest first.index_at(h): linear interpolation ofn-1, constant beyond the first and last node.Every Track: spectrum Fixed(wlmin) if
wlmin == wlmax, else InverseSquare(wlmin, wlmax); targetSphereTarget((0,0,0), radius); mean photons (Frank-Tamm)2 pi alpha q^2 (1 - cos_ct^2) (1/wlmin - 1/wlmax) 1e9 x length,alpha = 0.0072973526, wavelengths in nm.
Stream#
Run:
wavelength_min/max= wlmin/wlmax, telescope id 1 at (0, 0, 0), radiusr.Events
1..N. Event record:primary_id,energy_gev(gamma x mass, withgamma = 1/sqrt(1 - beta^2)ifbeta < 1andmass > 0, else1e-9),core_x_m = [x],core_y_m = [y].In each event, segment
kin order:emit_track(segment, source_seed(seed, k), event, 1, ...).Stderr after the stream:
obdeect sources muon-track: expected weight <%.6g>, wrote <rows> photons, weight <%.6g>(expected = sum ofexpected_track_weightover segments times events).