.. include:: ../../wlsubstitutions.rst .. _TwoPCFWLPEBPosShear2D: Output Product: Galaxy-Galaxy Lensing E/B Power Spectra ========================================================= Metadata ______________________ +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product name | DpdTwoPCFWLPEBPosShear2D | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product custodian | WLTWOPCF | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Name of the Schema file | .. raw:: html | | | | | | `euc-le3-wl-twopcf-PEBPosShear2D.xsd `_ | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Last Edited for DPDD Version | 1.1 | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Processing Element(s) creating/using the data | **Creators:** | | product | | | | * LE3_2PCF_WL_PosShear_Pipeline | | | * LE3_CM_2PCF_WL_PosShear_Pipeline | | | * LE3_2PCF_PosShearEstimator_Pipeline | | | * LE3_CM_2PCF_PosShearEstimator_Pipeline | | | | | | **Consumers:** | | | | | | * WL-SWG | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Processing function using the data product | SGS pipeline output product to be used by LE3 and SWGs | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Proposed for inclusion in EAS/SAS | This product is proposed for inclusion in the SAS: Yes | | | | | | Motivation: the product contains the two-point pos-shear tomographic real-space second order | | | statistic E,B modes functions requested by the RSD document. | +------------------------------------------------+----------------------------------------------------------------------------------------------+ Data Product Elements ______________________ +--------------+----------------------------------------------+ | Header | object of type sys:genericHeader | +--------------+----------------------------------------------+ | Data | object of type wl2pcf:twoPCFWLPEBPosShear2D | +--------------+----------------------------------------------+ | QualityFlags | object of type dqc:sqfPlaceHolder | +--------------+----------------------------------------------+ | Parameters | object of type ppr:genericKeyValueParameters | +--------------+----------------------------------------------+ Detailed Description of the Data Product _________________________________________ .. DetailedDescStart This product contains the tomographic galaxy-galaxy lensing E/B power spectra. This output product is a fits file (see ``le3.wl.2pcf.output.pebposshear2d`` 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 (=["PosShear"]) [string among "PosPos", "PosShear", "ShearShear"] * **CatalogInfo**: whether position or shear information is used in this catalogue [string among "Pos", "Shear"] * **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 galaxy-galaxy lensing E/B power spectra for specific bins. Primary Array +++++++++++++ This fits table is expected to contain the following keywords in primary HDU, characterizing the important parameters of the product: .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------------+ | **HDU** *PRIMARY*: header | +==========+==========+==============================================================================+===========+ | | **Name** | **Description** | **Value** | +----------+----------+------------------------------------------------------------------------------+-----------+ | Keywords | SIMPLE | | logical | + +----------+------------------------------------------------------------------------------+-----------+ | | BITPIX | | integer | + +----------+------------------------------------------------------------------------------+-----------+ | | NAXIS | | integer | + +----------+------------------------------------------------------------------------------+-----------+ | | EXTEND | | logical | + +----------+------------------------------------------------------------------------------+-----------+ | | THMIN | Min of angular range | double | + +----------+------------------------------------------------------------------------------+-----------+ | | THMAX | Max of angular range | double | + +----------+------------------------------------------------------------------------------+-----------+ | | OATH | Open Angle threshold | double | + +----------+------------------------------------------------------------------------------+-----------+ | | THUNIT | Unit of theta | string | + +----------+------------------------------------------------------------------------------+-----------+ | | BINSCALE | lin or log bins | string | + +----------+------------------------------------------------------------------------------+-----------+ | | COORDSYS | cartesian or spherical | string | + +----------+------------------------------------------------------------------------------+-----------+ | | PROBE | Kind of probe | string | + +----------+------------------------------------------------------------------------------+-----------+ | | SHE_SOFT | Where the input catalogue is coming from (if SHE catalogue used) | string | + +----------+------------------------------------------------------------------------------+-----------+ | | POS_SEL | ID of selection made (e.g. tomographic redshifts, stellar mass) | string | + +----------+------------------------------------------------------------------------------+-----------+ | | SHE_SEL | ID of selection made (e.g. tomographic redshifts, stellar mass) | string | + +----------+------------------------------------------------------------------------------+-----------+ | | SOFTNAME | | string | + +----------+------------------------------------------------------------------------------+-----------+ | | SOFTVERS | | string | + +----------+------------------------------------------------------------------------------+-----------+ | | BLINDING | Flag that identifies products that have been blinded for scientific analysis | string | +----------+----------+------------------------------------------------------------------------------+-----------+ #. **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 [StringKeyword] #. **POS_SEL**: selection for position catalogue [StringKeyword] #. **SHE_SEL**: selection for shear catalogue [StringKeyword] #. **SOFTNAME**: name of software used for PEB [StringKeyword] #. **SOFTVERS**: version of software used for PEB [StringKeyword] Table (HDU=1...) ++++++++++++++++ The following keywords are added to the header of the HDUs: .. table:: :width: 100% +---------------------------------------------------------------+ | **HDU** *POSSHEAR2D_PEB_n*: header | +===========+===========+=========================+=============+ | | **Name** | **Description** | **Value** | +-----------+-----------+-------------------------+-------------+ | 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 | + +-----------+-------------------------+-------------+ | | TTYPE5 | | string | + +-----------+-------------------------+-------------+ | | TFORM5 | | string | + +-----------+-------------------------+-------------+ | | EXTNAME | | string | + +-----------+-------------------------+-------------+ | | BIN_ID1 | First Bin in Correl | integer | + +-----------+-------------------------+-------------+ | | BIN_ID2 | Second Bin in Correl | integer | +-----------+-----------+-------------------------+-------------+ .. table:: :width: 100% +---------------------------------------------------------------+ | **HDU** *POSSHEAR2D_PEB_n*: 5 columns table | +=========+===========+=================+==========+============+ | | **Name** | **Description** | **Unit** | **Format** | +---------+-----------+-----------------+----------+------------+ | Columns | ELL | | NA | FITS *D* | + +-----------+-----------------+----------+------------+ | | PE | | NA | FITS *D* | + +-----------+-----------------+----------+------------+ | | PB | | NA | FITS *D* | + +-----------+-----------------+----------+------------+ | | ELL_LOWER | | NA | FITS *D* | + +-----------+-----------------+----------+------------+ | | ELL_UPPER | | NA | FITS *D* | +---------+-----------+-----------------+----------+------------+ #. **BIN_ID1**: bin for first catalog [IntegerKeyword] #. **BIN_ID2**: bin for second catalog [IntegerKeyword] #. **EXTNAME**: "POSSHEAR2D_PEB" and the columns are: #. **ELL**: central multipole in the band [D, float64] #. **PE**: E mode band power spectrum [D, float64] #. **PB**: B mode 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] .. DetailedDescEnd