.. _MERAnalysisResult:


Analysis Result Product
=======================

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | DpdMerAnalysisResult                                                                         |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | MER                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | .. raw:: html                                                                                |
|                                                |                                                                                              |
|                                                | `euc-mer-AnalysisResult.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/10.1.2/S |
|                                                | T_DM_Schema/auxdir/ST_DM_Schema/dpd/mer/euc-mer-AnalysisResult.xsd>`_                        |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Last Edited for DPDD Version                   | 2.0                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  | **Creators:**                                                                                |
| product                                        |                                                                                              |
|                                                | * MER_Validation                                                                             |
|                                                |                                                                                              |
|                                                | **Consumers:**                                                                               |
|                                                |                                                                                              |
|                                                | * MER_Validation                                                                             |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | MER                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Proposed for inclusion in EAS/SAS              | This product is proposed for inclusion in the SAS: maybe.                                    |
|                                                |                                                                                              |
|                                                | The product summarizes the validation analysis of the MER output products                    |
|                                                | associated to a given pipeline run. Scientist might find it useful to evaluate               |
|                                                | the quality of the associated MER products.                                                  |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Data Product Elements
_____________________
+--------------+----------------------------------------------+
| Header       | object of type sys:genericHeader             |
+--------------+----------------------------------------------+
| Data         | object of type mer:merAnalysisResult         |
+--------------+----------------------------------------------+
| QualityFlags | object of type dqc:sqfPlaceHolder            |
+--------------+----------------------------------------------+
| Parameters   | object of type ppr:genericKeyValueParameters |
+--------------+----------------------------------------------+


Detailed Description of the Data Product
________________________________________
.. DetailedDescStart

Analysis result product associated with a given MER :term:`Pipeline` run.
This product collects all the results from the MER analysis pipeline.

The analysis report contains information about the mosaics depths, source
detection statistics, the catalog astrometric and photometric accuracy, as
well as many useful figures displaying different source morphological
parameters, the mosaic PSFs and the star-galaxy classification and background
subtraction results.

The report content changes depending of the reference catalog that is
passed as input to the analysis pipeline (e.g. a
:ref:`MER True Universe star catalog <MERTrueUniverseStarCatalog>` or 
an :ref:`EXT Gaia cutout catalog <EXTExtGaiaCutout>`).

The main elements inside this product are:

* **Result**: The global analysis result (PASSED or FAILED).
* **TileIndex**: The MER tile index.
* **PatchIdList**: The sky patch ids associated to the product.
* **ObservationIdList**: List of unique IDs identifying the Euclid observations
  that were used to generate the product.
* **CalblockIdList**: The calibration block ids associated to the product.
* **CalblockVariantList**: The calibration block variants associated to the
  product.
* **ProcessingMode**: The MER pipeline processing mode (e.g. WIDE, DEEP) used to
  generate the product.
* **InputProductsPPOId**: The Id of the PPO that generated the products that
  have been analyzed.
* **AnalysisFiles**: Element that links to the tar file containing the analysis
  figures and reports.

.. DetailedDescEnd