From 343adc76dff4489f26ceaabd1059366973b49b16 Mon Sep 17 00:00:00 2001 From: Benjamin Alan Weaver Date: Thu, 21 Nov 2024 11:03:36 -0700 Subject: [PATCH] add extname --- .../GFA/offline_matched_coadd_ccds_SURVEY.rst | 204 +++++++++--------- doc/changes.rst | 4 +- 2 files changed, 106 insertions(+), 102 deletions(-) diff --git a/doc/DESI_ROOT/survey/GFA/offline_matched_coadd_ccds_SURVEY.rst b/doc/DESI_ROOT/survey/GFA/offline_matched_coadd_ccds_SURVEY.rst index f04e24da..75e8f738 100644 --- a/doc/DESI_ROOT/survey/GFA/offline_matched_coadd_ccds_SURVEY.rst +++ b/doc/DESI_ROOT/survey/GFA/offline_matched_coadd_ccds_SURVEY.rst @@ -12,14 +12,14 @@ offline_matched_coadd_ccds_SURVEY Contents ======== -====== ======= ======== =============================================================================================== -Number EXTNAME Type Contents -====== ======= ======== =============================================================================================== -HDU0_ IMAGE Empty HDU -HDU1_ EXTHDU1 BINTABLE Summary results of individual guide cameras. -HDU2_ EXTHDU2 BINTABLE Summary results accumulated per-exposure for all guide cameras. -HDU3_ EXTHDU3 BINTABLE Summary results accumulated per-exposure for all guide cameras with stricter data quality cuts. -====== ======= ======== =============================================================================================== +====== ======================= ======== =============================================================================================== +Number EXTNAME Type Contents +====== ======================= ======== =============================================================================================== +HDU0_ IMAGE Empty HDU +HDU1_ CAMERA_SUMMARY BINTABLE Summary results of individual guide cameras. +HDU2_ EXPOSURE_SUMMARY BINTABLE Summary results accumulated per-exposure for all guide cameras. +HDU3_ EXPOSURE_SUMMARY_STRICT BINTABLE Summary results accumulated per-exposure for all guide cameras with stricter data quality cuts. +====== ======================= ======== =============================================================================================== FITS Header Units @@ -35,12 +35,12 @@ Empty HDU. HDU1 ---- -EXTNAME = EXTHDU1 +EXTNAME = CAMERA_SUMMARY -ex=1 is a simple concatenation of all per-exposure ``gfa_reduce`` ``_ccds`` tables. -ex=1 has one row per exposure per guider camera, so the total number of rows is +``CAMERA_SUMMARY`` is a simple concatenation of all per-exposure ``gfa_reduce`` ``_ccds`` tables. +``CAMERA_SUMMARY`` has one row per exposure per guider camera, so the total number of rows is roughly 6 times the number of exposures. There are more than 100 columns in the -ex=1 table, most of which shouldn't be relevant for the purpose of estimating +``CAMERA_SUMMARY`` table, most of which shouldn't be relevant for the purpose of estimating effective exposure times. @@ -76,34 +76,34 @@ SIG float64 *Description needed.* MEDIAN_Q1 float64 *Description needed.* MEAN_Q1 float64 *Description needed.* N_NON_FINITE_Q1 int64 *Description needed.* -MAX_Q1 float64 Maximum raw GFA image pixel value in ADU in quadrant 1 (amp G) +MAX_Q1 float64 adu Maximum raw GFA image pixel value in ADU in quadrant 1 (amp G) MIN_Q1 float64 *Description needed.* SIG_ROBUST_Q1 float64 *Description needed.* SIG_Q1 float64 *Description needed.* MEDIAN_Q2 float64 *Description needed.* MEAN_Q2 float64 *Description needed.* N_NON_FINITE_Q2 int64 *Description needed.* -MAX_Q2 float64 Maximum raw GFA image pixel value in ADU in quadrant 2 (amp H) +MAX_Q2 float64 adu Maximum raw GFA image pixel value in ADU in quadrant 2 (amp H) MIN_Q2 float64 *Description needed.* SIG_ROBUST_Q2 float64 *Description needed.* SIG_Q2 float64 *Description needed.* MEDIAN_Q3 float64 *Description needed.* MEAN_Q3 float64 *Description needed.* N_NON_FINITE_Q3 int64 *Description needed.* -MAX_Q3 float64 Maximum raw GFA image pixel value in ADU in quadrant 3 (amp E) +MAX_Q3 float64 adu Maximum raw GFA image pixel value in ADU in quadrant 3 (amp E) MIN_Q3 float64 *Description needed.* SIG_ROBUST_Q3 float64 *Description needed.* SIG_Q3 float64 *Description needed.* MEDIAN_Q4 float64 *Description needed.* MEAN_Q4 float64 *Description needed.* N_NON_FINITE_Q4 int64 *Description needed.* -MAX_Q4 float64 Maximum raw GFA image pixel value in ADU in quadrant 4 (amp F) +MAX_Q4 float64 adu Maximum raw GFA image pixel value in ADU in quadrant 4 (amp F) MIN_Q4 float64 *Description needed.* SIG_ROBUST_Q4 float64 *Description needed.* SIG_Q4 float64 *Description needed.* CAMERA char[6] Camera identifier. Passband and SPECGRPH ([brz][0-9]). EXTNAME char[6] String guide camera name; one of GUIDE0, GUIDE2, GUIDE3, GUIDE5, GUIDE7, GUIDE8 -CONTRAST float64 Pattern-matching contrast for gfa_reduce astrometry; larger CONTRAST indicates a more robust astrometric solution +CONTRAST float64 Pattern-matching contrast for ``gfa_reduce`` astrometry; larger CONTRAST indicates a more robust astrometric solution SKY_MAG_AB float64 *Description needed.* SKY_MAG_AB_SUBREGION float64 *Description needed.* SKY_MAG_AB_PER_AMP float32[4] *Description needed.* @@ -217,29 +217,31 @@ SPECTRO_EXPID int64 *Description needed.* HDU2 ---- -EXTNAME = EXTHDU2 +EXTNAME = EXPOSURE_SUMMARY -This HDU is intended to be the same as ex=3, except that ex=2 employs more permissive +This HDU is intended to be the same as ``EXPOSURE_SUMMARY_STRICT``, except that ``EXPOSURE_SUMMARY`` employs more permissive quality cuts in the sense that no ``CONTRAST`` or ``N_SOURCES_FOR_PSF`` cuts are applied. -ex=2 still includes minimal quality cuts to remove cases of bad GFA readout such +``EXPOSURE_SUMMARY`` still includes minimal quality cuts to remove cases of bad GFA readout such as broken A/D conversion (lack of denoising) and zero-valued quadrants. -The idea behind ex=2 is that it avoids cuts that could bias toward retaining +The idea behind ``EXPOSURE_SUMMARY`` is that it avoids cuts that could bias toward retaining cameras with relatively good observing conditions (*e.g.*, ``N_SOURCES_FOR_PSF`` is preferentially higher when the transparency is better and the sky brightness is lower). We found that in practice such biases generally don't matter at any appreciable level, -so in general it's recommended to use ex=3 rather than ex=2. The downside of -ex=2 is that in rare cases it may get very wrong values, especially for the -transparency when gfa_reduce astrometric pattern matching has catastrophically +so in general it's recommended to use ``EXPOSURE_SUMMARY_STRICT`` rather than ``EXPOSURE_SUMMARY``. The downside of +``EXPOSURE_SUMMARY`` is that in rare cases it may get very wrong values, especially for the +transparency when ``gfa_reduce`` astrometric pattern matching has catastrophically failed (low CONTRAST parameter). -In some cases the lack of a ``CONTRAST`` cut in ex=2 can be valuable. +In some cases the lack of a ``CONTRAST`` cut in ``EXPOSURE_SUMMARY`` can be valuable. In rare instances (such as very poor observing conditions) a science exposure -can be omitted from ex=3 due to failed gfa_reduce astrometry. But the +can be omitted from ``EXPOSURE_SUMMARY_STRICT`` due to failed ``gfa_reduce`` astrometry. But the PMGSTARS forced photometry is still usable, since the PMGSTARS forced -photometry proceeds as usual even if gfa_reduce astrometry has failed. +photometry proceeds as usual even if ``gfa_reduce`` astrometry has failed. For this reason, as of late April 2021, the spectroscopy pipeline's tSNR -afterburner uses ex=2 rather than ex=3 (​https://github.com/desihub/desispec/pull/1245). +afterburner uses ``EXPOSURE_SUMMARY`` rather than ``EXPOSURE_SUMMARY_STRICT`` (PR `#1245`_). +.. _`#1245`: ​https://github.com/desihub/desispec/pull/1245 +.. _`DESI-5418`: https://desi.lbl.gov/DocDB/cgi-bin/private/ShowDocument?docid=5418 Required Header Keywords ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -260,53 +262,53 @@ Required Data Table Columns .. rst-class:: columns -============================ ======== ====== ================================================================================ -Name Type Units Description -============================ ======== ====== ================================================================================ -EXPID int64 DESI Exposure ID number -CUBE_INDEX int64 Integer frame counter within the guide cube; ``CUBE_INDEX`` increases with time within each guide cube; 0 for acquisition images; -1 for matched coadds -NIGHT int64 Night of observation (YYYYMMDD) starting at local noon before observations start -EXPTIME float64 s Exposure time; usually 5 seconds for guider frames, 15 seconds for acquisition images, and 5 seconds for matched coadds (average rather than sum) -FNAME_RAW char[76] Raw file name processed by ``gfa_reduce`` -SKYRA float64 deg Telescope bore sight RA taken from raw header metadata -SKYDEC float64 deg Telescope bore sight Dec taken from raw header metadata -PROGRAM char[88] DESI program type - BRIGHT, DARK, BACKUP, OTHER -MOON_ILLUMINATION float64 Moon illumination fraction (0 to 1) -MOON_ZD_DEG float64 deg Moon zenith distance in degrees -MOON_SEP_DEG float64 deg Moon angular separation in degrees relative to the observation's sky location -KTERM float32 Assumed r band k-term value in magnitudes per airmass; from DESI-5418 -FRACFLUX_NOMINAL_POINTSOURCE float32 Point source nominal fraction of light in 1.52 arcsec diameter fiber-like aperture -FRACFLUX_NOMINAL_ELG float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for an ELG-like profile (r_half = 0.45 arcsec exponential) -FRACFLUX_NOMINAL_BGS float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) -MJD float64 d Modified Julian Date when shutter was opened for this exposure -FWHM_ASEC float64 arcsec FWHM in arcseconds based on fitting the PSF with a beta = 3.5 Moffat profile -TRANSPARENCY float64 Transparency in r band; based on comparison against PS1 r magnitudes; zeropoints from DESI-5418; k-term given by ``KTERM`` column -SKY_MAG_AB float64 r band sky brightness measured from detrended GFA background levels; AB mag per square asec; zeropoints from DESI-5418 -FIBER_FRACFLUX float64 Point source fraction of light in 1.52 arcsec diameter aperture ASSUMING THE APERTURE IS PERFECTLY ALIGNED WITH THE PSF CENTROID -FIBER_FRACFLUX_ELG float64 Same as ``FIBER_FRACFLUX`` but for an ELG-like profile (r_half = 0.45 arcsec exponential) rather than a point source -FIBER_FRACFLUX_BGS float64 Same as ``FIBER_FRACFLUX`` but for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) rather than a point source -AIRMASS float64 Average airmass during this exposure -RADPROF_FWHM_ASEC float64 arcsec PSF FWHM in arcsec measured directly from the PSF radial profile -FIBERFAC float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a point source profile -FIBERFAC_ELG float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming an ELG-like profile (r_half = 0.45 arcsec exponential) -FIBERFAC_BGS float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) -MINCONTRAST float64 Minimum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras -MAXCONTRAST float64 Maximum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras -============================ ======== ====== ================================================================================ +============================ ======== ============= ================================================================================ +Name Type Units Description +============================ ======== ============= ================================================================================ +EXPID int64 DESI Exposure ID number +CUBE_INDEX int64 Integer frame counter within the guide cube; ``CUBE_INDEX`` increases with time within each guide cube; 0 for acquisition images; -1 for matched coadds +NIGHT int64 Night of observation (YYYYMMDD) starting at local noon before observations start +EXPTIME float64 s Exposure time; usually 5 seconds for guider frames, 15 seconds for acquisition images, and 5 seconds for matched coadds (average rather than sum) +FNAME_RAW char[76] Raw file name processed by ``gfa_reduce`` +SKYRA float64 deg Telescope bore sight RA taken from raw header metadata +SKYDEC float64 deg Telescope bore sight Dec taken from raw header metadata +PROGRAM char[88] DESI program type - BRIGHT, DARK, BACKUP, OTHER +MOON_ILLUMINATION float64 Moon illumination fraction (0 to 1) +MOON_ZD_DEG float64 deg Moon zenith distance in degrees +MOON_SEP_DEG float64 deg Moon angular separation in degrees relative to the observation's sky location +KTERM float32 Assumed r band k-term value in magnitudes per airmass; from `DESI-5418`_ +FRACFLUX_NOMINAL_POINTSOURCE float32 Point source nominal fraction of light in 1.52 arcsec diameter fiber-like aperture +FRACFLUX_NOMINAL_ELG float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for an ELG-like profile (r_half = 0.45 arcsec exponential) +FRACFLUX_NOMINAL_BGS float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) +MJD float64 d Modified Julian Date when shutter was opened for this exposure +FWHM_ASEC float64 arcsec FWHM in arcseconds based on fitting the PSF with a beta = 3.5 Moffat profile +TRANSPARENCY float64 Transparency in r band; based on comparison against PS1 r magnitudes; zeropoints from `DESI-5418`_; k-term given by ``KTERM`` column +SKY_MAG_AB float64 mag arcsec^-2 r band sky brightness measured from detrended GFA background levels; AB mag per square arcsec; zeropoints from `DESI-5418`_ +FIBER_FRACFLUX float64 Point source fraction of light in 1.52 arcsec diameter aperture ASSUMING THE APERTURE IS PERFECTLY ALIGNED WITH THE PSF CENTROID +FIBER_FRACFLUX_ELG float64 Same as ``FIBER_FRACFLUX`` but for an ELG-like profile (r_half = 0.45 arcsec exponential) rather than a point source +FIBER_FRACFLUX_BGS float64 Same as ``FIBER_FRACFLUX`` but for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) rather than a point source +AIRMASS float64 Average airmass during this exposure +RADPROF_FWHM_ASEC float64 arcsec PSF FWHM in arcsec measured directly from the PSF radial profile +FIBERFAC float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a point source profile +FIBERFAC_ELG float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming an ELG-like profile (r_half = 0.45 arcsec exponential) +FIBERFAC_BGS float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) +MINCONTRAST float64 Minimum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras +MAXCONTRAST float64 Maximum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras +============================ ======== ============= ================================================================================ HDU3 ---- -EXTNAME = EXTHDU3 +EXTNAME = EXPOSURE_SUMMARY_STRICT -This table aggregates information from ex=1 on a per-exposure basis by taking +This table aggregates information from ``CAMERA_SUMMARY`` on a per-exposure basis by taking the median across individual guide cameras, subject to some quality cuts applied -to ex=1 on a per-camera basis to remove potentially bad GFA measurements. These quality cuts are: +to ``CAMERA_SUMMARY`` on a per-camera basis to remove potentially bad GFA measurements. These quality cuts are: -* remove rows of ex=1 with ``min(MAX_Q1, MAX_Q2, MAX_Q3, MAX_Q4) = 0``. Having a maximum raw pixel value of zero in a quadrant indicates a major readout problem. -* remove rows of ex=1 with ``NPIX_BAD_TOTAL >= 10``, since this is indicative of insufficient denoising (bad A/D conversion). -* remove rows of ex=1 with ``N_SOURCES_FOR_PSF < 3``. -* remove rows of ex=1 with ``CONTRAST < 2 (CONTRAST < 1.85)`` in the case of acquisition images (matched coadds). The goal is to remove instances where gfa_reduce astrometry pattern matching failed. +* remove rows of ``CAMERA_SUMMARY`` with ``min(MAX_Q1, MAX_Q2, MAX_Q3, MAX_Q4) = 0``. Having a maximum raw pixel value of zero in a quadrant indicates a major readout problem. +* remove rows of ``CAMERA_SUMMARY`` with ``NPIX_BAD_TOTAL >= 10``, since this is indicative of insufficient denoising (bad A/D conversion). +* remove rows of ``CAMERA_SUMMARY`` with ``N_SOURCES_FOR_PSF < 3``. +* remove rows of ``CAMERA_SUMMARY`` with ``CONTRAST < 2 (CONTRAST < 1.85)`` in the case of acquisition images (matched coadds). The goal is to remove instances where ``gfa_reduce`` astrometry pattern matching failed. Required Header Keywords ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -327,39 +329,39 @@ Required Data Table Columns .. rst-class:: columns -============================ ======== ====== ================================================================================ -Name Type Units Description -============================ ======== ====== ================================================================================ -EXPID int64 DESI Exposure ID number -CUBE_INDEX int64 Integer frame counter within the guide cube; ``CUBE_INDEX`` increases with time within each guide cube; 0 for acquisition images; -1 for matched coadds -NIGHT int64 Night of observation (YYYYMMDD) starting at local noon before observations start -EXPTIME float64 s Exposure time; usually 5 seconds for guider frames, 15 seconds for acquisition images, and 5 seconds for matched coadds (average rather than sum) -FNAME_RAW char[76] Raw file name processed by ``gfa_reduce`` -SKYRA float64 deg Telescope bore sight RA taken from raw header metadata -SKYDEC float64 deg Telescope bore sight Dec taken from raw header metadata -PROGRAM char[88] DESI program type - BRIGHT, DARK, BACKUP, OTHER -MOON_ILLUMINATION float64 Moon illumination fraction (0 to 1) -MOON_ZD_DEG float64 deg Moon zenith distance in degrees -MOON_SEP_DEG float64 deg Moon angular separation in degrees relative to the observation's sky location -KTERM float32 Assumed r band k-term value in magnitudes per airmass; from DESI-5418 -FRACFLUX_NOMINAL_POINTSOURCE float32 Point source nominal fraction of light in 1.52 arcsec diameter fiber-like aperture -FRACFLUX_NOMINAL_ELG float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for an ELG-like profile (r_half = 0.45 arcsec exponential) -FRACFLUX_NOMINAL_BGS float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) -MJD float64 d Modified Julian Date when shutter was opened for this exposure -FWHM_ASEC float64 arcsec FWHM in arcseconds based on fitting the PSF with a beta = 3.5 Moffat profile -TRANSPARENCY float64 Transparency in r band; based on comparison against PS1 r magnitudes; zeropoints from DESI-5418; k-term given by ``KTERM`` column -SKY_MAG_AB float64 r band sky brightness measured from detrended GFA background levels; AB mag per square asec; zeropoints from DESI-5418 -FIBER_FRACFLUX float64 Point source fraction of light in 1.52 arcsec diameter aperture ASSUMING THE APERTURE IS PERFECTLY ALIGNED WITH THE PSF CENTROID -FIBER_FRACFLUX_ELG float64 Same as ``FIBER_FRACFLUX`` but for an ELG-like profile (r_half = 0.45 arcsec exponential) rather than a point source -FIBER_FRACFLUX_BGS float64 Same as ``FIBER_FRACFLUX`` but for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) rather than a point source -AIRMASS float64 Average airmass during this exposure -RADPROF_FWHM_ASEC float64 arcsec PSF FWHM in arcsec measured directly from the PSF radial profile -FIBERFAC float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a point source profile -FIBERFAC_ELG float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming an ELG-like profile (r_half = 0.45 arcsec exponential) -FIBERFAC_BGS float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) -MINCONTRAST float64 Minimum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras -MAXCONTRAST float64 Maximum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras -============================ ======== ====== ================================================================================ +============================ ======== ============= ================================================================================ +Name Type Units Description +============================ ======== ============= ================================================================================ +EXPID int64 DESI Exposure ID number +CUBE_INDEX int64 Integer frame counter within the guide cube; ``CUBE_INDEX`` increases with time within each guide cube; 0 for acquisition images; -1 for matched coadds +NIGHT int64 Night of observation (YYYYMMDD) starting at local noon before observations start +EXPTIME float64 s Exposure time; usually 5 seconds for guider frames, 15 seconds for acquisition images, and 5 seconds for matched coadds (average rather than sum) +FNAME_RAW char[76] Raw file name processed by ``gfa_reduce`` +SKYRA float64 deg Telescope bore sight RA taken from raw header metadata +SKYDEC float64 deg Telescope bore sight Dec taken from raw header metadata +PROGRAM char[88] DESI program type - BRIGHT, DARK, BACKUP, OTHER +MOON_ILLUMINATION float64 Moon illumination fraction (0 to 1) +MOON_ZD_DEG float64 deg Moon zenith distance in degrees +MOON_SEP_DEG float64 deg Moon angular separation in degrees relative to the observation's sky location +KTERM float32 Assumed r band k-term value in magnitudes per airmass; from `DESI-5418`_ +FRACFLUX_NOMINAL_POINTSOURCE float32 Point source nominal fraction of light in 1.52 arcsec diameter fiber-like aperture +FRACFLUX_NOMINAL_ELG float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for an ELG-like profile (r_half = 0.45 arcsec exponential) +FRACFLUX_NOMINAL_BGS float32 Nominal fraction of light in 1.52 arcsec diameter fiber-like aperture for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) +MJD float64 d Modified Julian Date when shutter was opened for this exposure +FWHM_ASEC float64 arcsec FWHM in arcseconds based on fitting the PSF with a beta = 3.5 Moffat profile +TRANSPARENCY float64 Transparency in r band; based on comparison against PS1 r magnitudes; zeropoints from `DESI-5418`_; k-term given by ``KTERM`` column +SKY_MAG_AB float64 mag arcsec^-2 r band sky brightness measured from detrended GFA background levels; AB mag per square asec; zeropoints from `DESI-5418`_ +FIBER_FRACFLUX float64 Point source fraction of light in 1.52 arcsec diameter aperture ASSUMING THE APERTURE IS PERFECTLY ALIGNED WITH THE PSF CENTROID +FIBER_FRACFLUX_ELG float64 Same as ``FIBER_FRACFLUX`` but for an ELG-like profile (r_half = 0.45 arcsec exponential) rather than a point source +FIBER_FRACFLUX_BGS float64 Same as ``FIBER_FRACFLUX`` but for a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) rather than a point source +AIRMASS float64 Average airmass during this exposure +RADPROF_FWHM_ASEC float64 arcsec PSF FWHM in arcsec measured directly from the PSF radial profile +FIBERFAC float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a point source profile +FIBERFAC_ELG float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming an ELG-like profile (r_half = 0.45 arcsec exponential) +FIBERFAC_BGS float64 PMGSTARS forced photometry amount of light in 1.52 arcsec diameter aperture normalized to nominal, assuming a BGS-like profile (r_half = 1.5 arcsec de Vaucouleurs) +MINCONTRAST float64 Minimum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras +MAXCONTRAST float64 Maximum ``gfa_reduce`` astrometric pattern matching contrast parameter among retained cameras +============================ ======== ============= ================================================================================ Notes and Examples diff --git a/doc/changes.rst b/doc/changes.rst index de561482..b5a7c157 100644 --- a/doc/changes.rst +++ b/doc/changes.rst @@ -2,15 +2,17 @@ desidatamodel Change Log ======================== -24.10 (unreleased) +24.12 (unreleased) ------------------ * 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`_). +* Add description of GFA summary files (PR `#202`_). .. _`#199`: https://github.com/desihub/desidatamodel/pull/199 .. _`#200`: https://github.com/desihub/desidatamodel/pull/200 +.. _`#202`: https://github.com/desihub/desidatamodel/pull/202 24.9 (2024-09-12) -----------------