# Optical elements The model describes the surfaces a photon can meet, their responses, and the focal surface where tracing ends. ## Reflecting elements Mirrors redirect photons by specular reflection. Reflectivity and degradation change their weights; scattering perturbs the reflected direction. **Segmented dishes** (`mirror_class` 0): mirror centres from `mirror_list`, on the dish shape (`parabolic_dish`, `dish_shape_length`) unless a z is given. Each mirror is a sphere. Its focal length is the catalogue value or, if zero, the automatic prescription (distance to the focus or `mirror_focal_length`), with `random_focal_length` errors (clipped Gaussian or uniform). Alignment follows `mirror_align_random_distance`, `_horizontal` and `_vertical`, with zenith-dependent widths `sqrt(r0² + d0²(cos θ - cos θ0)² + e0²(sin θ - sin θ0)²)` at the telescope zenith θ. Mirror apertures: circle, hexagon (both orientations), square. **Dual-mirror telescopes** (`mirror_class` 2): even polynomial surfaces for primary, secondary and focal surface (`*_parameters`, optional `*_ref_radius`). The secondary's input frame is rotated by π about y. Apertures come from diameters and holes, and segmentation (`*_segmentation`) gives gaps between segments. Segments are traced at their design positions. ## Refracting elements Refracting elements, such as lenses and camera windows, are not traced. The optical path ends at the camera entrance; camera-window transmission belongs to the downstream camera simulation. Refraction in air is omitted. The model's `propagation_group_index` sets photon flight times; it does not bend rays. See [Scope and limitations](limitations.md). ## Obscuring elements Obscurers block light on the legs `incoming`, `after_primary` and `after_secondary`. They include camera bodies, secondary shadows, baffles and telescope structure. A blocked photon records the obscurer's id as its `terminal_surface`. - Camera body (`camera_body_diameter`, `_shape`, `camera_depth`): incoming photons are tested on the camera front and back planes (single mirror). Rays between primary and secondary are tested on the camera back plate and an open side wall (dual mirror). - `secondary_mirror_shadow_diameter`/`_offset`: a plate tested by incoming light, or the secondary itself if no diameter is given. - `secondary_mirror_baffle` (z1, z2, R1, wall thickness, R2): open cylinder or cone wall with annular end faces on the incoming and after-primary legs. A thickness not below R1 is read as the outer radius. ### Telescope structure If a telescope model has the parameter `telescope_structure`, the shadows of its structure (masts, quadrupods, dish frame) are traced on all legs. Then `telescope_transmission` is not applied: the geometry replaces the parameterised shadowing. The camera body shadow stays. The table is ECSV in metres, in the `primary_mirror_frame` (the frame of `mirror_list`, z = 0 at the dish vertex), one row per element: - `cylinder`: axis end points `x1 y1 z1`, `x2 y2 z2` and `diameter`; - `convex_polyhedron`: corner points `x1 y1 z1`, `x2 y2 z2`, ... (at least four); the element is the solid convex hull of its corners. Columns `id`, `group` (optional) and `shape` are text. A row leaves unused columns as `nan`; unused points come last. Which elements shade the light is shown by `OpticalModel.obscurer_hits` and `obdeect ray-tracing obscurers` (see [Shadowing](shadowing.md)). ## Focal surface The focal surface records arriving photons and ends the optical trace. - Single-mirror telescopes: focal plane at `focal_length + focus_offset - mirror_offset`. The zenith terms of `focus_offset` apply only if both are non-zero. - Dual-mirror telescopes: the focal surface polynomial, unbounded in radius. ## Optical responses `mirror_reflectivity` (wavelength and optionally incidence angle, resampled on a 1 nm grid), `mirror_degraded_reflection`, the secondary's own tables, `telescope_transmission` (angular parametrisation, method and outer power), and spatial degradation maps.