.. include:: ../../idsubstitutions.txt
.. _SELIDSubsampledCatalog:

SEL-ID Selected Catalog Product
================================


Data Product Name
__________________
.. DataProductNameStart

DpdLE3IDSELIDSubsampledCatalog

.. DataProductNameEnd

Data Product Custodian
_______________________
.. DataProductCustodianStart

IDSEL

.. 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/id/sel/out/euc-le3-id-sel-SubsampledCatalog.xsd" target="_blank">euc-le3-id-sel-SubsampledCatalog.xsd</a>

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

Processing Elements Creating / Updating / Using the Product
___________________________________________________________
.. PECreatorStart

**Creators:**

* SEL_Select

**Consumers:**

* LE3-GC-2PCF
* LE3-GC-PK
* LE3-GC-3PCF
* LE3-GC-BK
* SWG-GC

.. PECreatorEnd

Processing function using the data product
_____________________________________________
.. PFUsingStart

* LE3, SGS pipeline output product to be used by SWGs

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: yes

The catalog product is needed by the GC-SWG for verification and carrying out alternative science analyses.


.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

:Header: object of type sys:genericHeader
:Data: object of type selid:selIDSubsampledCatalog
:QualityFlags: object of type selid:selCatalogDqc
:Parameters: object of type ppr:genericKeyValueParameters

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This data product contains the selected Data or Random catalog for the spectroscopic galaxy clustering analyses.
It contains a minimal set of columns needed for the clustering analyses, namely the spatial coordinates and a weight.

Note that the Data and Random catalogs share the same data product definition.

This catalog is stored in a FITS file. The second HDU is a binary table extension that contains
metadata in the keywords and the catalog in the data table.

Metadata
++++++++
The metadata stored in the Data element of the XML contains useful information about the survey coverage. Here is a brief summary of the metadata:

