flasher: specification#
Options and examples: flasher. Writer A, producer
obdeect sources flasher, telescope_id = 1, telescope at (0, 0, 0).
Option parsing#
Arguments are collected as (name, value) pairs;
--helpanywhere prints usage and exits 0.--typeis evaluated first (default dish), then the other options left to right.An option of the other type:
<option> applies only to --type dish|secondary.Other errors (all prefixed
flasher:):--type must be dish or secondary, not '<x>';--framewith secondary:--frame applies only to --type dish;--framevalue other than sky or camera;--xyneeds exactly two values with dish (needs x,y with --type dish);--delays needs 4 or 5 values(missing T5 is 0);--events takes one value with --type secondary; empty--eventsor--photonslist; negative event count; non-finite bunch size.Bunch size below 1 is used as 1. Positive required:
--distance,--camera-radius,--mirror-camera-distance. Non-negative required:--flasher-xy,--events,--photons.--xyand--flasher-xyare both accepted for both types, with the meaning of the type.
Dish#
Emitter at
(x, y, distance)cm converted to m, pointing(0, 0, -1), fiducial radiusR = camera_radius / 100m, targetfiducial_target(position, R, angular).Photon levels
k = 0..L-1: levelkhasevents[min(k, len-1)]events, one emission per event,Source.photons = photons[k] / b. Event numbers1, 2, ...are consecutive across levels.Emission
j(counted over all events) has seedderive_seed(seed, j), bunch weightb, time offset 0,to_camera_plane = (frame == camera). Random keys: telescope 1, event number.Camera frame: writer A step 1 (see stream-writer). Path
z / -cz,tgainspath / c.
Secondary#
Frame T (code 2). Run radius 1.20 m (not an option), fiducial target radius 1.2 m.
Flasher
i = 0..3:sx = +1fori < 2, else -1;sy = +1for eveni, else -1. Position (cm)(sx xy, sy xy, mirror_camera_distance + depth)converted to m.Pointing: altitude
-90 deg + inclination, azimuthatan2(y, x)of the flasher,pointing = (cos alt cos az, cos alt sin az, sin alt). Inside the 1.2 m sphere with default values, so no target.Emission counter
jruns over the whole run, so seeds arederive_seed(seed, j).Fire modes (per event
iev, 0-based within a level):
|
emissions |
|---|---|
|
flashers 0..3, offsets |
|
flasher |
|
that flasher, offset |
|
flashers 0..3 with offsets |
For
demo, if all five delays are exactly 0 they become0,10,20,30,50.Time: pulse time plus offset (float32 add). No
zemcolumn (frame T).
Output metadata#
Writer A. observation_level_m = --altitude or the type default; atmosphere_id =
--atmosphere; run_number = --run; wavelength_* from the spectrum range.