data_models.masters.level2

KPF Masters Level 2 data model.

Extracted-spectrum-level masters calibration product (e.g., master wavelength solutions, master flats).

Inherits from KPFMasterModel and KPF2. The full L2 schema and the KPF alias system are inherited from KPF2 (see aliases.csv and trace-map.csv for the mapping between KPF-internal fiber names like SCI2_WAVE and the EPRV standard names like TRACE3_WAVE).

An L2 master carries a different extension set per type: a WLS master holds wavelength solutions (TRACE*_WAVE) and fit coefficients (*_WLS_COEFFS); a flat master holds extracted spectra (TRACE*_FLUX/VAR/ BLAZE). Each type has its own authoritative manifest – ML2-wls-extensions.csv and ML2-flat-extensions.csv – selected by the required kind argument (see __init__). Construction is explicit; from_fits infers kind from the file’s PRIMARY MASTYPE.

Filename convention (WMKO DRP-RUN-05): masters are written as {KOAID-of-first-input}_master_{type}_L2.fits (e.g. KP.20240405.49597.71_master_thar_L2.fits), built by KPFMasterModel.generate_standard_filename().

class kpfpipe.data_models.masters.level2.KPFMasterL2(kind)

Bases: KPFMasterModel, KPF2

KPF Masters Level 2 extracted-spectrum calibration product.

Thin wrapper around KPF2 with masters-specific DATALVL, filename prefix, and INPUT_FILES extension. Inherits the full L2 schema and the KPF2 alias system (e.g., SCI2_WAVE -> TRACE3_WAVE, with chip- prefix access GREEN_SCI2_WAVE / RED_SCI2_WAVE).

Construct with an explicit type, KPFMasterL2(kind=”wls”) or kind=”flat”, or load a product from disk with KPFMasterL2.from_fits(path) (which infers the kind from MASTYPE).

classmethod from_fits(fn, instrument=None, **kwargs)

Load an L2 master, inferring kind from the file’s PRIMARY MASTYPE.

rvdata’s RVDataModel.from_fits builds the instance via cls() with no args, which a required kind rejects. This override reads MASTYPE (always set by set_input_files on a written master), maps it to a schema kind, and constructs explicitly. Mirrors the base from_fits flow (the base also computes an unused MD5 digest, which is omitted here).

read(hdul, instrument=None, overwrite=False, **kwargs)

Route Masters L2 FITS reads to KPFMasterL2._read.

RVDataModel.read dispatches lvl==2 to RV2._read, which only knows the EPRV standard L2 extensions and would KeyError on masters-specific ones (INPUT_FILES, *_WLS_COEFFS).