Merge pull request #141 from desihub/spectra-111

intermediate update to tile redshift files
desihub · Feb 10, 2023 · 7568b28 · 7568b28
2 parents bda37f4 + 5c8ae0b
commit 7568b28
Show file tree

Hide file tree

Showing 8 changed files with 437 additions and 290 deletions.
diff --git a/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures/NIGHT/EXPID/cframe-CAMERA-EXPID.rst b/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures/NIGHT/EXPID/cframe-CAMERA-EXPID.rst
@@ -23,7 +23,7 @@ HDU2_  MASK       IMAGE    Mask (0 = good)
 HDU3_  WAVELENGTH IMAGE    wavelength in Angstrom
 HDU4_  RESOLUTION IMAGE    Resolution Matrix
 HDU5_  FIBERMAP   BINTABLE Fibermap
-HDU6_  CHI2PIX    IMAGE    chi2 fit of PSF model to CCD image
+HDU6_  CHI2PIX    IMAGE    chi2 of fit of PSF model to CCD image
 HDU7_  SCORES     BINTABLE Quality Assurance scores
 ====== ========== ======== ======================================
 
@@ -644,8 +644,6 @@ EXTNAME = MASK
 Mask of spectral data; 0=good. See the :doc:`bitmask documentation </bitmasks>` page for the definition of the bits.
 Prior to desispec/0.24.0 and software release 18.9, the MASK HDU was compressed.
 
-TODO: add documentation link to what bits mean what.
-
 Required Header Keywords
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -696,7 +694,8 @@ HDU4
 
 EXTNAME = RESOLUTION
 
-Resolution matrix stored as a 3D sparse matrix. the frame :ref:`RESOLUTION documentation <frame-hdu4-resolution>` for more details.
+Resolution matrix stored as a 3D sparse matrix.
+See the frame :ref:`RESOLUTION documentation <frame-hdu4-resolution>` for more details.
 
 
 Required Header Keywords
@@ -1491,8 +1490,6 @@ have the complete set of ``_C`` columns where ``_C`` (for camera) represents
 SCORES tables from individual frames can be later combined into a summary
 table for the exposure.
 
-TODO: document wavelength ranges covered per camera.
-
 .. rst-class:: columns
 
 ========================== ======= ===== ============================================
@@ -1563,4 +1560,4 @@ TSNR2_ELG_R [1]_           float64       from calc_frame_tsnr
 Notes and Examples
 ==================
 
-*Add notes and examples here.  You can also create links to example files.*
+TODO
diff --git a/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures/NIGHT/EXPID/frame-CAMERA-EXPID.rst b/doc/DESI_SPECTRO_REDUX/SPECPROD/exposures/NIGHT/EXPID/frame-CAMERA-EXPID.rst
@@ -20,7 +20,7 @@ HDU0_  FLUX       IMAGE    Extracted flux in electrons per Angstrom
 HDU1_  IVAR       IMAGE    Inverse variance of the extracted flux
 HDU2_  MASK       IMAGE    Bad value mask; 0=good
 HDU3_  WAVELENGTH IMAGE    Wavelength grid of the extraction (Angstrom)
-HDU3_  RESOLUTION IMAGE    Resolution matrix
+HDU4_  RESOLUTION IMAGE    Resolution matrix
 HDU5_  FIBERMAP   BINTABLE Fibermap
 HDU6_  CHI2PIX    IMAGE    chi2 of PSF fit to CCD pixels
 ====== ========== ======== ===================
@@ -695,7 +695,7 @@ HDU4
 
 EXTNAME = RESOLUTION
 
-Resolution matrix stored as a 3D sparse matrix:
+Resolution matrix stored as the diagonals of a 3D sparse matrix:
 
 Rdata[nspec, ndiag, nwave]
 

diff --git a/...X/SPECPROD/tiles/GROUPTYPE/TILEID/GROUPID/coadd-SPECTROGRAPH-TILEID-GROUPID.rst b/...X/SPECPROD/tiles/GROUPTYPE/TILEID/GROUPID/coadd-SPECTROGRAPH-TILEID-GROUPID.rst
diff --git a/doc/DESI_SPECTRO_REDUX/SPECPROD/tiles/GROUPTYPE/TILEID/GROUPID/index.rst b/doc/DESI_SPECTRO_REDUX/SPECPROD/tiles/GROUPTYPE/TILEID/GROUPID/index.rst
@@ -2,16 +2,12 @@
 GROUPID
 =======
 
-During commissioning and survey validation, per-tile spectra, coadds, and redshifts
-are grouped in ``tiles/GROUPTYPE/TILEID/GROUPID``.
+Per-tile spectra, coadds, and redshifts
+are grouped in ``tiles/GROUPTYPE/TILEID/GROUPID``;
+See the :doc:`top-level tiles/ description <../../../index>` for an overview
+of the GROUPTYPE and GROUPID options.
 
-The ``GROUPID`` depends on the ``GROUPTYPE``.
-
-* For ``[14]x_depth`` coadds, the ``GROUPID`` is the subset number.
-* For ``cumulative`` coadds, the ``GROUPID`` is the last ``NIGHT`` in the set
-  of nights being coadded.
-* For ``perexp`` coadds, the ``GROUPID`` is simply the ``EXPID``.
-* For ``pernight`` coadds, the ``GROUPID`` is simply the ``NIGHT``.
+Files in tiles/GROUPTYPE/TILEID/GROUPID:
 
 .. toctree::
    :maxdepth: 1