.. include:: ../../wlsubstitutions.rst
.. _WLPosCatalog:

Input Product: WL position catalog
-----------------------------------

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

WLPosCatalog

.. DataProductNameEnd

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

2PCF-WL, PK-WL

.. DataProductCustodianEnd

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

|WLDMTAG|

.. DataModelTagEnd

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

euc-test-le3-wl-PosCatalog.xsd

.. NameSchemaEnd

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

:emphasis:`Data product documentation:`

Data Product for WLPosCatalog.

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

Input position catalogue for 2PCF-WL, with information from MER/PHZ.

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

The generic header of the product

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

The data of the product


.. SchemaDocTagEnd

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

Header of type: sys:genericHeader

Data of type: wl:posCatalogWL

Parameters of type: ppr:genericKeyValueParameters


.. DataProductElementsEnd

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

MER, PHZ, 2PCF-WL

.. PECreatorEnd

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

LE3

.. PFUsingEnd

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

To compute the 2 point statistics position-position (aka angular) or shear-position (aka galaxy-galaxy lensing),
an input FITS catalogs with position of lenses is needed (see ``le3.wl.2pcf.input.poscatalog`` in |XSD-FITS-WL|_).
This catalog can be the same as for the sources, or optionally (as described here) a separate catalogues
with a different selection.

FITS Input Catalog
++++++++++++++++++

This fits catalog (coming from OU-SHE/OU-PHZ) is expected to contain (in hdu named "POS_CATALOG") the following columns:

#. **RIGHT_ASCENSION**: Right ascension (*unit in degree*) [D, float64]
#. **DECLINATION**: Declination (*unit in degree*) [D, float64]
#. **TOM_BIN_ID**: selection bin (labelling from PHZ using SWG prescriptions, based
   in particular on tomographic redshift) [J, int32]

.. warning:: The following columns for selection have been discussed by SWG WL
   but no agreement yet with PHZ PF that is expected to produce them :

      #. **Z_BIN**: tomographic redshift bin (labelling from PHZ using SWG prescriptions)
      #. **RF_COLOUR_BIN**: Bin in Rest-frame colour (labelling from PHZ using SWG prescriptions)
      #. **MASS_BIN**: Bin in stellar mass (labelling from PHZ using SWG prescriptions)
      #. **APP_MAG_BIN**: Bin according to apparent magnitude (labelling from PHZ using SWG prescriptions)
      #. **REDMAG_BIN**: redmagic-like selection from PHZ (luminous red galaxies,labelling from PHZ using SWG prescriptions)
      #. **FITCLASS**: star/galaxy separation from SHE : galaxy (0), star(1), unknown (2)
      #. **WEIGHT**: weight associated to the galaxy [E, float32]

      Note that TOM_BIN_ID have replaced PHZ_MEDIAN.

.. warning:: This input catalogue is a catalog container, containing in particular
   an associated spatial footprint propagated to outputs.

.. warning:: We have discussed to add later in the main header

   .. code-block:: XML

         <IntegerKeyword name="POS_SEL"/> <!-- ID of selection made (e.g. tomographic redshifts, stellar mass…) -->


.. DetailedDescEnd