.. _DESCalibratedFrame:

Calibrated Frame Product
------------------------

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | `DpdExtDesCalibratedFrame <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/blob/9.0.2/ST_DM_ |
|                                                | Schema/auxdir/ST_DM_Schema/dpd/ext/des/euc-test-ext-des-CalibratedFrame.xsd#L20-26>`__       |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | `OU-EXT <https://euclid.roe.ac.uk/projects/sgu/wiki>`_                                       |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | `euc-test-ext-des-CalibratedFrame.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/blob/ |
|                                                | 9.0.2/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/ext/des/euc-test-ext-des-CalibratedFrame.xsd>`__  |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  |                                                                                              |
| product                                        |                                                                                              |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | EXT-DES, MER                                                                                 |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Detailed description of the data product
========================================
.. DetailedDescStart

Also known as **single epoch image** in DES terminology. This product is the result of
applying the DES *single epoch* pipeline to a DES :ref:`DESRawFrame` (science 
exposure). It contains the single epoch dataset of a single CCD.

The main elements inside this product are:

* **Instrument**: The instrument name (DECam) and telescope name (NOAO).
* **Filter**: The DECam filter name (DECAM_g, DECAM_r, DECAM_i, DECAM_z or DECAM_Y).
* **WCS**: The image astrometric parameters with linear (e.g., CTYPE1, CRVAL2, CRPIX1,
  CD1_1) and, optionally, non linear terms (PV1_0, PV2_0, ...).
* **ZeroPoint**: The photometric reference zero point in magnitude units.
* **ImgSpatialFootprint** (optional): The spatial footprint of the image either in a 
  serie of vertex or a bounding box.
* **Masks** (optional): Euclid bit masks present in the flag image dataset.
* **Observation**: Contains information about the telescope pointing (Telra, Teldec, 
  HourAngle, ZenithDistance, Epoch), the observation night and date, and the optical 
  air mass.
* **Saturate**: Global saturation threshold valid for amplifiers A and B.
* **Object**: The survey object name. For example, 
  *DES survey hex 906-339 tiling 8, Field 74*.
* **CCDNumber**: The DECam science CCD number (1 to 62).
* **Scamp**: Information about the Scamp processing.
* **DataStorage**: Element that links to a FITS file containing the CCD single epoch 
  image, flag and weight datasets.
* **PsfModelStorage**: Element that links to a FITS file containing the frame PSF model.
* **BackgroundStorage** (optional): Element that links to a FITS file containing the 
  background model.
* **RunInformation**: Information about the processing run (Project and RunNumber).
* **ProcessingSteps** (optional): Information about the processing steps associated
  with the *single epoch* process.

.. include:: ../../fit/fit.ext.des.singleEpochImage.rst

.. DetailedDescEnd