Source code for hispecdrp.datamodels.level2


from .base_model import DataModel
from .mixins import FiberAttributeProxyMixin
from .extensions import create_dataspec_extensions, create_specdq_extensions, create_wave_extensions, create_midtime_extensions, create_barycorr_extensions, create_starmodel_extensions, create_throughput_extensions, create_rv_extensions, create_sky_extensions, create_telluric_extensions, create_trans_extensions, create_drift_extensions, create_etalonfitparam_extensions, create_fluxabs_extensions

__all__ = ['L2Model']

[docs] class L2Model(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 = { **create_dataspec_extensions(prefix='SPEC_UNCAL', title='L1 spectrum.', units='e-/s'), **create_specdq_extensions(prefix='SPEC_UNCAL', title='Uncalibrated spectrum data-quality flags.'), **create_dataspec_extensions(prefix='SPEC', title='Calibrated spectrum.', units='e-/s'), **create_specdq_extensions(title='Calibrated spectrum data-quality flags.'), **create_wave_extensions(title='Drift corrected wavelength solution in rest frame of the instrument.'), **create_drift_extensions(), **create_midtime_extensions(title='Flux-weighted exposure mid-point times.'), **create_barycorr_extensions(), **create_starmodel_extensions(title='Stellar model spectrum Doppler shifted according to Barycenter OR RVs.', units='W/m^2/micron'), **create_throughput_extensions(title='End-to-end throughput derived from STAR_MOD.'), **create_rv_extensions(), **create_sky_extensions(title='Sky spectrum or model.', units='e-/s'), **create_telluric_extensions(), **create_trans_extensions(), **create_etalonfitparam_extensions(), **create_fluxabs_extensions(), } @property def data_level_suffix(self): return 'spec' @property def primary_extension_name(self): for fiber in range(1, self.config.num_fibers + 1): if self.has_extension_value(f'spec_fib{fiber}'): return f'spec_fib{fiber}' if self.has_extension_value(f'spec_uncal_fib{fiber}'): return f'spec_uncal_fib{fiber}' return None
[docs] @classmethod def from_datamodels(cls, *args, **kwargs) -> 'DataModel': # Initialize the L2 model model_out = super().from_datamodels(*args, **kwargs) # Copy the uncal spectrum into the calibrated spectrum for fiber in range(1, model_out.num_fibers + 1): if model_out.has_extension_value(f'spec_uncal_fib{fiber}'): model_out[fiber].spec = model_out[fiber].spec_uncal.copy() model_out[fiber].spec_err = model_out[fiber].spec_uncal_err.copy() model_out[fiber].spec_var_rnoise = model_out[fiber].spec_uncal_var_rnoise.copy() model_out[fiber].spec_var_poisson = model_out[fiber].spec_uncal_var_poisson.copy() model_out[fiber].spec_dq = model_out[fiber].spec_uncal_dq.copy() return model_out