rcal-846 Add mosaic info to the science products RTD page

CHANGES.rst

@@ -1,6 +1,12 @@
 0.15.2 (unreleased)
 ===================
 
+Documentation
+-------------
+
+- Update RTD to include mosaic data (i2d) description [#1262]
+
+
 general
 -------
 

docs/roman/associations/overview.rst

@@ -43,7 +43,7 @@ from the observatory telemetry into a ASDF file. At this point, the
 science exposures enter the calibration pipeline.
 
 The pipeline consists of the ELP (Exposure Level Processing) and
-the HLP (High Level Processing) which together comprise three levels of data generation and processing:
+the Mosaic Level Processing which together comprise three levels of data generation and processing:
 Level 1, Level 2, and Level 3. Level 1 data consist of uncalibrated individual
 exposures, containing raw pixel information, formatted into the shape of
 the detectors. Level 2 data have been  processed to correct for instrument artifacts and

docs/roman/data_products/science_products.rst

@@ -139,3 +139,39 @@ The calibrated products are the result of an average over all integrations (``ca
  - border_ref_pix_right: Copy of original border reference pixels, on right (from viewers perspective).
  - border_ref_pix_top: Copy of original border reference pixels, on the top (from viewers perspective).
  - border_ref_pix_bottom: Copy of original border reference pixels, on the bottom (from viewers perspective).
+
+
+Resampled 2-D data: ``i2d``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Images and spectra that have been resampled by the :ref:`resample <resample_step>` step use a
+different set of data arrays than other science products. Resampled 2-D images are stored in
+``i2d`` products.
+The ASDF structure for ``i2d`` products is as follows:
+
++----------------------+----------+------------+---------------------------+-------------------------------+
+| data array           |          | Data Type  | Units                     | Dimensions                    |
++======================+==========+============+===========================+===============================+
+|  data                | Required | float32    | MJy/steradian             |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  context             | Required | uint32     | N/A                       |  nplanes x nrows x ncols      |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  err                 | Required | float32    | MJy/steradian             |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  weight              | Required | float32    | N/A                       |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  var_poisson         | Required | float32    | (MJy/steradian)\ :sup:`2` |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  var_rnoise          | Required | float32    | (MJy/steradian)\ :sup:`2` |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+|  var_flat            | Required | float32    | (MJy/steradian)\ :sup:`2` |  nrows x ncols                |
++----------------------+----------+------------+---------------------------+-------------------------------+
+
+
+ - data: 2-D data array containing the pixel values, in units of surface brightness
+ - context: 3-D context image, which encodes information about which input images contribute
+   to a specific output pixel
+ - error: 2-D data array containing resampled uncertainty estimates, given as standard deviation
+ - weight: 2-D weight image giving the relative weight of the output pixels
+ - var_poisson: 2-D resampled Poisson variance estimates for each pixel
+ - var_rnoise: 2-D resampled read noise variance estimates for each pixel
+ - var_flat: 2-D resampled flat-field variance estimates for each pixel

docs/roman/pipeline/main.rst

@@ -15,7 +15,7 @@ processing:
   The details differ for imaging and spectroscopic exposures and can be found at :ref:`exposure_pipeline`.
 
 
-- The High Level Processing (HLP) uses overlapping exposures to match the sky background,
+- The Mosaic Level Processing (MLP) uses overlapping exposures to match the sky background,
   detect aberrant data values and resample the image to produce a single undistorted product.
   Details are at:  :ref:`mosaic_pipeline`