.. include:: ../../wlsubstitutions.rst
.. _WLLensMCCatalog:

Input Product: WL shear catalog
-------------------------------

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

WLLensMCCatalog

.. 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-LensMCCatalog.xsd

.. NameSchemaEnd

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

:emphasis:`Data product documentation:`

Data Product for WLLensMCCatalog.

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

Input LensMC shear catalogue for 2 point statistics, with information from SHE and 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:shearCatalogWL

Parameters of type: ppr:genericKeyValueParameters


.. DataProductElementsEnd

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

SHE, PHZ, 2PCF-WL, PK-WL

.. PECreatorEnd

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

LE3

.. PFUsingEnd

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

To compute the cosmic shear or galaxy-galaxy lensing 2-PCF,  one (auto-correlation) or
two (cross-correlation) input FITS catalogues with shear measurement are needed (see ``le3.wl.input.lensmccatalog`` in |XSD-FITS-WL|_).

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


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

#. **SHE_LENSMC_UPDATED_RA**: Right ascension (*unit in degree*) [D, float64]
#. **SHE_LENSMC_UPDATED_RA_CHAIN**: O(200) samples under pdf of g1 [PD(200), 200float64 at max]
#. **SHE_LENSMC_UPDATED_DEC**: Declination (*unit in degree*) [D, float64]
#. **SHE_LENSMC_UPDATED_DEC_CHAIN**: O(200) samples under pdf of g2 [PD(200), 200float64 at max]
#. **SHE_LENSMC_G1**: first component of ellipticity [E, float32]
#. **SHE_LENSMC_G1_CHAIN**: O(200) samples under pdf of g1 (subset of what is produced by OU-SHE) [PE(200), 200float32 at max]
#. **SHE_LENSMC_G2**: second component of ellipticity [E, float32]
#. **SHE_LENSMC_G2_CHAIN**: O(200) samples under pdf of g2 (subset of what is produced by OU-SHE) [PE(200), 200float32 at max]
#. **TOM_BIN_ID**: selection bin (labelling from PHZ using SWG prescriptions, based
   in particular on tomographic redshift) [J, int32]
#. **SHE_LENSMC_WEIGHT**: shear weight for the galaxy [E, float32]


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

   .. code-block:: XML

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

.. 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 :

      #. **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)

   Note that TOM_BIN_ID have replaced PHZ_MEDIAN.

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


.. DetailedDescEnd