Optical models#
Frames and units#
Lengths are metres; angles are degrees unless named _rad. In the telescope frame,
+z points along the optical axis towards the sky, and the dish vertex is at
z = -mirror_offset. The x and y axes follow the mirror-list coordinates; when the
telescope points above the horizon, x points down.
star_photons samples a disk centred on the dish vertex, perpendicular to the optical
axis, with radius 1.2 times the dish radius. sampling_area_m2 is its area. The distance
of a point source is measured from the disk centre.
File format#
An optical model (obdeect.optical-model.v2) is one JSON document:
format,sha256(of the document without it),provenance(parameter versions, file hashes, seed, zenith angle, structure flag),notes;sampling: the star-light disk;optics:primary, optionalsecondary(eachfacetsor anaspherewithsegments, areflectivitytable,scatter, optionaldegradationmap),focal_surface(plane or asphere),obscurers(cylinder, polyhedron, plate, frustum; acting on the legsincoming,after_primary,after_secondary),telescope_transmission,propagation_group_index, and optionalaxes_offset_m.
The C++ loader accepts only known keys, checks every value and names the JSON path of the first error. Surface and obscurer ids are unique.
Axes offset#
Some telescopes have the optical origin displaced from the rotation axes. The sim_telarray
axes_offsets record gives the horizontal offset between the azimuth and altitude axes,
then the altitude-to-optical-axis offset, in its units (cm in sim_telarray).
The compiler stores the offset in the telescope frame, in metres, as
optics.axes_offset_m = [x, y, z]. The key is written only when the offset is non-zero,
and needs the compilation zenith angle. For components (O, T) and zenith theta, the
offset is (O cos(theta) - T, 0, O sin(theta)). The loader requires three numbers.
Only trace_bunches applies the offset (see Air-shower photons).
trace, star_photons and the emitter paths do not use it.
For mirrors, obscurers and the telescope-structure table, see Optical elements.