.. include:: ../../clsubstitutions.txt
.. _combclClusters:

Clusters Detection Input Product
---------------------------------

Data product name
=================
.. DataProductNameStart

combclClusters

.. DataProductNameEnd

Data product custodian
======================
.. DataProductCustodianStart

DET-CL

.. DataProductCustodianEnd

Data model tag
==============
.. DataModelTagStart

|ML2A2BF|

.. DataModelTagEnd

Name of the Schema file
=======================
.. NameSchemaStart

|ML2A2BF|

.. NameSchemaEnd

Schema documentation tag
========================
.. SchemaDocTagStart

|ML2A2BF|

.. SchemaDocTagEnd

Data product elements
=====================
.. DataProductElementsStart

|ML2A2BF|

.. DataProductElementsEnd

Processing Element(s) creating/using the data product
=====================================================
.. PECreatorStart

DET-CL

.. PECreatorEnd

Processing function using the data product
==========================================
.. PFUsingStart

SGS pipeline output product to be used by SWGs

.. PFUsingEnd

Detailed description of the data product
========================================
.. DetailedDescStart

This data product contains the list and description of the detected clusters. It is the output product combcloutClusters from PF DET-CL.


Keywords
+++++++++++++

This fits file is expected to contain the following keywords in the primary HDU,
characterizing the main parameters of the "clusters detection" product.

KEYWORDS COMMON TO BOTH DETECTION CODES: GENERAL PARAMETERS


#. **DET_CODE**: Name of the detection algorithm (AMICO or PZWAV) (*)
#. **MIN_Z**: lower limit of redshift range for cluster detection
#. **MAX_Z**: upper limit of redshift range for cluster detection
#. **SNR_THR**: the S/N threshold for extracting a detection

KEYWORDS COMMON TO BOTH DETECTION CODES: COSMOLOGY PARAMETERS

#. **OMEGA_MAT**: matter energy density
#. **OMEGA_VAC**: vacuum energy density
#. **HUBBLE_PAR**: Hubble parameter in 100 Km/s/(Mpc/h)
#. **W_EQ_STATE**: dark energy equation of state
#. **N_EFF**: effective number of relativistic species
#. **TEMP_CMB**: CMB temperature

Currently, a flat LCDM model is assumed, depending only on HUBBLE_PAR and OMEGA_MAT. The list above allows a broader choice for the cosmological model (wCDM).

[*] NOTE: Depending on  detection algorithm (AMICO or PZWAV) which produced this data, some additional specific keywords would complete this list (see :ref:`detclPZWAVClusters` and ref:`detclAMICOClusters`). These specific keywords, though, are in principle not used by COMB-CL.


Table
+++++++++++++

The  table of the "combclClusters" product is expected to contain the following columns, for each detected cluster :


#. **CLUSTER_ID**: identifier number for the detected cluster
#. **RA**: right ascension and declination of the cluster center (degrees)
#. **DEC**: declination of the cluster center (degrees)
#. **Z**: cluster redshift estimate
#. **Z_ERR**:: error associated to the cluster redshift estimate
#. **SNR**: signal-to-noise ratio of the detection [*]
#. **RADIUS**: radius associated to the detection (arcmin) [*]
#. **RICHNESS**: absolute richness parameter (namely a redshift-independent quantity to be eventually used as a mass proxy) (*)

[*]: The SNR, RADIUS, and RICHNESS quantities may have different definitions depending on the considered detection code (keyword **DET_CODE**). The user should refer to the SDD and scientific documentation of the corresponding code. 

.. DetailedDescEnd