.. include:: ../wlsubstitutions.rst
.. _PF-2DMASS-WL-intro:

Introduction
============

From a OU-SHE/OU-PHZ catalogue DpdWLShearCatalog, 2D-MASS-WL will provide the following output products:

* :ref:`E/B modes on small patches <2DMassIntroConvergenceSmall>` (noisy maps, monte carlo maps, noise standard deviation maps, weighted density maps and the denoised maps).
* :ref:`E/B modes for the most massive clusters of the output cluster catalogue <2DMassIntroConvergenceClusters>` (noisy maps, noise standard deviation maps, weighted density maps and the denoised maps).
* :ref:`E/B modes on the full sky <2DMassIntroConvergenceSpherical>` (noisy maps, noise standard deviation maps, weighted density maps and the denoised maps).

..
    * :ref:`Peak catalogues <2DMassIntroPeak>` for statistical studies.
    * :ref:`MultiPatch E/B modes <2DMassIntroConvergenceMultiPatch>` for the “full” sky, with their associated STD maps, computed via decomposition of the sky into multiple patches for which convergence maps are computed.

.. _2DMassIntroConvergenceSmall:

E/B modes on small patches
++++++++++++++++++++++++++

For the production of convergence maps for small fields, an input DpdWLShearCatalog FITS catalogue collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters DpdTwoDMassParamsConvergencePatch specifying the location of the patches and running parameters. The noisy/denoised convergence maps and noise standard deviation maps are then obtained after projection of the input region, located on the sphere, and collected in DpdTwoDMassConvergencePatch.

.. image:: DPDD-2DMass-smallfield-test.png


.. _2DMassIntroConvergenceClusters:

E/B modes for cluster studies
+++++++++++++++++++++++++++++

For the production of convergence maps for clusters studies, a catalogue DpdLE3clDetClusters of optical clusters with centre position, radius and richness is used as input as well as a set of parameters DpdTwoDMassParamsConvergenceClusters and an input DpdWLShearCatalog FITS catalogue. The output product is a DpdTwoDMassConvergenceClusters containing FITS data arrays with as HDUs the noisy/denoised convergence maps, a map containing the total galaxy weight per pixel and a noise standard deviation map for a patch centred on each detected and sufficiently massive cluster.

.. image:: DPDD-2DMass-smallfield-clusters.png

.. _2DMassIntroConvergenceMultiPatch:

..
    Multi-Patch E/B convergence and STD maps
    ++++++++++++++++++++++++++++++++++++++++

    For large fields processed on the sphere (for statistical studies, to compute the catalogue of peaks), a first option is to perform multiple local Cartesian projections on the sky and estimate E/B modes on these patches.

    An input DpdWLPosShearCatalog FITS catalogue collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters DpdTwoDMassParamsConvergencePatchesToSphere defining in particular the patch characteristics, output HEALPix resolution and other running parameters. Potentially a footprint mask DpdTwoDMassVisibilityMask is also needed to define the decomposition of the sky. The output DpdTwoDMassConvergencePatchesToSphere collects as HEALPix maps the noisy/denoised convergence, number of galaxies per pixel, Monte Carlo realisations and STD maps.

    The input and output are described in:

    .. image:: DPDD-2DMass-widefield-patches.png


.. _2DMassIntroConvergenceSpherical:

E/B modes on the full sky
+++++++++++++++++++++++++

For the production of full-sky maps, an input DpdWLPosShearCatalog FITS catalogue collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters DpdTwoDMassParamsConvergenceSphere specifying the HEALPix resolution and other running parameters. The product DpdTwoDMassConvergenceSphere contains as products computed on the sphere (HEALPix maps) the noisy/denoised convergence maps, the total galaxy weight per pixel, Monte-Carlo realisations and noise standard deviation maps.

.. image:: DPDD-2DMass-widefield-spherical.png

.. _2DMassIntroPeak:

..
    Peak Catalogs
    +++++++++++++

    Finally, peak catalogues DpdTwoDMassPeakCatalog can be estimated for statistical studies. This is performed by detecting peaks either from aperture mass maps computed on the input catalogue (DpdWLPosShearCatalog) with parameters DpdTwoDMassParamsPeakCatalogMassAperture or from the wavelet decomposition of the convergence maps using parameters DpdTwoDMassParamsPeakCatalogConvergence, along with STD maps. A FITS keyword indicate which estimator has been used.

    .. image:: DPDD-2DMass-peakcatalog-patches.png

Inputs/outputs list
+++++++++++++++++++

**E/B modes on small patches**:

Inputs

* DpdTwoDMassParamsConvergencePatch
* DpdWLShearCatalog
* DpdHealpixVisibilityMaskVMPZ
* DpdTomographicBins

Outputs

* DpdTwoDMassConvergencePatch

**E/B modes for cluster studies**:

Inputs

* DpdTwoDMassParamsConvergenceClusters
* DpdWLShearCatalog
* DpdLE3clDetClusters
* DpdHealpixVisibilityMaskVMPZ
* DpdTomographicBins

Outputs

* DpdTwoDMassConvergenceClusters

..
    **Multi-Patch E/B convergence and STD maps**:

    Inputs

    * DpdTwoDMassParamsConvergencePatchesToSphere
    * DpdWLShearCatalog
    * DpdHealpixFootprintMaskVMPZ

    Outputs

    * DpdTwoDMassConvergencePatchesToSphere

**Spherical E/B modes**:

Inputs

* DpdTwoDMassParamsConvergenceSphere
* DpdWLShearCatalog
* DpdHealpixVisibilityMaskVMPZ
* DpdTomographicBins

Outputs

* DpdTwoDMassConvergenceSphere

..
    **Peak Catalogs (mass aperture)**:

    Inputs

    * DpdTwoDMassParamsPeakCatalogMassAperture
    * DpdWLProxyShearCatalog

    Outputs

    * DpdTwoDMassPeakCatalog

    **Peak Catalogs (convergence based)**:

    Inputs

    * DpdTwoDMassParamsPeakCatalogConvergence
    * DpdWLProxyShearCatalog

    Outputs

    * DpdTwoDMassPeakCatalog

Input products 2DMASS

* :ref:`twoDMassParams2DConvergencePatch`

* :ref:`twoDMassParams2DConvergenceClusters`

* :ref:`twoDMassParams2DConvergenceSphere`

..
    * :ref:`twoDMassParams2DConvergencePatchesToSphere`

    * :ref:`twoDMassParamsPeakCatalogMassAperture2D`

    * :ref:`twoDMassParamsPeakCatalogConvergence`

Output products 2DMASS

* :ref:`twoDMassConvergencePatch`

* :ref:`twoDMassConvergenceClusters`

* :ref:`twoDMassConvergenceSphere`

..
    * :ref:`twoDMassConvergencePatchesToSphere`

    * :ref:`twoDMassPeakCatalog`