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

Random Catalog Product
========================

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

* VMSP_Sample

**Consumers**

* SEL_Select
* SWG-GC, SWG-GAE

.. PECreatorEnd

Processing function using the data product
_______________________________________________
.. PFUsingStart

* ID-SEL VMSP pipeline uses this product to produce outputs for LE3 GC.
* SWG-GC uses this product.

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: yes

The VMSP random catalog product is necessary for the GC-SWG to build additional galaxy samples for verification tests and science analyses.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This product contains the random catalog constructed by ID VMSP, which characterizes the spectroscopic selection function of the Euclid Wide survey. The number density of the random catalog is at least 50x that of the galaxy catalog. The catalog consists of randomly sampled positions on the sky (right ascension and declination). In addition, each random point is tagged with galaxy properties, including redshift, fluxes and size. The weight column gives the probability that the random will be detected and measured at the given redshift.

The Euclid Wide survey is partitioned into tiles, and the data product represents a single tile.

The data file is in FITS format and contains a primary HDU and a binary table extension HDU.

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:

+---------------------------+---------------------------+------------------------------------------------------------+
| Key                       | Type                      | Description                                                |
+===========================+===========================+============================================================+
| Area                      | float                     | Area of the random catalog (deg2).                         |
+---------------------------+---------------------------+------------------------------------------------------------+
| Density                   | float                     | Density of the random catalog (/deg2).                     |
+---------------------------+---------------------------+------------------------------------------------------------+
| CalblockIdList            | CalblockIdList            |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| Catalog                   | randomCatalogFile         | Pointer to the FITS data file.                             |
+---------------------------+---------------------------+------------------------------------------------------------+
| CatalogDescription        | CatalogDescription        |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| IslandLabelList           | IslandLabelList           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| ObservationIdList         | ObservationIdList         |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| PatchIdList               | PatchIdList               |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpatialCoverage           | SpatialCoverage           |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| SpectralCoverage          | SpectralCoverage          |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| TileIndexList             | TileIndexList             |                                                            |
+---------------------------+---------------------------+------------------------------------------------------------+
| VmspCoverageMap           | vmspCoverageMap           | Healpix weight map.                                        |
+---------------------------+---------------------------+------------------------------------------------------------+
| VmspDetectorFootprintList | vmspDetectorFootprintList | The polygon footprint of detectors that overlap this tile. |
+---------------------------+---------------------------+------------------------------------------------------------+

FITS Keywords
+++++++++++++

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

$PrintExtensionHeader fit/euc-test-le3-id.xml le3.id.vmsp.randomcatalog CATALOG

Table
+++++

The table is expected to contain the following columns:

$PrintCatalog fit/euc-le3-id.xml le3.id.vmsp.randomcatalog


.. DetailedDescEnd