.. include:: ../../clsubstitutions.txt
.. _selclComplete:

Completeness of clusters detection Output Product
==================================================


Data product name
__________________
.. DataProductNameStart

DpdLE3clSelCompleteness

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

Completeness is a necessary result output for analyzing the "Clusters" PFs detections. This is a product that will be used by the SWG.

.. IncludeInSASEnd

Data Product Elements
_______________________
.. DataProductElementsStart

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

.. DataProductElementsEnd

Detailed Description of the Data Product
__________________________________________
.. DetailedDescStart


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

The tables of the completeness and the associated errors appear in two distinct HDUs, with identical header content and identical table format.

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_TRUE_START**: Lower value of binning in Z_TRUE
- **Z_TRUE_END**: Upper value of binning in Z_TRUE
- **Z_TRUE_STEP**: Step value of binning in Z_TRUE
- **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_TRUE_START**: Lower value of binning in LAMBDA_TRUE
- **LAMBDA_TRUE_END**: Upper value of binning in LAMBDA_TRUE
- **LAMBDA_TRUE_STEP**: Step value of binning in LAMBDA_TRUE


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

- **COMP_LAMBDA_Z_TRUE** :  Completeness of cluster detection over the binning of (LAMBDA_TRUE, Z_TRUE)
from XML:

+----------+------------------------+-----------------------------------------------------------------------------+-----------+
| HDU *COMP_LAMBDA_Z_TRUE*                                                                                                    |
+==========+========================+=============================================================================+===========+
| 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  | **COMP_LAMBDA_Z_TRUE** | Completeness of cluster detection over the binning of (LAMBDA_TRUE, Z_TRUE) | FITS *D*  |
+----------+------------------------+-----------------------------------------------------------------------------+-----------+

*Second HDU:*

- **ERR_COMP_LAMBDA_Z_TRUE** :  Statistical error on completeness of cluster detection over the binning of (LAMBDA_TRUE, Z_TRUE)

from XML:

+----------+----------------------------+-----------------------------------------------------------------------------------------------------+-----------+
| HDU *ERR_COMP_LAMBDA_Z_TRUE*                                                                                                                            |
+==========+============================+=====================================================================================================+===========+
| 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_COMP_LAMBDA_Z_TRUE** | Statisticl error on the completeness of cluster detection over the binning of (LAMBDA_TRUE, Z_TRUE) | FITS *D*  |
+----------+----------------------------+-----------------------------------------------------------------------------------------------------+-----------+

.. DetailedDescEnd