.. include:: ../../idsubstitutions.txt
.. _DpdLE3IDVMSPRandomCatalog:

Random Catalog Product
------------------------

Data product name
=================
.. DataProductNameStart

DpdLE3IDVMSPRandomCatalog

.. DataProductNameEnd

Data product custodian
======================
.. DataProductCustodianStart

VMSP-ID

.. DataProductCustodianEnd

Data model tag
==============
.. DataModelTagStart

|ML2B|

.. DataModelTagEnd

Name of the Schema file
=======================
.. NameSchemaStart

euc-test-le3-id-vmsp-randomcatalog.xsd

.. NameSchemaEnd

Schema documentation tag
========================
.. SchemaDocTagStart

|ML2B|

.. SchemaDocTagEnd

Data product elements
=====================
.. DataProductElementsStart

* **Catalog** *randomCatalogFile* - FITS catalog container

.. DataProductElementsEnd

Processing Element(s) creating/using the data product
=====================================================
.. PECreatorStart

VMSP-ID, SEL-ID

.. PECreatorEnd

Processing function using the data product
==========================================
.. PFUsingStart

SGS pipeline output product to be used by LE3, SWGs

.. PFUsingEnd

Detailed description of the data product
========================================
.. DetailedDescStart


This output product is a fits binary table containing important
parameters as keywords in primary HDU, and a binary table in the next HDU with the
random catalog.

Keywords
++++++++

This fits table is expected to contain the following keywords in primary HDU,
characterizing the parameters of the product:

#. **TELESCOP** =``EUCLID`` - Mission identifier
#. **INSTRUME** =``LE3IDVMSP`` - PF identifier
#. **FILENAME** *string* - Name of fits file
#. **COORD** =``EQUATORIAL`` - coordinate type EQUATORIAL, CARTESIAN
#. **CAT_TYPE** =``RANDOM`` - Type of catalog DATA or RANDOM
#. **CAT_NAME** *string* - ID of Catalog
#. **CAT_NOBJ** *int* - Object count of catalog
#. **DEEP_CAT** *string* - Identifier of input reference catalog
#. **WIDE_CAT** *string* - identifier of input wide catalog
#. **OBSID** *string* - list of processed observation IDs
#. **SAMPALGO** *string* - sampling algorithm (SHUFFLE or GMM)
#. **GMM_NCOM** *int* - number of components for GMM
#. **ANGLE** *string* - angle type RAD or DEG
#. **TILE** *string* - tile index
#. **TILESCHE** *string* - tile definition scheme
#. **TILEAREA** *string* - tile area in sqr deg
#. **SURVAREA** *string* - effective survey area in sqr deg
#. **DENSITY** *string* - density of catalog number/sqr deg

Table
+++++

The table is expected to contain the following columns:

#. **OBJECT_ID**: unique identifier of source (integer)
#. **RA**: right ascension coordinate (degrees)
#. **DEC**: declination coordinate (degrees)
#. **REDSHIFT**: redshift (redshift)
#. **REDSHIFT_TRUE**: redshift (redshift)
#. **FLUX_Y_TOTAL**:  apparent flux in NISP Y band (uJy)
#. **FLUX_J_TOTAL**:  apparent flux in NISP J band (uJy)
#. **FLUX_H_TOTAL**:  apparent flux in NISP H band (uJy)
#. **FLUX_LYA**:  apparent flux of Ly alpha line (erg/cm2/s)
#. **FLUX_OII3727**:  apparent flux of OII line (3727A) (erg/cm2/s)
#. **FLUX_HBETA**:  apparent flux of Hbeta line (4863A) (erg/cm2/s)
#. **FLUX_OIII4960**: apparent flux of OIIIa line (4960A) (erg/cm2/s)
#. **FLUX_OIII5008**: apparent flux of OIIIb line (5008A) (erg/cm2/s)
#. **FLUX_HALPHA**:  apparent flux of Halpha line (6565A) (erg/cm2/s)
#. **FLUX_NII6549**: apparent flux of NIIa line (6550A) (erg/cm2/s)
#. **FLUX_NII6585**: apparent flux of NIIb line (6585A) (erg/cm2/s)
#. **FLUXSII6718**: apparent flux of SIIa line (6718A) (erg/cm2/s)
#. **FLUX_SII6723**: apparent flux of SIIb line (6723A) (erg/cm2/s)
#. **FLUX_SIII9068**: apparent flux of SIII line (9068A) (erg/cm2/s)
#. **FLUX_SIII9530**: apparent flux of SIII line (9530A) (erg/cm2/s)
#. **FLUXERR_Y_TOTAL**:  flux error of NISP Y band (uJy)
#. **FLUXERR_J_TOTAL**:  flux error of NISP J band (uJy)
#. **FLUXERR_H_TOTAL**:  flux error of NISP H band (uJy)
#. **FLUX_LYA_ERROR**:  flux error of Ly alpha line (erg/cm2/s)
#. **FLUX_OII3727_ERROR**:  flux error of OII line (3727A) (erg/cm2/s)
#. **FLUX_HBETA_ERROR**:  flux error of Hbeta line (4863A) (erg/cm2/s)
#. **FLUX_OIII4960_ERROR**: flux error of OIIIa line (4960A) (erg/cm2/s)
#. **FLUX_OIII5008_ERROR**: flux error of OIIIb line (5008A) (erg/cm2/s)
#. **FLUX_HALPHA_ERROR**:  flux error of Halpha line (6565A) (erg/cm2/s)
#. **FLUX_NII6549_ERROR**: flux error of NIIa line (6550A) (erg/cm2/s)
#. **FLUX_NII6585_ERROR**: flux error of NIIb line (6585A) (erg/cm2/s)
#. **FLUXSII6718_ERROR**: flux error of SIIa line (6718A) (erg/cm2/s)
#. **FLUX_SII6723_ERROR**: flux error of SIIb line (6723A) (erg/cm2/s)
#. **FLUX_SIII9068_ERROR**: flux error of SIII line (9068A) (erg/cm2/s)
#. **FLUX_SIII9530_ERROR**: flux error of SIII line (9530A) (erg/cm2/s)
#. **A_IMAGE**: half-light radius (arcsec)
#. **ELLIPTICITY**: ellipticity (unitless)
#. **REDSHIFT_REL**: redshift reliability flag (unitless)
#. **SPE_GAL_PROB**: galaxy classification probability (unitless)
#. **SPE_STAR_PROB**: star classification probability (unitless)
#. **SPE_QSO_PROB**: QSO classification probability (unitless)
#. **WEIGHT_RAND**: weight corresponding to measurement probability (unitless)
#. **SIGNAL**: measurement signal (counts)
#. **NOISE**: measurement noise (counts)

.. DetailedDescEnd