laser-beam: specification#
Options and examples: laser-beam. Writer B, producer
obdeect sources laser-beam. Only primary photons are generated; scattering is in
obdeect propagation.
Validation#
--stepmetres,> 0and finite.--primary-per-m>= 0, finite (a sampling choice).--brightnessis rejected:--brightness is replaced by --primary-per-m.--laser-position x,y,z;x,yallowed (z = 0), else--laser-position needs x,y or x,y,z.--fov:0 < fov < 90, elselaser-beam: field of view must lie in (0, 90) deg.--angular,--angular-distribution: stored verbatim, not interpreted.Astronomical azimuth
aconverts to the mathematical azimuth by-aifa <= 0, else360 - a(both--laser-phiand--telescope-phi). The C++ option struct holds the mathematical values (defaults 180 and 0).
Geometry#
Beam direction
dir = direction_from_altitude((90 - laser_theta) deg, laser_phi deg), sodir.z = cos(theta).Telescope-axis frame:
p = rotate_y(rotate_z(laser_position, -phi_t), -theta_t),q = rotate_y(rotate_z(dir, -phi_t), -theta_t).Cone of half angle
h = fov/2,T = tan(h). Pointsp + t qon the cone satisfya t^2 + b t + c = 0witha = qx^2 + qy^2 - qz^2 T^2,b = 2 (qx px + qy py - qz pz T^2),c = px^2 + py^2 - pz^2 T^2.Roots
t1 <= t2(numerically stable, relative accuracy 1e-12). Ifa = 0andb != 0, the root is-c/b.Interval:
a > 0:[max(t1, 0), t2];a = 0,b > 0,c < 0:[0, -c/b].Rejected: negative discriminant or no forward interval (
laser-beam: laser beam does not cross the field of view);a < 0or an unbounded linear case.Beam start (sky frame, relative to the telescope):
laser_position + dir x interval_start. The nappe is not checked.
Emissions#
Steps
s_kby repeated addition in double:s = 0; while s < L: emit k; s += step(aboutceil(L/step)steps).Step
k: emitter atstart + dir s_k, pointingdir, FixedAngle(0), frame sky,Source.photons = primary_per_m x step / b,b = max(1, bunchsize), seedseed + k, bunch weightb, time offsets_k / c(float32 after the pulse).One case,
eventsevents. Expected total weightprimary_per_m x Lwithin4 b sqrt(steps) / 2.
Run record#
One telescope id 1 at (0, 0, 0), radius
--telescope-radius; wavelength range from the spectrum.Extra keys:
scattering_angular(string = angular text),primary_photons_per_m(f64),beam_step_m,beam_path_m(= L),fov_deg,telescope_zenith_deg,telescope_azimuth_deg(f64; the last two are the stored mathematical-sense values).