Skip to content

Commit

Permalink
add units
Browse files Browse the repository at this point in the history
  • Loading branch information
@weaverba137
weaverba137 committed Oct 11, 2024
1 parent dab9a68 commit d03809c
Show file tree
Hide file tree
Showing 3 changed files with 60 additions and 55 deletions.
110 changes: 55 additions & 55 deletions doc/DESI_SPECTRO_REDUX/SPECPROD/exposures-SPECPROD.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
1 change: 1 addition & 0 deletions doc/changes.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ 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.

.. _`#199`: https://github.com/desihub/desidatamodel/pull/199

Expand Down
4 changes: 4 additions & 0 deletions py/desidatamodel/data/column_descriptions.csv
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)"
Expand Down

0 comments on commit d03809c

Please sign in to comment.