**Data/**

+---------------------------+---------------------------+------------------------------------------------------------+
| Key                       | Type                      | Description                                                |
+===========================+===========================+============================================================+
| Area                      | float                     | Sky area covered by the catalog in deg2                    |
+---------------------------+---------------------------+------------------------------------------------------------+
| Concatenated              | str                       | Boolean flag to indicate if tile concatenation was done    |
+---------------------------+---------------------------+------------------------------------------------------------+
| SelectionID               | str                       | Selection identifier                                       |
+---------------------------+---------------------------+------------------------------------------------------------+
| SelectionName             | str                       | Selection name                                             |
+---------------------------+---------------------------+------------------------------------------------------------+
| CalblockIdList            | CalblockIdList            |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| Catalog                   | randomCatalogFile         | Pointer to the FITS data file.                             |
+---------------------------+---------------------------+------------------------------------------------------------+
| CatalogDescription        | CatalogDescription        |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| IslandLabelList           | IslandLabelList           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| ObservationIdList         | ObservationIdList         |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| PatchIdList               | PatchIdList               |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| RedshiftHistogram         | RedshiftHistogram         | Histogram of number density along line of sight            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpatialCoverage           | SpatialCoverage           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpectralCoverage          | SpectralCoverage          |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| TileIndexList             | TileIndexList             |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+

The `RedshiftHistogram` element contains the number density along the line of sight. It contains the following elements:

**Data/RedshiftHistogram/**

+---------------------+--------------+------------------------------------------------------------+
| Key                 | Type         | Description                                                |
+=====================+==============+============================================================+
| BinCount            | int          | Number of redshift bins                                    |
+---------------------+--------------+------------------------------------------------------------+
| CosmologyID         | str          | Cosmology identifier                                       |
+---------------------+--------------+------------------------------------------------------------+
| ComovingDensity     | ListOfDouble | Comoving number density in units (h/Mpc)3                  |
+---------------------+--------------+------------------------------------------------------------+
| CountdNdz           | ListOfDouble | Differential number count dN/dz in redshift bins           |
+---------------------+--------------+------------------------------------------------------------+
| RedshiftBinEdges    | ListOfDouble | Edges of redshift bins                                     |
+---------------------+--------------+------------------------------------------------------------+

Keywords Extension Header CATALOG
+++++++++++++++++++++++++++++++++++

This fits table is expected to contain the following keywords in primary HDU,
characterizing the parameters of the product:

+----------+------------+---+-----------------------------------------------+
| XTENSION |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| BITPIX   |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| NAXIS    |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| NAXIS1   |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| NAXIS2   |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| PCOUNT   |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| GCOUNT   |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| TFIELDS  |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| EXTNAME  |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| DATE     |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| CHECKSUM |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| DATASUM  |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| FILENAME |            | / |                                               |
+----------+------------+---+-----------------------------------------------+
| TELESCOP | EUCLID     | / | Identifiers Mission identifier                |
+----------+------------+---+-----------------------------------------------+
| INSTRUME | LE3IDSELID | / | PF identifier                                 |
+----------+------------+---+-----------------------------------------------+
| FILENAME |            | / | Name of fits                                  |
+----------+------------+---+-----------------------------------------------+
| CAT_MODE |            | / | DATA or RANDOM catalog                        |
+----------+------------+---+-----------------------------------------------+
| CAT_NAME |            | / | ID of Catalog                                 |
+----------+------------+---+-----------------------------------------------+
| CAT_NOBJ |            | / | Object Number of Catalog                      |
+----------+------------+---+-----------------------------------------------+
| COORD    | EQUATORIAL | / | coordinate type EQUATORIAL, CARTESIAN, ...    |
+----------+------------+---+-----------------------------------------------+
| ANGLE    | DEG        | / | angle type RAD or DEG                         |
+----------+------------+---+-----------------------------------------------+
| COMPLETE |            | / | completeness of the sample                    |
+----------+------------+---+-----------------------------------------------+
| PURITY   |            | / | purity of the sample                          |
+----------+------------+---+-----------------------------------------------+
| SELID    |            | / | Selection ID                                  |
+----------+------------+---+-----------------------------------------------+
| SELNAME  |            | / | Selection name                                |
+----------+------------+---+-----------------------------------------------+
| QUERY    |            | / | Selection query string                        |
+----------+------------+---+-----------------------------------------------+
| MSELID   |            | / | Main selection ID                             |
+----------+------------+---+-----------------------------------------------+
| MSELNAME |            | / | Main selection name                           |
+----------+------------+---+-----------------------------------------------+
| MQUERY   |            | / | Main selection query string                   |
+----------+------------+---+-----------------------------------------------+
| AREA     |            | / | sky area covered by catalog in square degree  |
+----------+------------+---+-----------------------------------------------+
| INFO1    |            | / | Placeholder parameter                         |
+----------+------------+---+-----------------------------------------------+
| INFO2    |            | / | Placeholder parameter                         |
+----------+------------+---+-----------------------------------------------+
| INFO3    |            | / | Placeholder parameter                         |
+----------+------------+---+-----------------------------------------------+
| INFO4    |            | / | Placeholder parameter                         |
+----------+------------+---+-----------------------------------------------+
| END                                                                       |
+----------+------------+---+-----------------------------------------------+


Table
+++++

The table is expected to contain the following columns:

+-----------------+---------------------------------------------------------------------------+---------------+
| Column name     | Description                                                               | Unit          |
+=================+===========================================================================+===============+
| OBJECT_ID       | Euclid unique source identifier                                           | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| RIGHT_ASCENSION | Source barycenter RA coordinate (SExtractor ALPHA_J2000) decimal degrees  | :math:`deg`   |
+-----------------+---------------------------------------------------------------------------+---------------+
| DECLINATION     | Source barycenter DEC coordinate (SExtractor DELTA_J2000) decimal degrees | :math:`deg`   |
+-----------------+---------------------------------------------------------------------------+---------------+
| SPE_Z           | The estimated spectroscopic redshift                                      | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| WEIGHT          | Weight generated by SEL                                                   | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| Z_TRUE          | True redshift for interlopers generated by VMSP                           | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| INTERLOPER_TYPE | Interloper type generated by VMSP                                         | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| FLAG            | Bit flag                                                                  | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| PARAM1          | Parameter 1                                                               | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+
| PARAM2          | Parameter 2                                                               | :math:`NA`    |
+-----------------+---------------------------------------------------------------------------+---------------+


.. DetailedDescEnd