hispecdrp.datamodels.level2
Classes
|
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,DataModelHISPEC 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'}}
- classmethod from_datamodels(*args, **kwargs)[source]