.. include:: ../../edsubstitutions.txt
.. _MatchedCatalogmgc:

MGC Output Product
=====================

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | DpdLE3edMatchedCatalog                                                                       |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | ED                                                                                           |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | .. raw:: html                                                                                |
|                                                |                                                                                              |
|                                                | `euc-le3-ed-MatchedCatalog.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/10.1. |
|                                                | 2/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/le3/ed/euc-le3-ed-MatchedCatalog.xsd>`_               |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Last Edited for DPDD Version                   | 1.1                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  | **Creators:**                                                                                |
| product                                        |                                                                                              |
|                                                | * LE3_MGC_ED                                                                                 |
|                                                |                                                                                              |
|                                                | **Consumers:**                                                                               |
|                                                |                                                                                              |
|                                                | * LE3_MGC_ED                                                                                 |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | This product will not be used by any specific OU. It represent one of the latest steps of    |
|                                                | the Euclid pipeline.                                                                         |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Proposed for inclusion in EAS/SAS              | This product is proposed for inclusion in the EAS/SAS: Yes                                   |
|                                                |                                                                                              |
|                                                | This is one of the latest steps of the whole Euclid data analysis pipeline. This is the      |
|                                                | official cross-match between internal Euclid products and external survey. This is needed by |
|                                                | the community to cross-match the Euclid survey with complementary data.                      |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Data Product Elements
______________________
+--------------+----------------------------------------------+
| Header       | object of type sys:genericHeader             |
+--------------+----------------------------------------------+
| Data         | object of type ed:edMatchedCatalog           |
+--------------+----------------------------------------------+
| QualityFlags | object of type dqc:sqfPlaceHolder            |
+--------------+----------------------------------------------+
| Parameters   | object of type ppr:genericKeyValueParameters |
+--------------+----------------------------------------------+

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

Catalog of matches between sources detected by Euclid and sources detected by external experiments.

This product is an output from the LE3_MCC_ED PE

The main elements inside this product are:

* **EuclidCatalog**: name of the input Euclid catalog.
* **ExternalCatalog**: name of the input external catalog.
* **ConfigFile**: input configurazion file.
* **RaMin** : Analyzed region min RA
* **RaMax** : Analyzed region max RA
* **DecMin** : Analyzed region min DEC
* **DecMax** : Analyzed region max DEC
* **MatchedCatalog**: the output FITS file

The output FITS file contains the following columns:

**Primary Header**

.. table::
   :width: 100%

   +-------------------------------------------------------------------------+
   |                        **HDU** *PRIMARY*: header                        |
   +==========+==========+=======================================+===========+
   |          | **Name** |            **Description**            | **Value** |
   +----------+----------+---------------------------------------+-----------+
   | Keywords |  BITPIX  |            array data type            |  integer  |
   +          +----------+---------------------------------------+-----------+
   |          |  EXTEND  | This file may contain FITS extensions |  logical  |
   +          +----------+---------------------------------------+-----------+
   |          |  NAXIS   |       number of array dimensions      |  integer  |
   +          +----------+---------------------------------------+-----------+
   |          |  SIMPLE  |       conforms to FITS standard       |  logical  |
   +----------+----------+---------------------------------------+-----------+


**HDU Table**

.. table::
   :width: 100%

   +--------------------------------------------------------------------------------------------+
   |                          **HDU** *LE3_ED_MATCHED_CATALOG*: header                          |
   +==============+==============+===========================================+==================+
   |              |   **Name**   |              **Description**              |    **Value**     |
   +--------------+--------------+-------------------------------------------+------------------+
   |   Keywords   |    BITPIX    |              array data type              |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |   EXTNAME    |               extension name              |      string      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    GCOUNT    |              number of groups             |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    NAXIS     |         number of array dimensions        |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    NAXIS1    |           length of dimension 1           |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    NAXIS2    |           length of dimension 2           |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    OBJSEL    |                                           |     logical      |
   +              +--------------+-------------------------------------------+------------------+
   |              |    PCOUNT    |         number of group parameters        |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |   TFIELDS    |           number of table fields          |     integer      |
   +              +--------------+-------------------------------------------+------------------+
   |              |   XTENSION   |           binary table extension          |      string      |
   +--------------+--------------+-------------------------------------------+------------------+

.. table::
   :width: 100%

   +--------------------------------------------------------------------------------------------+
   |                     **HDU** *LE3_ED_MATCHED_CATALOG*: 9 columns table                      |
   +=========+============+=============================================+==========+============+
   |         |  **Name**  |               **Description**               | **Unit** | **Format** |
   +---------+------------+---------------------------------------------+----------+------------+
   | Columns |   EUC_ID   |     Unique ID from the Euclid Catalogue     |    NA    |  FITS *K*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |   EUC_RA   |  Right Ascension from the Euclid Catalogue  |   deg    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |  EUC_DEC   |    Declination from the Euclid Catalogue    |   deg    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |   EUC_Z    |      Redshift from the Euclid Catalogue     |    NA    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |   EXT_ID   |    Unique ID from the External Catalogue    |    NA    |  FITS *K*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |   EXT_RA   | Right Ascension from the external Catalogue |   deg    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |  EXT_DEC   |   Declination from the external Catalogue   |   deg    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         |   EXT_Z    |     Redshift from the external Catalogue    |    NA    |  FITS *D*  |
   +         +------------+---------------------------------------------+----------+------------+
   |         | SEPARATION |        Separation between the sources       |   deg    |  FITS *D*  |
   +---------+------------+---------------------------------------------+----------+------------+


.. warning:: The following keyword is not displaying the complete rows from the ST_FitsDataModel.

   .. code-block:: rst

         $PrintHDUTableContents fit/euc-le3-ed.xml le3.ed.matchedcatalog LE3_ED_MATCHED_CATALOG


.. DetailedDescEnd