.. include:: ../../clsubstitutions.txt
.. _selclPurity:

Purity of clusters detection Output Product (TBC)
==================================================


Data Product Name
__________________
.. DataProductNameStart

DpdLE3clSelPurity

.. DataProductNameEnd

Data Product Custodian
_______________________
.. DataProductCustodianStart

CLSEL

.. 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/cl/euc-le3-cl-sel-purity.xsd" target="_blank">euc-le3-cl-sel-purity.xsd</a>

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

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

**Creators:**

* SelectionFunction

**Consumers**

* Random

.. PECreatorEnd

Processing Function using the products
________________________________________
.. PFUsingStart

* SEL-CL
* 2PCF-CL
* SWG-CL
* Cosmological Pipeline

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: Yes

Purity is a necessary result output for analyzing the "Clusters" PFs detections.

.. IncludeInSASEnd

Data Product Elements
_______________________
.. DataProductElementsStart

:Header: object of type sys:genericHeader
:Data: object of type cl:selPurity
:QualityFlags: object of type dqc:sqfPlaceHolder
:Parameters: object of type ppr:genericKeyValueParameters

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This data product (TBC!) gives the purity of the clusters detection as a function of richness LAMBDA_OBS and a redshift Z_OBS, and the associated statistical error. These quantities result, for each (LAMBDA_OBS, Z_OBS) bin, from the integration of PROB_LAMBDA_Z_OBS_TRUE and its errors, defined in "Probability of Cluster Detection Output Product".

These two datasets appear in two distinct HDUs, with identical header content.

Keywords
++++++++

- **Z_KEY**: Name of the redshift column used for the subsample
- **RICHNESS_KEY**: Name of the richness column (i.e. LAMBDA) used for the subsample
- **Z_OBS_START**: Lower value of binning in Z_OBS
- **Z_OBS_END**: Upper value of binning in Z_OBS
- **Z_OBS_STEP**: Step value of binning in Z_OBS
- **LAMBDA_OBS_START**: Lower value of binning in LAMBDA_OBS
- **LAMBDA_OBS_END**: Upper value of binning in LAMBDA_OBS
- **LAMBDA_OBS_STEP**: Step value of binning in LAMBDA_OBS


Tables
++++++
*First HDU:*

- **PURE_LAMBDA_Z_OBS** :  Purity of cluster detection over the binning of (LAMBDA_OBS, Z_OBS)

from XML:

+----------+-----------------------+---------------------------------------------------------------------+-----------+
| HDU *PURE_LAMBDA_Z_OBS_OBS*                                                                                        |
+==========+=======================+=====================================================================+===========+
| Keywords | **XTENSION**          |                                                                     | string    |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **BITPIX**            |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **NAXIS**             |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **NAXIS1**            |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **NAXIS2**            |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **PCOUNT**            |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **GCOUNT**            |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **TFIELDS**           |                                                                     | integer   |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **TTYPE1**            |                                                                     | string    |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **TFORM1**            |                                                                     | string    |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **EXTNAME**           |                                                                     | string    |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **CHECKSUM**          |                                                                     | string    |
+          +-----------------------+---------------------------------------------------------------------+-----------+
|          | **DATASUM**           |                                                                     | string    |
+----------+-----------------------+---------------------------------------------------------------------+-----------+
| 1 columns table                                                                                                    |
+----------+-----------------------+---------------------------------------------------------------------+-----------+
| Columns  | **PURE_LAMBDA_Z_OBS** | Purity of cluster detection over the binning of (LAMBDA_OBS, Z_OBS) | FITS *D*  |
+----------+-----------------------+---------------------------------------------------------------------+-----------+


*Second HDU:*

- **ERR_PURE_LAMBDA_Z_OBS** :  Statistical error on Purity of cluster detection over the binning of (LAMBDA_OBS, Z_OBS)

from XML:

+----------+---------------------------+---------------------------------------------------------------------------------------------+-----------+
| HDU *ERR_PURE_LAMBDA_Z_OBS_OBS*                                                                                                                |
+==========+===========================+=============================================================================================+===========+
| Keywords | **XTENSION**              |                                                                                             | string    |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **BITPIX**                |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **NAXIS**                 |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **NAXIS1**                |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **NAXIS2**                |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **PCOUNT**                |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **GCOUNT**                |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **TFIELDS**               |                                                                                             | integer   |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **TTYPE1**                |                                                                                             | string    |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **TFORM1**                |                                                                                             | string    |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **EXTNAME**               |                                                                                             | string    |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **CHECKSUM**              |                                                                                             | string    |
+          +---------------------------+---------------------------------------------------------------------------------------------+-----------+
|          | **DATASUM**               |                                                                                             | string    |
+----------+---------------------------+---------------------------------------------------------------------------------------------+-----------+
| 1 columns table                                                                                                                                |
+----------+---------------------------+---------------------------------------------------------------------------------------------+-----------+
| Columns  | **ERR_PURE_LAMBDA_Z_OBS** | Statisticl error on the purity of cluster detection over the binning of (LAMBDA_OBS, Z_OBS) | FITS *D*  |
+----------+---------------------------+---------------------------------------------------------------------------------------------+-----------+

.. DetailedDescEnd