.. include:: ../../wlsubstitutions.rst
.. _TwoPCFWLClPosPos2D:
Output Product: Tomographic Angular Power Spectra
==================================================
Data Product Name
__________________
.. DataProductNameStart
DpdTwoPCFWLClPosPos2D
.. DataProductNameEnd
Data Product Custodian
________________________
.. DataProductCustodianStart
WLTWOPCF
.. DataProductCustodianEnd
Name of the Schema File
________________________
.. NameSchemaStart
.. raw:: html
euc-le3-wl-twopcf-ClPosPos2D.xsd
.. 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
**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
:Header: object of type sys:genericHeader
:Data: object of type wl2pcf:twoPCFWLClPosPos2D
:QualityFlags: object of type dqc:sqfPlaceHolder
:Parameters: object of type ppr:genericKeyValueParameters
.. 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:
+----------+-----------+---+-------------------------------------------------------------------+
| SIMPLE | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| BITPIX | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| NAXIS | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| EXTEND | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| W_EST | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| THMIN | | / | Min of angular range |
+----------+-----------+---+-------------------------------------------------------------------+
| THMAX | | / | Max of angular range |
+----------+-----------+---+-------------------------------------------------------------------+
| OATH | | / | Open Angle threshold |
+----------+-----------+---+-------------------------------------------------------------------+
| THUNIT | | / | Unit of theta |
+----------+-----------+---+-------------------------------------------------------------------+
| BINSCALE | | / | lin or log bins |
+----------+-----------+---+-------------------------------------------------------------------+
| COORDSYS | | / | cartesian or spherical |
+----------+-----------+---+-------------------------------------------------------------------+
| SHE_SOFT | | / | Where the input catalogue is coming from (if SHE catalogue used) |
+----------+-----------+---+-------------------------------------------------------------------+
| POS_SEL | | / | ID of selection made (e.g. tomographic redshifts, stellar mass) |
+----------+-----------+---+-------------------------------------------------------------------+
| SOFTNAME | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| SOFTVERS | | / | |
+----------+-----------+---+-------------------------------------------------------------------+
| END |
+----------+-----------+---+-------------------------------------------------------------------+
#. **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...)
++++++++++++++++
+----------+---------------+----------------------+-----------+
| HDU *POSPOS2D_CL_n* |
+==========+===============+======================+===========+
| Keywords | **XTENSION** | | string |
+ +---------------+----------------------+-----------+
| | **BITPIX** | | integer |
+ +---------------+----------------------+-----------+
| | **NAXIS** | | integer |
+ +---------------+----------------------+-----------+
| | **NAXIS1** | | integer |
+ +---------------+----------------------+-----------+
| | **NAXIS2** | | integer |
+ +---------------+----------------------+-----------+
| | **PCOUNT** | | integer |
+ +---------------+----------------------+-----------+
| | **GCOUNT** | | integer |
+ +---------------+----------------------+-----------+
| | **TFIELDS** | | integer |
+ +---------------+----------------------+-----------+
| | **TTYPE1** | | string |
+ +---------------+----------------------+-----------+
| | **TFORM1** | | string |
+ +---------------+----------------------+-----------+
| | **TTYPE2** | | string |
+ +---------------+----------------------+-----------+
| | **TFORM2** | | string |
+ +---------------+----------------------+-----------+
| | **TTYPE3** | | string |
+ +---------------+----------------------+-----------+
| | **TFORM3** | | string |
+ +---------------+----------------------+-----------+
| | **TTYPE4** | | string |
+ +---------------+----------------------+-----------+
| | **TFORM4** | | string |
+ +---------------+----------------------+-----------+
| | **EXTNAME** | | string |
+ +---------------+----------------------+-----------+
| | **BIN_ID1** | First Bin in Correl | integer |
+ +---------------+----------------------+-----------+
| | **BIN_ID2** | Second Bin in Correl | integer |
+----------+---------------+----------------------+-----------+
| 4 columns table |
+----------+---------------+----------------------+-----------+
| Columns | **ELL** | | FITS *D* |
+ +---------------+----------------------+-----------+
| | **CL** | | FITS *D* |
+ +---------------+----------------------+-----------+
| | **ELL_LOWER** | | FITS *D* |
+ +---------------+----------------------+-----------+
| | **ELL_UPPER** | | FITS *D* |
+----------+---------------+----------------------+-----------+
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
.. DetailedDescEnd