.. include:: ../../wlsubstitutions.rst
.. _TwoPCFWLClPosPos2D:

Output Product: Tomographic Angular Power Spectra
==================================================

$SetSchemaPath le3/wl/twopcf/out/euc-le3-wl-twopcf-ClPosPos2D.xsd

Data Product Name
__________________
.. DataProductNameStart

$PrintDataProductName

.. DataProductNameEnd

Data Product Custodian
________________________
.. DataProductCustodianStart

$PrintDataProductCustodian

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

$PrintSchemaFilename

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

Processing Elements Creating / Updating / Using the Product
_____________________________________________________________
.. PECreatorStart

**Creators:**

* LE3_2PCF_WL_PosPosEstimator_Pipeline
* LE3_CM_2PCF_WL_PosPosEstimator_Pipeline
* LE3_2PCF_WL_PosPos_Pipeline
* LE3_CM_2PCF_WL_PosPos_Pipeline

**Consumers:**

* WL-SWG

.. PECreatorEnd

Processing Function using the products
________________________________________
.. PFUsingStart

SGS pipeline output product to be used by LE3 and SWGs

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: Yes

Motivation: the product contains the two-point position-position tomographic real-space second order statistic CL functions requested by the RSD document.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This product contains the tomographic angular power spectra.

This output product is a fits file (see ``le3.wl.2pcf.output.clpospos2d`` in |XSD-FITS-WL|_).

Extra (optional) metadata associated to the FITS container are the following:

* **SpatialCoverage** a description of the spatial footprint [optional, cot:spatialFootprint],
* **CatalogSelection**: describing the selection in the input catalogues [optional, up to 2 elements]

  *  **CatalogFileName**: the name of the input catalogue [sys:dataFileName]
  *  **CatalogSHE**: type of input catalogue [string among "BFD", "KSB",
     "LensMC","MomentsML","REGAUSS","MER_PHZ", "OTHER" ]
  *  **Selection**: selection associated to catalogue [string]
  *  **CatalogUse**: for which use case the catalog is employed (=["PosPos"])
     [string among "PosPos", "PosShear", "ShearShear"]
  *  **CatalogInfo**:  whether position or shear information is used in this catalogue
     [string among "Pos", "Shear"] (=["Pos"])
  * **CatalogOrder**: order associated to catalogue for reporting (e.g. BIN_ID1)[int32]

The fits file contains:

- a primary array containing important computation parameters as keywords,
- binary tables in the next HDUs with angular power spectra for specific redshift bins.

Primary Array
+++++++++++++

This fits table is expected to contain the following keywords in primary HDU,
characterizing the important parameters of the product:

$PrintPrimaryHeader fit/euc-le3-wl.xml le3.wl.2pcf.output.clpospos2d

#. **W_EST**: choice of estimator (Landy-Szalay or Hamilton or DD, DR, RR) [StringKeyword]
#. **THMIN**: minimal angular value chosen for spatial binning [DoubleKeyword]
#. **THMAX**: maximal angular value chosen for spatial binning [DoubleKeyword]
#. **OATH**: maximal open angle value used for the approximation [DoubleKeyword]
#. **THUNIT**: unit of spatial distance [StringKeyword]
#. **BINSCALE**: if linear or logarithmic scales are used for output [StringKeyword]
#. **COORDSYS**: if spherical or cartesian computation of distances [StringKeyword]
#. **SHE_SOFT**: which SHE catalogue used (if used) [StringKeyword]
#. **POS_SEL**: selection for position catalogue [StringKeyword]
#. **SOFTNAME**: name of software used for CL [StringKeyword]
#. **SOFTVERS**: version of software used for CL [StringKeyword]

Table (HDU=1...)
++++++++++++++++

$PrintHDUTableContents fit/euc-le3-wl.xml le3.wl.2pcf.output.clpospos2d POSPOS2D_CL_n

The following keywords are added to the header of the HDUs:

#. **BIN_ID1**: bin for first catalog [IntegerKeyword]
#. **BIN_ID2**: bin for second catalog [IntegerKeyword]
#. **EXTNAME**: "POSPOS2D_CL"

and the column is:

#. **ELL**: central multipole in the band [D, float64]
#. **CL**: band power spectrum [D, float64]
#. **ELL_LOWER**: minimal multipole in the band [D, float64]
#. **ELL_UPPER**: maximal multipole in the band [D, float64]

.. note::
    Under discussion is the possibility in the future of having as first HDU a summary table with information
    on the binning for spectra tables (HDU>2):

    #. **ELL**: mean multipole in the band  [D, float64]
    #. **ELLMIN**:  minimal multipole in the band  [D, float64]
    #. **ELLMAX**:  maximal multipole in the band  [D, float64]


    and in the second hdu a summary table to allow fast access to the HDU corresponding to a particular
    bin combination:

    #. **BIN_ID1**: bin for first catalog [J, int32]
    #. **BIN_ID2**: bin for second catalog [J, int32]
    #. **HDU**: HDU index [J, int32]

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

   .. code-block:: XML

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

.. DetailedDescEnd