.. include:: ../../idsubstitutions.txt
.. _SELIDCatalog:

SEL-ID Catalog Product
=======================

$SetSchemaPath le3/id/sel/out/euc-le3-id-sel-Catalog.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:**

* SEL_Collect

**Consumers:**

* SEL_Select
* VMSP_Train
* VMSP_Sample

.. PECreatorEnd

Processing function using the data product
______________________________________________
.. PFUsingStart

* ID SEL-VMSP pipeline
* SWG-GC, SWG-GAE

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: yes

The catalog is needed by the GC-SWG for building alternative galaxy samples for verification and science analyses.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This is the main galaxy catalog constructed for the spectroscopic galaxy clustering analyses.
It contains galaxy properties selected from OU-SPE (spectroscopic) and OU-MER (photometric)
measurements.

This catalog is stored in a FITS file. The second HDU is a binary table extension that contains
metadata in the keywords and the catalog in the data table.

**Milky Way extinction correction**

SELID applies the Milky Way extinction correction to the broadband and line fluxes in the SEL catalog. The corrected fluxes are found in the columns with the `_MWCORR` suffix, for example `FLUX_H_APER_MWCORR` and `FLUX_HALPHA_TOT_MWCORR`.

For monocromatic flux, the corrected flux is

.. math:: f_{corr}(\lambda) = f_{obs}(\lambda)10^{0.4 k(\lambda)E_{B-V}}

where :math:`k(\lambda) = A(\lambda)/E_{B-V}` is the extinction curve. We use the extinction curve from |Fitzpatrick99|_ with :math:`R_V=3.1`.

For broadband flux in filter `X`, we use the coefficient :math:`C_X`, and the corrected flux is

.. math:: f_{X, corr} = f_{X, obs} 10^{0.4 C_X E_{B-V}}

The coefficient is computed as,

.. math:: C_X = -2.5 \log \frac{\int T_X(\lambda) 10^{-0.4 k(\lambda)} \frac{1}{\lambda} d\lambda}{\int T_X(\lambda) \frac{1}{\lambda} d\lambda}

This calculation is based on a flat reference SED per unit frequency, :math:`f_\nu(\nu)=const`,
which gives per unit wavelength, :math:`f_{\lambda}(\lambda)\propto 1/\lambda^2`, and :math:`T_X(\lambda)` is the total instrument transmission curve including quantum efficiency.

Using the PLM, filter transmission and quantum efficiency curves in the mission database, we find the following extinction coefficients:

+--------+-------------+
| Filter | Coefficient |
+========+=============+
| VIS    | 2.09        |
+--------+-------------+
| NISP Y | 1.03        |
+--------+-------------+
| NISP J | 0.702       |
+--------+-------------+
| NISP H | 0.474       |
+--------+-------------+


Metadata
++++++++
The metadata stored in the Data element of the XML contains useful information about the survey coverage. Here is a brief summary of the metadata:

**Data/**

+---------------------------+---------------------------+------------------------------------------------------------+
| Key                       | Type                      | Description                                                |
+===========================+===========================+============================================================+
| CalblockIdList            | CalblockIdList            |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| Catalog                   | randomCatalogFile         | Pointer to the FITS data file.                             |
+---------------------------+---------------------------+------------------------------------------------------------+
| CatalogDescription        | CatalogDescription        |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| IslandLabelList           | IslandLabelList           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| ObservationIdList         | ObservationIdList         |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| PatchIdList               | PatchIdList               |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpatialCoverage           | SpatialCoverage           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpectralCoverage          | SpectralCoverage          |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| TileIndexList             | TileIndexList             |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+


Keywords Extension Header CATALOG
+++++++++++++++++++++++++++++++++++

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

$PrintExtensionHeader fit/euc-le3-id.xml le3.id.catalog CATALOG


Table
+++++

The table is expected to contain the following columns:

$PrintCatalog fit/euc-le3-id.xml le3.id.catalog

.. DetailedDescEnd