.. include:: ../../wlsubstitutions.rst
.. _CovarTwoPCFWLCOSEBIShearShear2D:

Output Product: Covariance of Tomographic Cosmic Shear COSEBI
=================================================================

$SetSchemaPath le3/wl/cmtwopcf/out/euc-le3-wl-cmtwopcf-COSEBIShearShear2D.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_CM_2PCF_WL_ShearShear_Pipeline

**Consumers:**

* 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

The covariance matrix gives the error estimates of the shear-shear real-space second-order statistics EE, BB.EB functions.

.. IncludeInSASEnd

Data Product Elements
_______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
__________________________________________
.. DetailedDescStart
This product contains the covariance matrix for cosmic shear COSEBI modes.

This output product is a fits binary table containing important input
parameters as keywords in primary HDU, and a binary table in the next HDU with the
covariance for cosmic shear COSEBI modes, as described in
 `le3.wl.cm2pcf.output.cosebishearshear2d <https://gitlab.euclid-sgs.uk/ST-DM/ST_FitsDataModel/-/blob/9.2.0/ST_DM_FitsSchema/auxdir/ST_DM_FitsSchema/instances/fit/euc-le3-wl.xml#L1039>`_.

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

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


Keywords
+++++++++++++

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.cm2pcf.output.cosebishearshear2d

Covariance table
+++++++++++++++++

The table (first HDU, EXTNAME="RS_COVAR_COSEBI_SHEARSHEAR2D") will contain the following columns:

$PrintCatalog fit/euc-le3-wl.xml le3.wl.cm2pcf.output.cosebishearshear2d

.. note::
    Under discussion is the possibility in the future of having as first HDU an
    estimate for Shot Noise :

    #. **MODE1**: first COSEBI mode [I, int16]
    #. **MODE2**: second COSEBI mode [I, int16]
    #. **BIN_COMB1**: first index for combination of redshift bins [J, int32]
    #. **BIN_COMB2**: second index for combination of redshift bins [J, int32]
    #. **EE_EE_SH**: covariance between E COSEBI (shape noise) [D, float64]
    #. **BB_BB_SH**: covariance between B COSEBI (shape noise) [D, float64]
    #. **EB_EB_SH**: covariance between EB cross COSEBI (shape noise) [D, float64]
    #. **EE_BB_SH**: covariance between E and B COSEBI (shape noise) [D, float64]
    #. **EE_EB_SH**: covariance between E and EB COSEBI (shape noise) [D, float64]
    #. **BB_EB_SH**: covariance between B and EB COSEBI (shape noise) [D, float64]

.. DetailedDescEnd