Limitations and Known Issues
Simulation fidelity
Tellurics — not fully modeled in the default rate-map path; line-mask utilities can apply telluric filters offline (
hispecdrp.utils.line_mask_utils).pyechelle photon ray-tracing — optional; E2E default is native
prf_convolution(faster, noiseless rate map + Poisson noise applied increate_ramp).Fiberflat SED — dummy fiberflats use a 1000 K blackbody, not a facility halogen WHITELIGHT spectrum; trace geometry matches science via the same HDF model.
Stage 2 docs — Stage 2 Pipeline is marked under development; behavior follows
StellarRVPrimitive.
Calibration alignment
KOA fiberflat / trace masters — products from an older instrument era may not match the current pyechelle HDF model. Default
derive_stage1_trace_from_sim=Trueavoids this. A simulation-matched fiber flat should be registered in KOA for production use.KOA download failures — empty zip archives have been observed in development; E2E falls back to simulated stage-0 cals when fetch fails.
Network dependencies
Default E2E runs query:
ESA Gaia Archive (TAP) / VizieR — Gaia DR3 via TAP with VizieR fallback, and 2MASS via VizieR (via
hispecdrp.primitives.utils.gaia_queryandhispecdrp.simulations.e2e_gaia)KOA — optional stage-0 calibrations when
use_master_calibrations=TrueGoogle Drive — HDF instrument model auto-download on first use
Runs without network access require pre-cached HDF data, offline calibration YAML paths,
and use_gaia_target=False.