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

|badge1| |badge2| |badge3| |badge4|

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

From a OU-SHE/OU-PHZ catalogue DpdWLPosShearCatalog, 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.
* :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 DpdWLPosShearCatalog FITS catalogue collecting information from OU-SHE/OU-PHZ is needed, as well as a set of parameters DpdTwoDMassParamsConvergencePatch (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 DpdTwoDMassConvergencePatch.

The flowchart is the following:

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


.. _2DMassIntroConvergenceClusters:

E/B modes and SNR maps for cluster 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 DpdWLPosShearCatalog FITS catalogue. The output product is a tar file DpdTwoDMassConvergenceClusters 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 centred on each detected (and sufficiently massive) cluster. This tar is associated to the name of the catalogue processed to ease further joint processing.

.. 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 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 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 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 number of galaxies per pixel, Monte Carlo realisations and SNR 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 SNR maps. A FITS keyword indicate which estimator has been used.

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

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

Inputs

* DpdTwoDMassParamsConvergencePatch
* DpdWLProxyShearCatalog

Outputs

* DpdTwoDMassConvergencePatch

**E/B modes and SNR maps for cluster studies**:

Inputs

* DpdTwoDMassParamsConvergenceClusters
* DpdWLProxyShearCatalog
* DpdLE3clDetClusters

Outputs

* DpdTwoDMassConvergenceClusters

**Multi-Patch E/B convergence and SNR maps**:

Inputs

* DpdTwoDMassParamsConvergencePatchesToSphere
* DpdWLProxyShearCatalog
* DpdHealpixFootprintMaskVMPZ

Outputs

* DpdTwoDMassConvergencePatchesToSphere

**Spherical E/B convergence and SNR maps**:

Inputs

* DpdTwoDMassParamsConvergenceSphere
* DpdWLProxyShearCatalog

Outputs

* DpdTwoDMassConvergenceSphere

**Peak Catalogs (mass aperture)**:

Inputs

* DpdTwoDMassParamsPeakCatalogMassAperture
* DpdWLProxyShearCatalog

Outputs

* DpdTwoDMassPeakCatalog

**Peak Catalogs (convergence based)**:

Inputs

* DpdTwoDMassParamsPeakCatalogConvergence
* DpdWLProxyShearCatalog

Outputs

* DpdTwoDMassPeakCatalog

Input products 2DMASS

* :ref:`twoDMassParams2DConvergenceClusters`

* :ref:`twoDMassParams2DConvergencePatchesToSphere`

* :ref:`twoDMassParams2DConvergencePatch`

* :ref:`twoDMassParams2DConvergenceSphere`

* :ref:`twoDMassParamsPeakCatalogMassAperture2D`

* :ref:`twoDMassParamsPeakCatalogConvergence`

Output products 2DMASS

* :ref:`twoDMassPeakCatalog`

* :ref:`twoDMassConvergenceClusters`

* :ref:`twoDMassConvergencePatchesToSphere`

* :ref:`twoDMassConvergencePatch`

* :ref:`twoDMassConvergenceSphere`

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