hispecdrp.datamodels.level2

Classes

L2Model([filepath, meta, meta_only, ...])

HISPEC Level 2 (L2) data products are fully calibrated science-level data.

class L2Model(filepath=None, meta=None, meta_only=False, extensions=None, correct_dtypes=False, config=None, validate_meta=True, instrument_name=None, shape=None, **kwargs)[source]

Bases: FiberAttributeProxyMixin, DataModel

HISPEC Level 2 (L2) data products are fully calibrated science-level data. These products retain the original Level 1 spectra to simplify tracking of data processing steps. Additionally, they include advanced calibrations such as sky subtraction, blaze correction, telluric correction, and stellar radial velocity (RV) measurements. Data products from BSPEC and RSPEC are still kept separate.

Extensions

‘_FIB#’ in an HDU name denotes the fiber number (1..model.num_fibers).

HDU Name

HDU Type

Data Type

Dimensions

Units

Description

SPEC_UNCAL_FIB#

Image

Float32

Nord x 4096

e-/s

L1 spectrum.

SPEC_UNCAL_ERR_FIB#

Image

Float32

Nord x 4096

e-/s

L1 spectrum error.

SPEC_UNCAL_VAR_POISSON_FIB#

Image

Float32

Nord x 4096

(e-/s)^2

L1 spectrum variance (Poisson).

SPEC_UNCAL_VAR_RNOISE_FIB#

Image

Float32

Nord x 4096

(e-/s)^2

L1 spectrum variance (read noise).

SPEC_UNCAL_DQ_FIB#

Image

UInt32

Nord x 4096

Uncalibrated spectrum data-quality flags.

SPEC_FIB#

Image

Float32

Nord x 4096

e-/s

Calibrated spectrum.

SPEC_ERR_FIB#

Image

Float32

Nord x 4096

e-/s

Calibrated spectrum error.

SPEC_VAR_POISSON_FIB#

Image

Float32

Nord x 4096

(e-/s)^2

Calibrated spectrum variance (Poisson).

SPEC_VAR_RNOISE_FIB#

Image

Float32

Nord x 4096

(e-/s)^2

Calibrated spectrum variance (read noise).

SPEC_DQ_FIB#

Image

UInt32

Nord x 4096

Calibrated spectrum data-quality flags.

WAVE_FIB#

Image

Float64

Nord x 4096

micron

Drift corrected wavelength solution in rest frame of the instrument.

DRIFT_FIB#

Table

See docs

See docs

Drift correction table for each fiber.

MID_TIME_FIB#

Image

Float64

Nord x 4096

MJD

Flux-weighted exposure mid-point times.

BARYCORR_FIB#

Table

See docs

See docs

Barycentric correction information.

STAR_MOD_FIB#

Image

Float32

Nord x 4096

W/m^2/micron

Stellar model spectrum Doppler shifted according to Barycenter OR RVs.

THROUGHPUT_FIB#

Image

Float32

Nord x 4096

End-to-end throughput derived from STAR_MOD.

RVCCF_FIB#

Table

See docs

See docs

Per-chunk RVs and raw CCF(v) (stellar RV).

RVCCFAVG_FIB#

Table

See docs

See docs

RVs aggregated across chunks (CCF-based).

RVFWM_FIB#

Table

See docs

See docs

Per-chunk RVs (first-moment method).

RVFWMAVG_FIB#

Table

See docs

See docs

RVs aggregated across chunks (first-moment method).

SKY_FIB#

Image

Float32

Nord x 4096

e-/s

Sky spectrum or model.

SKY_ERR_FIB#

Image

Float32

Nord x 4096

e-/s

Sky spectrum or model error.

TEL_FIB#

Image

Float32

Nord x 4096

Telluric model spectrum.

TEL_ERR_FIB#

Image

Float32

Nord x 4096

Telluric model spectrum error (all sources).

TRANS_FIB#

Image

Float32

Nord x 4096

Transmission correction.

TRANS_ERR_FIB#

Image

Float32

Nord x 4096

Transmission correction error.

ETALON_FITPARAMS_FIB#

Table

See docs

See docs

Etalon fit parameters for each mode, order, and fiber.

FLUX_ABS_FIB#

Image

Float32

Nord x 4096

W/m^2/micron

Spectrum in absolute flux units.

FLUX_ABS_ERR_FIB#

Image

Float32

Nord x 4096

W/m^2/micron

Absolute spectrum error (all sources).

FLUX_ABS_VAR_POISSON_FIB#

Image

Float32

Nord x 4096

(W/m^2/micron)^2

Absolute spectrum variance (Poisson).

FLUX_ABS_VAR_RNOISE_FIB#

Image

Float32

Nord x 4096

(W/m^2/micron)^2

Absolute spectrum variance (read noise).

FLUX_ABS_DQ_FIB#

Image

UInt32

Nord x 4096

Absolute spectrum data quality.

