Output Product: Tomographic Angular Correlation

Data Product Name

DpdTwoPCFWLPosPos2D

Data Product Custodian

WLTWOPCF

Name of the Schema File

euc-le3-wl-twopcf-PosPos2D.xsd

Last Edited for DPDD Version

1.1

Processing Elements Creating / Updating / Using the Product

Creators:

  • LE3_2PCF_WL_PosPos_Pipeline

  • LE3_CM_2PCF_WL_PosPos_Pipeline

  • LE3_2PCF_WL_PosPosEstimator_Pipeline

  • LE3_CM_2PCF_WL_PosPosEstimator_Pipeline

Consumers:

  • WL-SWG

Processing Function using the products

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 position-position tomographic real-space correlation functions requested by the RSD document.

Data Product Elements

Header:

object of type sys:genericHeader

Data:

object of type wl2pcf:twoPCFWLPosPos2D

QualityFlags:

object of type dqc:sqfPlaceHolder

Parameters:

object of type ppr:genericKeyValueParameters

Detailed Description of the Data Product

This product contains the tomographic angular 2PCF.

This output product is a fits file (see le3.wl.2pcf.output.pospos2d in the following FITS descriptors).

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 1 element]

    • 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 correlation 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)

SHE_SEL

/

ID of selection made (e.g. tomographic redshifts, stellar mass)

POS_SEL

/

ID of selection made (e.g. tomographic redshifts, stellar mass)

SOFTNAME

/

SOFTVERS

/

END

  1. W_EST: choice of estimator (Landy-Szalay or Hamilton, or DD or DR or RR) [StringKeyword]

  2. THMIN: minimal angular value chosen for spatial binning [DoubleKeyword]

  3. THMAX: maximal angular value chosen for spatial binning [DoubleKeyword]

  4. OATH: maximal open angle value used for the approximation [DoubleKeyword]

  5. THUNIT: unit of spatial distance [StringKeyword]

  6. BINSCALE: if linear or logarithmic scales are used for output [StringKeyword]

  7. COORDSYS: if spherical or cartesian computation of distances [StringKeyword]

  8. SHE_SOFT: which SHE catalogue used (if used) [StringKeyword]

  9. POS_SEL: selection for position catalogue [StringKeyword]

  10. SOFTNAME: name of software used for 2PCF [StringKeyword]

  11. SOFTVERS: version of software used for 2PCF [StringKeyword]

Table (HDU=1…)

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

HDU POSPOS2D_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

EXTNAME

string

BIN_ID1

First Bin in Correl

integer

BIN_ID2

Second Bin in Correl

integer

4 columns table

Columns

THETA

FITS D

WTHETA

FITS D

WEIGHT

FITS D

SQRT_D

FITS D

  1. BIN_ID1: bin for first catalog [IntegerKeyword]

  2. BIN_ID2: bin for second catalog [IntegerKeyword]

  3. EXTNAME: “POSPOS2D_2PCF”

and the columns are:

  1. THETA: mean angular separation in the bin [D, float64]

  2. WTHETA: angular 2PCF values [D, float64]

  3. WEIGHT: total weight for the bin [D, float64]

  4. SQRT_D: Poisson error associated to the bin [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):

  1. THETA: angular separation (center of spatial bin) [D, float64]

  2. MIN_THETA: minimal angular separation in the bin [D, float64]

  3. 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:

  1. BIN_ID1: bin for first catalog [J, int32]

  2. BIN_ID2: bin for second catalog [J, int32]

  3. HDU: HDU index [J, int32]