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

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


Data Product Name
__________________
.. DataProductNameStart

DpdLE3edMatchedCatalog

.. DataProductNameEnd

Data Product Custodian
______________________
.. DataProductCustodianStart

ED

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

.. raw:: html 

    <a href="https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/9.2.0/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/le3/ed/euc-le3-ed-MatchedCatalog.xsd" target="_blank">euc-le3-ed-MatchedCatalog.xsd</a>

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

Processing Elements Creating / Updating / Using the Product
___________________________________________________________

.. PECreatorStart

**Creators:**

* LE3_MGC_ED

**Consumers:**

* LE3_MGC_ED

.. PECreatorEnd

Processing Function using the products
______________________________________

.. PFUsingStart

This product will not be used by any specific OU. It represent one of the latest steps of the Euclid pipeline.

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________
.. IncludeInSASStart

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.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

:Header: object of type sys:genericHeader
:Data: object of type ed:edMatchedCatalog
:QualityFlags: object of type dqc:sqfPlaceHolder
:Parameters: object of type ppr:genericKeyValueParameters

.. DataProductElementsEnd

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**

+--------+-----------+---+----------------------------------------+
| BITPIX |           | / | array data type                        |
+--------+-----------+---+----------------------------------------+
| EXTEND |           | / | This file may contain FITS extensions  |
+--------+-----------+---+----------------------------------------+
| NAXIS  |           | / | number of array dimensions             |
+--------+-----------+---+----------------------------------------+
| SIMPLE |           | / | conforms to FITS standard              |
+--------+-----------+---+----------------------------------------+
| END                                                             |
+--------+-----------+---+----------------------------------------+

**HDU Table**

+----------+----------------+---------------------------------------------+-----------+
| HDU *LE3_ED_MATCHED_CATALOG*                                                        |
+==========+================+=============================================+===========+
| 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    |
+----------+----------------+---------------------------------------------+-----------+
| 9 columns table                                                                     |
+----------+----------------+---------------------------------------------+-----------+
| Columns  | **EUC_ID**     | Unique ID from the Euclid Catalogue         | FITS *K*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EUC_RA**     | Right Ascension from the Euclid Catalogue   | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EUC_DEC**    | Declination from the Euclid Catalogue       | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EUC_Z**      | Redshift from the Euclid Catalogue          | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EXT_ID**     | Unique ID from the External Catalogue       | FITS *K*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EXT_RA**     | Right Ascension from the external Catalogue | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EXT_DEC**    | Declination from the external Catalogue     | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **EXT_Z**      | Redshift from the external Catalogue        | FITS *D*  |
+          +----------------+---------------------------------------------+-----------+
|          | **SEPARATION** | Separation between the sources              | 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