diff --git a/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures-SPECPROD.rst b/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures-SPECPROD.rst index a8022b37..d54d9701 100644 --- a/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures-SPECPROD.rst +++ b/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures-SPECPROD.rst @@ -64,61 +64,61 @@ Required Data Table Columns .. rst-class:: columns -====================== ======== ====== =========== -Name Type Units Description -====================== ======== ====== =========== -NIGHT int32 Observing night -EXPID int32 DESI Exposure number -TILEID int32 DESI Tile ID -TILERA float64 deg RA of tile given in fiberassign file -TILEDEC float64 deg DEC of tile given in fiberassign fileDEC of tile given in fiberassign file -MJD float64 Modified Julian Date when shutter was opened for this exposure. -SURVEY char[7] Survey name -PROGRAM char[6] Program name -FAPRGRM char[*] Fiberassign program name -FAFLAVOR char[*] Fiberassign flavor name -EXPTIME float64 s Length of time shutter was open. -EFFTIME_SPEC float64 s Effective exposure time for nominal conditions derived from the TSNR2 fits to the spectroscopy -GOALTIME float64 s Goal for total effective exposure time for the tile -GOALTYPE char[6] The intended observing conditions for the tile -MINTFRAC float64 Minimum fraction of GOALTIME acceptable for considering a tile complete -AIRMASS float32 Average airmass during this exposure. -EBV float64 Galactic extinction E(B-V) reddening from SFD98_ -SEEING_ETC float64 arcsec Average FWHM atmospheric seeing during this exposure as measured by ETC. -EFFTIME_ETC float32 s Effective exposure time for nominal conditions inferred from ETC data -TSNR2_ELG float32 ELG template (S/N)^2 summed over B,R,Z -TSNR2_QSO float32 QSO template (S/N)^2 summed over B,R,Z -TSNR2_LRG float32 LRG template (S/N)^2 summed over B,R,Z -TSNR2_LYA float64 LYA template (S/N)^2 summed over B,R,Z -TSNR2_BGS float32 BGS template (S/N)^2 summed over B,R,Z -TSNR2_GPBDARK float32 GPBDARK template (S/N)^2 summed over B,R,Z -TSNR2_GPBBRIGHT float32 GPBBRIGHT template (S/N)^2 summed over B,R,Z -TSNR2_GPBBACKUP float32 GPBBACKUP template (S/N)^2 summed over B,R,Z -LRG_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for LRG targets -ELG_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for ELG targets -BGS_EFFTIME_BRIGHT float32 s Effective exposure time for nominal bright conditions inferred for BGS targets -LYA_EFFTIME_DARK float64 s Effective exposure time for nominal dark conditions inferred for LYA targets -GPB_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for GPB targets -GPB_EFFTIME_BRIGHT float32 s Effective exposure time for nominal bright conditions inferred for GPB targets -GPB_EFFTIME_BACKUP float32 s Effective exposure time for nominal backup conditions inferred for GPB targets -TRANSPARENCY_GFA float64 Average airmass during this exposure as measured by GFA. -SEEING_GFA float64 arcsec Average FWHM atmospheric seeing during this exposure as measured by GFA. -FIBER_FRACFLUX_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs -FIBER_FRACFLUX_ELG_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs for a source with an ELG profile (0.45" exponential galaxy profile) -FIBER_FRACFLUX_BGS_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs for a source with a BGS profile (deV profile, half light radius of 1.5") -FIBERFAC_GFA float64 Fraction of light entering a fiber relative to expectations for 1.1" seeing, transparency 1, for an object with a PSF profile, measured by comparing the flux integrated over a 107 micron diameter circle on the GFA images centered at the PlateMaker expectations for where stars should land. -FIBERFAC_ELG_GFA float64 Same as FIBERFAC_GFA except for an ELG profile -FIBERFAC_BGS_GFA float64 Same as FIBERFAC_GFA except for a BGS profile -AIRMASS_GFA float64 Average airmass during this exposure as measured by GFA. -SKY_MAG_AB_GFA float64 Sky background in the GFA passband, measured from the GFA backgrounds. -SKY_MAG_G_SPEC float64 Sky background measured in the spectroscopy integrated over the DECam g passband, AB mags. -SKY_MAG_R_SPEC float64 Sky background measured in the spectroscopy integrated over the DECam r passband, AB mags. -SKY_MAG_Z_SPEC float64 Sky background measured in the spectroscopy integrated over the DECam z passband, AB mags. -EFFTIME_GFA float64 s Effective exposure time for nominal conditions inferred from GFA data -EFFTIME_DARK_GFA float64 s Effective exposure time for nominal dark conditions inferred from GFA data -EFFTIME_BRIGHT_GFA float64 s Effective exposure time for nominal bright conditions inferred from GFA data -EFFTIME_BACKUP_GFA float64 s Effective exposure time for nominal backup conditions inferred from GFA data -====================== ======== ====== =========== +====================== ======== ============= ================================= +Name Type Units Description +====================== ======== ============= ================================= +NIGHT int32 Observing night +EXPID int32 DESI Exposure number +TILEID int32 DESI Tile ID +TILERA float64 deg RA of tile given in fiberassign file +TILEDEC float64 deg DEC of tile given in fiberassign fileDEC of tile given in fiberassign file +MJD float64 Modified Julian Date when shutter was opened for this exposure. +SURVEY char[7] Survey name +PROGRAM char[6] Program name +FAPRGRM char[*] Fiberassign program name +FAFLAVOR char[*] Fiberassign flavor name +EXPTIME float64 s Length of time shutter was open. +EFFTIME_SPEC float64 s Effective exposure time for nominal conditions derived from the TSNR2 fits to the spectroscopy +GOALTIME float64 s Goal for total effective exposure time for the tile +GOALTYPE char[6] The intended observing conditions for the tile +MINTFRAC float64 Minimum fraction of GOALTIME acceptable for considering a tile complete +AIRMASS float32 Average airmass during this exposure. +EBV float64 Galactic extinction E(B-V) reddening from SFD98_ +SEEING_ETC float64 arcsec Average FWHM atmospheric seeing during this exposure as measured by ETC. +EFFTIME_ETC float32 s Effective exposure time for nominal conditions inferred from ETC data +TSNR2_ELG float32 ELG template (S/N)^2 summed over B,R,Z +TSNR2_QSO float32 QSO template (S/N)^2 summed over B,R,Z +TSNR2_LRG float32 LRG template (S/N)^2 summed over B,R,Z +TSNR2_LYA float64 LYA template (S/N)^2 summed over B,R,Z +TSNR2_BGS float32 BGS template (S/N)^2 summed over B,R,Z +TSNR2_GPBDARK float32 GPBDARK template (S/N)^2 summed over B,R,Z +TSNR2_GPBBRIGHT float32 GPBBRIGHT template (S/N)^2 summed over B,R,Z +TSNR2_GPBBACKUP float32 GPBBACKUP template (S/N)^2 summed over B,R,Z +LRG_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for LRG targets +ELG_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for ELG targets +BGS_EFFTIME_BRIGHT float32 s Effective exposure time for nominal bright conditions inferred for BGS targets +LYA_EFFTIME_DARK float64 s Effective exposure time for nominal dark conditions inferred for LYA targets +GPB_EFFTIME_DARK float32 s Effective exposure time for nominal dark conditions inferred for GPB targets +GPB_EFFTIME_BRIGHT float32 s Effective exposure time for nominal bright conditions inferred for GPB targets +GPB_EFFTIME_BACKUP float32 s Effective exposure time for nominal backup conditions inferred for GPB targets +TRANSPARENCY_GFA float64 Average airmass during this exposure as measured by GFA. +SEEING_GFA float64 arcsec Average FWHM atmospheric seeing during this exposure as measured by GFA. +FIBER_FRACFLUX_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs +FIBER_FRACFLUX_ELG_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs for a source with an ELG profile (0.45" exponential galaxy profile) +FIBER_FRACFLUX_BGS_GFA float64 Fraction of the flux entering the fiber relative to nominal 1.1" seeing using the PSF inferred from the GFAs for a source with a BGS profile (deV profile, half light radius of 1.5") +FIBERFAC_GFA float64 Fraction of light entering a fiber relative to expectations for 1.1" seeing, transparency 1, for an object with a PSF profile, measured by comparing the flux integrated over a 107 micron diameter circle on the GFA images centered at the PlateMaker expectations for where stars should land. +FIBERFAC_ELG_GFA float64 Same as FIBERFAC_GFA except for an ELG profile +FIBERFAC_BGS_GFA float64 Same as FIBERFAC_GFA except for a BGS profile +AIRMASS_GFA float64 Average airmass during this exposure as measured by GFA. +SKY_MAG_AB_GFA float64 mag arcsec^-2 Sky background in the GFA passband, measured from the GFA backgrounds. +SKY_MAG_G_SPEC float64 mag arcsec^-2 Sky background measured in the spectroscopy integrated over the DECam g passband, AB mags. +SKY_MAG_R_SPEC float64 mag arcsec^-2 Sky background measured in the spectroscopy integrated over the DECam r passband, AB mags. +SKY_MAG_Z_SPEC float64 mag arcsec^-2 Sky background measured in the spectroscopy integrated over the DECam z passband, AB mags. +EFFTIME_GFA float64 s Effective exposure time for nominal conditions inferred from GFA data +EFFTIME_DARK_GFA float64 s Effective exposure time for nominal dark conditions inferred from GFA data +EFFTIME_BRIGHT_GFA float64 s Effective exposure time for nominal bright conditions inferred from GFA data +EFFTIME_BACKUP_GFA float64 s Effective exposure time for nominal backup conditions inferred from GFA data +====================== ======== ============= ================================= .. _SFD98: https://ui.adsabs.harvard.edu/abs/1998ApJ...500..525S/abstract diff --git a/doc/changes.rst b/doc/changes.rst index b012400d..de561482 100644 --- a/doc/changes.rst +++ b/doc/changes.rst @@ -6,8 +6,11 @@ desidatamodel Change Log ------------------ * Update package infrastructure, fix search function, add missing columns (PR `#199`_). +* Update the units for ``SKY_MAG_*`` quantities in the ``SPECPROD/exposures-SPECPROD.rst`` + description (PR `#200`_). .. _`#199`: https://github.com/desihub/desidatamodel/pull/199 +.. _`#200`: https://github.com/desihub/desidatamodel/pull/200 24.9 (2024-09-12) ----------------- diff --git a/py/desidatamodel/data/column_descriptions.csv b/py/desidatamodel/data/column_descriptions.csv index c63cb45a..ab4d4481 100644 --- a/py/desidatamodel/data/column_descriptions.csv +++ b/py/desidatamodel/data/column_descriptions.csv @@ -342,6 +342,10 @@ SHAPE_E2_IVAR,float32,,Inverse variance of SHAPE_E2,Inverse variance of SHAPE_E2 SHAPE_R,float32,arcsec,Half-light radius of galaxy model (>0),Half-light radius of galaxy model (>0) SHAPE_R_IVAR,float32,arcsec^-2,Inverse variance of SHAPE_R,Inverse variance of SHAPE_R SIGMA_MGII,float32,Angstrom,Fitted param SIGMA (linewidth) by MgII fitter,Fitted parameter SIGMA (linewidth) by MgII fitter (in angstrom?) +SKY_MAG_AB_GFA,float64,mag arcsec^-2,Sky background in GFA passband,"Sky background in the GFA passband, measured from the GFA backgrounds." +SKY_MAG_G_GFA,float64,mag arcsec^-2,Sky background in g passband,"Sky background measured in the spectroscopy integrated over the DECam g passband, AB mags." +SKY_MAG_R_GFA,float64,mag arcsec^-2,Sky background in r passband,"Sky background measured in the spectroscopy integrated over the DECam r passband, AB mags." +SKY_MAG_Z_GFA,float64,mag arcsec^-2,Sky background in z passband,"Sky background measured in the spectroscopy integrated over the DECam z passband, AB mags." SPECTRO,int16,,Spectrograph number [0-9],Spectrograph number [0-9] SPECTROID,int32,,Hardware ID of spectrograph (not used),Hardware ID of spectrograph (not used) SPECTYPE,char[6],,"Best-fit spectral type: GALAXY, QSO, STAR","Spectral type of Redrock best fit template (e.g. GALAXY, QSO, STAR)"