EXTENSIONS = {'BARYCORR': {'columns': {'BERV': <class 'numpy.float64'>, 'BERVW': <class 'numpy.float64'>, 'MBJD': <class 'numpy.float64'>, 'MBJDW': <class 'numpy.float64'>, 'MJDUTC': <class 'numpy.float64'>, 'MJDUTCW': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'Barycentric correction information.'}, 'CALIBRATIONS': {'columns': {'CAL_ROLE': <class 'str'>, 'CAL_TYPE': <class 'str'>, 'CLASS': <class 'str'>, 'DATETIME_OBS': <class 'str'>, 'DRP_VERSION': <class 'str'>, 'FILENAME': <class 'str'>, 'ID': <class 'str'>, 'LAST_PROCESSED': <class 'str'>, 'TIME_APPLIED': <class 'str'>}, 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>}, 'DATA_ANCESTORS': {'columns': {'CLASS': <class 'str'>, 'FILENAME': <class 'str'>, 'TIME_APPLIED': <class 'str'>}, 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>}, 'DRIFT': {'columns': {'DRIFT_ERR_PIX': <class 'numpy.float64'>, 'DRIFT_ERR_VEL': <class 'numpy.float64'>, 'DRIFT_ERR_WAVE': <class 'numpy.float64'>, 'DRIFT_PIX': <class 'numpy.float64'>, 'DRIFT_VEL': <class 'numpy.float64'>, 'DRIFT_WAVE': <class 'numpy.float64'>, 'ORDER': <class 'numpy.uint16'>, 'PIXEL': <class 'numpy.float64'>, 'WAVE': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'Drift correction table for each fiber.'}, 'ETALON_FITPARAMS': {'columns': {'AMPLITUDE': <class 'numpy.float64'>, 'AMPLITUDE_ERR': <class 'numpy.float64'>, 'B': <class 'numpy.float64'>, 'B_ERR': <class 'numpy.float64'>, 'FWHM_ERR_PIX': <class 'numpy.float64'>, 'FWHM_ERR_WAVE': <class 'numpy.float64'>, 'FWHM_PIX': <class 'numpy.float64'>, 'FWHM_WAVE': <class 'numpy.float64'>, 'MODE_NUM': <class 'numpy.int16'>, 'MU_ERR_PIX': <class 'numpy.float64'>, 'MU_ERR_WAVE': <class 'numpy.float64'>, 'MU_PIX': <class 'numpy.float64'>, 'ORDER': <class 'numpy.uint16'>, 'WAVE': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'Etalon fit parameters for each mode, order, and fiber.'}, 'FLUX_ABS': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Spectrum in absolute flux units.', 'units': 'W/m^2/micron'}, 'FLUX_ABS_DQ': {'default': 0, 'dtype': <class 'numpy.uint32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Absolute spectrum data quality.'}, 'FLUX_ABS_ERR': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Absolute spectrum error (all sources).', 'units': 'W/m^2/micron'}, 'FLUX_ABS_VAR_POISSON': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Absolute spectrum variance (Poisson).', 'units': '(W/m^2/micron)^2'}, 'FLUX_ABS_VAR_RNOISE': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Absolute spectrum variance (read noise).', 'units': '(W/m^2/micron)^2'}, 'MID_TIME': {'default': 0, 'dtype': <class 'numpy.float64'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Flux-weighted exposure mid-point times.', 'units': 'MJD'}, 'PRIMARY': {'dtype': None, 'hdu_type': <class 'astropy.io.fits.hdu.image.PrimaryHDU'>}, 'RECEIPT': {'columns': {'CLASS': <class 'str'>, 'CONFIG_FILE': <class 'str'>, 'DRP_GIT_COMMIT_ID': <class 'str'>, 'DRP_VERSION': <class 'str'>, 'FILENAME': <class 'str'>, 'PARAMETERS': <class 'str'>, 'PROC_END_TIME': <class 'str'>, 'PROC_START_TIME': <class 'str'>, 'STATUS': <class 'str'>}, 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>}, 'RVCCF': {'columns': {'BERVW': <class 'numpy.float64'>, 'BIS': <class 'numpy.float64'>, 'BIS_ERR': <class 'numpy.float64'>, 'CCF': <class 'object'>, 'CHUNK_ID': <class 'numpy.int32'>, 'INLIER': <class 'numpy.uint8'>, 'MBJDW': <class 'numpy.float64'>, 'N_GOOD': <class 'numpy.int32'>, 'N_VEL': <class 'numpy.int32'>, 'ORDER': <class 'numpy.int16'>, 'RESOLUTION': <class 'numpy.float64'>, 'RV': <class 'numpy.float64'>, 'RV_ABS': <class 'numpy.float64'>, 'RV_ABS_ERR': <class 'numpy.float64'>, 'RV_ERR': <class 'numpy.float64'>, 'TELL_ABS': <class 'numpy.float64'>, 'V_MAX': <class 'numpy.float64'>, 'V_MIN': <class 'numpy.float64'>, 'V_STEP': <class 'numpy.float64'>, 'WAVELENGTH': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'Per-chunk RVs and raw CCF(v) (stellar RV).'}, 'RVCCFAVG': {'columns': {'BERVW': <class 'numpy.float64'>, 'MBJDW': <class 'numpy.float64'>, 'RESOLUTION': <class 'numpy.float64'>, 'RV': <class 'numpy.float64'>, 'RV_ABS': <class 'numpy.float64'>, 'RV_ABS_ERR': <class 'numpy.float64'>, 'RV_ERR': <class 'numpy.float64'>, 'TELL_ABS': <class 'numpy.float64'>, 'WAVELENGTH': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'RVs aggregated across chunks (CCF-based).'}, 'RVFWM': {'columns': {'AIRMASS_ERR_FIT': <class 'numpy.float64'>, 'AIRMASS_FIT': <class 'numpy.float64'>, 'BERVW': <class 'numpy.float64'>, 'MBJDW': <class 'numpy.float64'>, 'PWV_ERR_FIT': <class 'numpy.float64'>, 'PWV_FIT': <class 'numpy.float64'>, 'RESOLUTION': <class 'numpy.float64'>, 'RV': <class 'numpy.float64'>, 'RV_ABS': <class 'numpy.float64'>, 'RV_ABS_ERR': <class 'numpy.float64'>, 'RV_ERR': <class 'numpy.float64'>, 'TELLURIC_VEL_ERR_FIT': <class 'numpy.float64'>, 'TELLURIC_VEL_FIT': <class 'numpy.float64'>, 'TELL_ABS': <class 'numpy.float64'>, 'WAVELENGTH': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'Per-chunk RVs (first-moment method).'}, 'RVFWMAVG': {'columns': {'BERVW': <class 'numpy.float64'>, 'BIS': <class 'numpy.float64'>, 'MBJDW': <class 'numpy.float64'>, 'RESOLUTION': <class 'numpy.float64'>, 'RV': <class 'numpy.float64'>, 'RV_ABS': <class 'numpy.float64'>, 'RV_ABS_ERR': <class 'numpy.float64'>, 'RV_ERR': <class 'numpy.float64'>, 'TELL_ABS': <class 'numpy.float64'>, 'WAVELENGTH': <class 'numpy.float64'>}, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.table.BinTableHDU'>, 'title': 'RVs aggregated across chunks (first-moment method).'}, 'SKY': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Sky spectrum or model.', 'units': 'e-/s'}, 'SKY_ERR': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Sky spectrum or model error.', 'units': 'e-/s'}, 'SPEC': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Calibrated spectrum.', 'units': 'e-/s'}, 'SPEC_DQ': {'default': 0, 'dtype': <class 'numpy.uint32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Calibrated spectrum data-quality flags.'}, 'SPEC_ERR': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Calibrated spectrum error.', 'units': 'e-/s'}, 'SPEC_UNCAL': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'L1 spectrum.', 'units': 'e-/s'}, 'SPEC_UNCAL_DQ': {'default': 0, 'dtype': <class 'numpy.uint32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Uncalibrated spectrum data-quality flags.'}, 'SPEC_UNCAL_ERR': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'L1 spectrum error.', 'units': 'e-/s'}, 'SPEC_UNCAL_VAR_POISSON': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'L1 spectrum variance (Poisson).', 'units': '(e-/s)^2'}, 'SPEC_UNCAL_VAR_RNOISE': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'L1 spectrum variance (read noise).', 'units': '(e-/s)^2'}, 'SPEC_VAR_POISSON': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Calibrated spectrum variance (Poisson).', 'units': '(e-/s)^2'}, 'SPEC_VAR_RNOISE': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Calibrated spectrum variance (read noise).', 'units': '(e-/s)^2'}, 'STAR_MOD': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Stellar model spectrum Doppler shifted according to Barycenter OR RVs.', 'units': 'W/m^2/micron'}, 'TEL': {'default': 1, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Telluric model spectrum.'}, 'TEL_ERR': {'default': 0, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Telluric model spectrum error (all sources).'}, 'THROUGHPUT': {'default': 1, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'End-to-end throughput derived from STAR_MOD.'}, 'TRANS': {'default': 1, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Transmission correction.'}, 'TRANS_ERR': {'default': 1, 'dtype': <class 'numpy.float32'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Transmission correction error.'}, 'WAVE': {'default': 0, 'dtype': <class 'numpy.float64'>, 'enumerate': 'FIB', 'hdu_type': <class 'astropy.io.fits.hdu.image.ImageHDU'>, 'shape': ('N_ORDERS', 'DETECTOR_SIZE_Y'), 'title': 'Drift corrected wavelength solution in rest frame of the instrument.', 'units': 'micron'}}
property data_level_suffix
classmethod from_datamodels(*args, **kwargs)[source]
property primary_extension_name