.. include:: ../../clsubstitutions.txt
.. _richclCalibration:

RICH-CL Calibration Product
=============================

$SetSchemaPath le3/cl/euc-le3-cl-richcl-calib.xsd

Data Product Name
__________________
.. DataProductNameStart

$PrintDataProductName

.. DataProductNameEnd

Data Product Custodian
______________________
.. DataProductCustodianStart

$PrintDataProductCustodian

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

$PrintSchemaFilename

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

Processing Elements Creating / Updating / Using the Product
___________________________________________________________

.. PECreatorStart

**Creators:**

* LE3_RICH_CL


**Consumers:**

* LE3_RICH_CL

.. PECreatorEnd


Processing Function using the products
______________________________________

.. PFUsingStart

* RICH-CL
* SWG CL

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: yes

Looking at the past calibration products is necessary both on technical and scientific points of views.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This product contains the calibration file issued from the preliminary stage of RICH-CL, and used for either the current or further executions of RICH-CL. It is therefore both an output and an input product of RICH-CL. It has two tables which contain the results of, respectively; the calibration in color (COLOR_CORRECTION) and the calibration in magnitude (MAGNITUDE_CORRECTION, not yet implemented).

This data product contains, for different bins of redshift, the corrections in color and in magnitude which are to be applied for a fine estimate of RICH-CL outputs.

Primary HDU: Keywords
+++++++++++++++++++++

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

#. **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
#. **AREA**: Area on which the calibration was performed [deg**2]
#. **REFERENCE_AREA** A reference to the sky patch on which the calibration was performed



Table: COLOR_CORRECTION
+++++++++++++++++++++++

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

#. **DELTA_Z_BIN**: Width of each redshift bin used for the color correction. Might be NaN if this value is not constant (i.e. if z-dependent), in which case MIN_Z and COLOR_CORRECTION_Z should be used to reconstruct each interval of redshift bin.

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

+-------------------------------+---------------------------------------------------------------------------------+----------------------+
| Column name                   | Description                                                                     | Unit                 |
+===============================+=================================================================================+======================+
| **COLOR_CORRECTION_Z**      	| Center of the redshift bin            		                          |                      |
+-------------------------------+---------------------------------------------------------------------------------+----------------------+
| **COLOR_CORRECTION**	        | Color correction to be applied in that redshift bin  		                  |                      |
+-------------------------------+---------------------------------------------------------------------------------+----------------------+

Table: MAGNITUDE_CORRECTION
+++++++++++++++++++++++

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

#. **DELTA_Z_BIN**: Width of each redshift bin used for the magnitude correction. Might be NaN if this value is not constant (i.e. if z-dependent), in which case MIN_Z and MAGNITUDE_CORRECTION_Z should be used to reconstruct each interval of redshift bin.

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

+-------------------------------+---------------------------------------------------------------------------------+----------------------+
| Column name                   | Description                                                                     | Unit                 |
+===============================+=================================================================================+======================+
| **MAGNITUDE_CORRECTION_Z**    | Center of the redshift bin 	                                                  |                      |
+-------------------------------+---------------------------------------------------------------------------------+----------------------+
| **MAGNITUDE_CORRECTION**      | Magnitude correction to be applied in that redshift bin                         |                      |
+-------------------------------+---------------------------------------------------------------------------------+----------------------+

.. DetailedDescEnd