.. include:: ../../wlsubstitutions.rst .. _TwoPCFWLPosShear2D: Output Product: Tomographic Galaxy-Galaxy Lensing Correlation ================================================================ Data Product Name __________________ .. DataProductNameStart DpdTwoPCFWLPosShear2D .. DataProductNameEnd Data Product Custodian ________________________ .. DataProductCustodianStart WLTWOPCF .. DataProductCustodianEnd Name of the Schema File ________________________ .. NameSchemaStart .. raw:: html euc-le3-wl-twopcf-PosShear2D.xsd .. NameSchemaEnd Last Edited for DPDD Version ____________________________ .. DpddVersionlTagStart 1.1 .. DpddVersionTagEnd Processing Elements Creating / Updating / Using the Product _____________________________________________________________ .. PECreatorStart **Creators:** * LE3_2PCF_WL_PosShear_Pipeline * LE3_CM_2PCF_WL_PosShear_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 pos-shear tomographic real-space correlation functions requested by the RSD document. .. IncludeInSASEnd Data Product Elements ______________________ .. DataProductElementsStart :Header: object of type sys:genericHeader :Data: object of type wl2pcf:twoPCFWLPosShear2D :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 galaxy - galaxy lensing 2PCF. This output product is a fits file (see ``le3.wl.2pcf.output.shearpos2d`` 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 2-PCF 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 | | / | | +----------+-----------+---+-------------------------------------------------------------------+ | 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 | +----------+-----------+---+-------------------------------------------------------------------+ | PROBE | | / | Kind of probe | +----------+-----------+---+-------------------------------------------------------------------+ | 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) | +----------+-----------+---+-------------------------------------------------------------------+ | SHE_SEL | | / | ID of selection made (e.g. tomographic redshifts, stellar mass) | +----------+-----------+---+-------------------------------------------------------------------+ | SOFTNAME | | / | | +----------+-----------+---+-------------------------------------------------------------------+ | SOFTVERS | | / | | +----------+-----------+---+-------------------------------------------------------------------+ | END | +----------+-----------+---+-------------------------------------------------------------------+ #. **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 2PCF [StringKeyword] #. **SOFTVERS**: version of software used for 2PCF [StringKeyword] Table (HDU=1...) ++++++++++++++++ The following keywords are added to the header of the HDUs: +----------+---------------+----------------------+-----------+ | HDU *POSSHEAR2D_2PCF_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 | + +---------------+----------------------+-----------+ | | **TTYPE5** | | string | + +---------------+----------------------+-----------+ | | **TFORM5** | | string | + +---------------+----------------------+-----------+ | | **TTYPE6** | | string | + +---------------+----------------------+-----------+ | | **TFORM6** | | string | + +---------------+----------------------+-----------+ | | **TTYPE7** | | string | + +---------------+----------------------+-----------+ | | **TFORM7** | | string | + +---------------+----------------------+-----------+ | | **EXTNAME** | | string | + +---------------+----------------------+-----------+ | | **BIN_ID1** | First Bin in Correl | integer | + +---------------+----------------------+-----------+ | | **BIN_ID2** | Second Bin in Correl | integer | +----------+---------------+----------------------+-----------+ | 7 columns table | +----------+---------------+----------------------+-----------+ | Columns | **THETA** | | FITS *D* | + +---------------+----------------------+-----------+ | | **GAMMA_T** | | FITS *D* | + +---------------+----------------------+-----------+ | | **GAMMA_X** | | FITS *D* | + +---------------+----------------------+-----------+ | | **WEIGHT** | | FITS *D* | + +---------------+----------------------+-----------+ | | **SQRT_D** | | FITS *D* | + +---------------+----------------------+-----------+ | | **SQRT_DCOR** | | FITS *D* | + +---------------+----------------------+-----------+ | | **NPAIR** | | FITS *D* | +----------+---------------+----------------------+-----------+ #. **BIN_ID1**: bin for first catalog [IntegerKeyword] #. **BIN_ID2**: bin for second catalog [IntegerKeyword] #. **EXTNAME**: "POSSHEAR2D_2PCF" and the columns are: #. **THETA**: mean angular separation in the bin [D, float64] #. **GAMMA_T**: 2PCF for tangential component of shear [D, float64] #. **GAMMA_X**: 2PCF for cross component of shear [D, float64] #. **WEIGHT**: total weight for the bin [D, float64] #. **SQRT_D**: Poisson error associated to the bin [D, float64] #. **SQRT_DCOR**: Poisson error associated to the bin, down-weighted by the ratio of number of galaxy pairs by the number of nodes [D, float64] #. **NPAIR**: Number of pairs [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 2PCF tables (HDU>2): #. **THETA**: angular separation (center of spatial bin) [D, float64] #. **MIN_THETA**: minimal angular separation in the bin [D, float64] #. **MAX_THETA**: maximal angular separation in the bin [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