.. _PHZBiasCorrectionMap:

Photometric redshift bias correction map product
==================================================

$SetSchemaPath phz/euc-test-phz-BiasCorrectionMap.xsd

Data Product Name
__________________
.. DataProductNameStart

$PrintDataProductName

.. DataProductNameEnd

Data Product Custodian
________________________
.. DataProductCustodianStart

$PrintDataProductCustodian

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

$PrintSchemaFilename

.. NameSchemaEnd

Data Product Elements
______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Schema documentation tag
_________________________
.. SchemaDocTagStart

:emphasis:`Documentation for data product element dpdBiasCorrectionMap:`

This product contains the bias corrections to be applied to the photometric
redshift PDZs. The bias is providen for each SOM cell.

:emphasis:`Documentation for data product element Header:`

The generic header of the product.
.. SchemaDocTagEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

The bias correction is dependent on the weak lensing weight computation, so this
product contains a **WeakLensingWeightMethod** element which specify the method name
and a FITS binary table containing the bias correction to be
applied to the PDZs produced by PHZ PF.
The product contains also a **TileIndexList** which keep track of all the tiles to which
belong the sources used to compute the bias correction.

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

* This product is one final product of the PHZ bias correction
pipeline. It is used to compute the tomographic bin mean photo Z and correct bias in PHZ.

.. PECreatorEnd

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

* PHZ PF output product. To be used by L3

.. PFUsingEnd

The table is expected to follow the
format described by the phz.biasCorrectionMap version 0.1 description, which
defines the following columns:

#. **BIAS_ID**: The bias correction identifier
#. **CORRECTION**: The shift to apply to the PDZs of all objects having this bias identifier

and has a header keyword: **WLMETHOD** containing again the name of the weak
lensing weight computation method.

The consumers of this product should use the value of the **BIAS_ID**
column of the Photometric Redshift Catalog product to retrieve the correct shift
value from this map, to apply the bias correction.

.. DetailedDescEnd