|badge1| |badge2| |badge3|

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

From a OU-SHE/OU-PHZ catalogue :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`
(or :ref:`momentsMLCatalog2DMassWL <momentsMLCatalog2DMassWL>`,
or :ref:`regaussCatalog2DMassWL <regaussCatalog2DMassWL>`,
or :ref:`kSBCatalog2DMassWL <kSBCatalog2DMassWL>`), 2D-MASS-WL
will provide the following output products:

* :ref:`E/B modes <2DMassIntroConvergenceSmall>` for small patches, noisy and/or
  denoised, with their  associated SNR maps,
* :ref:`E/B modes for a single cluster <2DMassIntroConvergenceClusters>`,
  noisy and/or denoised, with associated SNR maps, also collected in a single tar
  for all sufficiently massive clusters in a catalogue
* :ref:`MultiPatch E/B modes <2DMassIntroConvergenceMultiPatch>` for the "full"
  sky, with their associated SNR maps, computed via decomposition of the sky into
  multiple patches for which convergence maps are computed,
* :ref:`Spherical E/B modes <2DMassIntroConvergenceSpherical>` for the "full" sky,
  with their associated SNR maps;  an alternative is based on
  `Spherical E/B convergence maps <2DMassIntroConvergenceSpherical>`,
* :ref:`Peak catalogues <2DMassIntroPeak>` for statistical studies.

.. _2DMassIntroConvergenceSmall:

E/B modes and SNR maps for tests (small patches)
++++++++++++++++++++++++++++++++++++++++++++++++

To test the production of convergence maps for small fields (for object studies
such as cluster), an input FITS catalogue (e.g :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`)
collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters
:ref:`twoDMassParams2DConvergencePatch <twoDMassParams2DConvergencePatch>` (for
convergence maps) specifying the location of the patches and running parameters.
The noisy/denoised convergence maps and SNR products are then obtained after projection
of the input region, located on the sphere, and collected in
:ref:`twoDMassConvergencePatch <twoDMassConvergencePatch>`.

The flowchart is the following:

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


.. _2DMassIntroConvergenceClusters:

E/B modes and SNR maps for cluster studies
++++++++++++++++++++++++++++++++++++++++++

A catalogue :ref:`clustercatalog2DMassWL <clustercatalog2DMassWL>` of optical clusters
with centre position, radius and richness is used as input as well as a set of parameters
:ref:`twoDMassParams2DConvergenceClusters <twoDMassParams2DConvergenceClusters>`
and an input FITS catalogue (e.g. :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`).
The output product is a tar file :ref:`twoDMassConvergenceClusters <twoDMassConvergenceClusters>`
containing FITS data arrays with as HDUs the noisy/denoised convergence maps, a map
containing the number of galaxies per pixel and SNR maps for a patch centered on each detected
(and sufficiently massive) cluster. This tar is associated to the name of the catalogue
processed to ease further joint processing.
A single product for a given cluster :ref:`twoDMassConvergenceSingleCluster <twoDMassConvergenceSingleCluster>`
can also be obtained (with same FITS structure as collected in the tar file)

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

.. _2DMassIntroConvergenceMultiPatch:

Multi-Patch E/B convergence and SNR 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 FITS catalogue (e.g. :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`)
collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters
:ref:`twoDMassParams2DConvergencePatchesToSphere <twoDMassParams2DConvergencePatchesToSphere>`
defining in particular the patch characteristics,  output HEALPix resolution and other
running parameters.
Potentially a footprint mask :ref:`VMPZIDHEALPixFootprintMask <VMPZIDHEALPixFootprintMask>`
is also needed to define the decomposition of the sky.
The output :ref:`twoDMassConvergencePatchesToSphere <twoDMassConvergencePatchesToSphere>`
collects as HEALPix maps the noisy/denoised convergence, number of galaxies per pixel,
Monte Carlo realisations and SNR maps.

The input and output are described in:

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


.. _2DMassIntroConvergenceSpherical:

Spherical E/B convergence and SNR maps
+++++++++++++++++++++++++++++++++++++++

For large fields processed on the sphere (for statistical studies, to compute the
catalogue of peaks), another option is to fully process the catalogue on the sphere.
An input FITS catalogue (e.g. :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`)
collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters
:ref:`twoDMassParams2DConvergenceSphere <twoDMassParams2DConvergenceSphere>`
specifying the HEALPix resolution and other running parameters.

The product :ref:`twoDMassConvergenceSphere <twoDMassConvergenceSphere>`
contains as products computed on the sphere (HEALPix maps) the noisy/denoised
convergence maps, the number of galaxies per pixel, Monte Carlo realisations and SNR maps.

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

.. _2DMassIntroPeak:

Peak Catalogs
+++++++++++++

Finally, peak catalogues :ref:`twoDMassPeakCatalog <twoDMassPeakCatalog>` can be estimated
for statistical studies. This is performed by detecting peaks either from aperture mass maps
computed on the input catalogue (e.g. :ref:`lensMCCatalog2DMassWL <lensMCCatalog2DMassWL>`)
with parameters :ref:`twoDMassParamsPeakCatalogMassAperture2D <twoDMassParamsPeakCatalogMassAperture2D>`
or from the wavelet decomposition of the convergence maps using parameters
:ref:`twoDMassParamsPeakCatalogConvergence <twoDMassParamsPeakCatalogConvergence>`,
along with SNR maps. A FITS keyword indicate which estimator has been used.

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



.. |badge1| image:: https://img.shields.io/badge/EDEN-3.0-Green
.. |badge2| image:: https://img.shields.io/badge/DM-9.0.2-Green
.. |badge3| image:: https://img.shields.io/badge/ML-ML3A-Green