hispecdrp.calibrations.selectors

Classes

BiasSelector([origin, cal_version, master_cal])

Selector for bias calibration files.

DQSelector([origin, cal_version, master_cal])

Selector for data quality calibration files.

DarkSelector([origin, cal_version, master_cal])

Selector for dark calibration files.

DetectorFlatSelector([origin, cal_version, ...])

Selector for detector flat calibration files.

FiberFlatSelector([origin, cal_version, ...])

Selector for fiber-flat calibration files.

GainSelector([origin, cal_version, master_cal])

Selector for detector gain calibration files.

HISPECCalibrationSelector([origin, ...])

Base selector for HISPEC calibrations.

LSFSelector([cal_type])

Selector for LSF calibration files.

NonlinearCorrectionSelector([origin, ...])

Selector for nonlinear correction calibration files.

ReadNoiseSelector([origin, cal_version, ...])

Selector for read noise calibration files.

ReferenceEtalonSelector([origin, ...])

Selector for reference etalon calibration files.

SaturationSelector([origin, cal_version, ...])

Selector for saturation calibration files.

TracePosSelector([origin, cal_version, ...])

Selector for trace position calibration files.

TraceProfSelector([origin, cal_version, ...])

Selector for trace profile calibration files.

WavelengthSolutionSelector([cal_type, ...])

Selector for wavelength solution calibration files.

class BiasSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for bias calibration files.

Calibration Type: bias

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class DQSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for data quality calibration files.

Calibration Type: dq

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Closest in observation time

get_candidates(meta, db)[source]
class DarkSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for dark calibration files.

Calibration Type: dark

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Closest in observation time

get_candidates(meta, db)[source]
class DetectorFlatSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for detector flat calibration files.

Calibration Type: detflat

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class FiberFlatSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for fiber-flat calibration files.

Prefers flats whose object_fiber{N} is WHITELIGHT for every science fiber on the input (object_fiber{N} == SCIENCE), so a fiber-2-only flat is not chosen for a fiber-1 / fiber-3 exposure on the same night.

static _science_fibers_from_input(input)[source]

Resolve SCIENCE fibers from a DataModel or bare meta.

HISPECCalibrationStore.select_and_get_calibration passes input.meta into selector.select, so input is often already a MetaModel (no nested .meta).

get_candidates(meta, db)[source]
select_best(input, candidates, **kwargs)[source]
class GainSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for detector gain calibration files.

Calibration Type: gain

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class LSFSelector(cal_type='lsf')[source]

Bases: HISPECCalibrationSelector

Selector for LSF calibration files.

Calibration Type: Configurable (default: lsf)

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Closest in observation time

Parameters:

cal_type (str, optional) – The type of wavelength calibration to select. Default: lsf

get_candidates(meta, db)[source]
class NonlinearCorrectionSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for nonlinear correction calibration files.

Calibration Type: nonlin

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

  • Prefer sim-matched nonlin (meta.note / sim_matched_nonlin) when present among candidates, so UTR sims that set nonlin_coeffs do not silently pick a competing KOA master

get_candidates(meta, db)[source]
select_best(input, candidates, **kwargs)[source]

Prefer sim-matched nonlin when it is among the candidates.

class ReadNoiseSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for read noise calibration files.

Calibration Type: rn

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class ReferenceEtalonSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for reference etalon calibration files.

Calibration Type: ref_etalon

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Closest in observation time

get_candidates(meta, db)[source]
class SaturationSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for saturation calibration files.

Calibration Type: saturation

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class TracePosSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for trace position calibration files.

Calibration Type: tracepos

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class TraceProfSelector(origin='ANY', cal_version='LATEST', master_cal=None, **kwargs)[source]

Bases: HISPECCalibrationSelector

Selector for trace profile calibration files.

Calibration Type: traceprof

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Require master calibration

  • Closest in observation time

get_candidates(meta, db)[source]
class WavelengthSolutionSelector(cal_type='lfc_wavesol', fallback_cal_types=None)[source]

Bases: HISPECCalibrationSelector

Selector for wavelength solution calibration files.

Calibration Type: Configurable (default: lfc_wavesol)

Selection Logic:

  • Match instrument era

  • Match spectrograph

  • Closest in observation time

  • Prefer packaged sim-HDF line-ZP WAVE (meta.note / sim_hdf_wavesol.line_zp) when present among candidates, so simulation Stage 1 does not silently pick a competing geometric lfc_wavesol

Parameters:
  • cal_type (str, optional) – The type of wavelength calibration to select. Default: lfc_wavesol

  • fallback_cal_type (str | None, optional) – The type of wavelength calibration to select as a fallback. Default: None

_rows_for_cal_type(cal_type, meta, db)[source]
get_candidates(meta, db)[source]
select_best(input, candidates, **kwargs)[source]

Prefer packaged sim-HDF line-ZP WAVE when it is among the candidates.