.. include:: ../../idsubstitutions.txt
.. _VMPZIDMOCInfoMap:

Output Product: MOC Information Maps
============================================


Data Product Name
__________________
.. DataProductNameStart

DpdMOCInfoMapVMPZ

.. DataProductNameEnd

Data Product Custodian
_______________________
.. DataProductCustodianStart

IDVMPZ

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

.. raw:: html 

    <a href="https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/9.2.0/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/le3/id/vmpz/out/euc-le3-id-vmpz-MOCInfoMap.xsd" target="_blank">euc-le3-id-vmpz-MOCInfoMap.xsd</a>

.. NameSchemaEnd

Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd

Processing Elements Creating / Updating / Using the Product
___________________________________________________________
.. PECreatorStart

**Creators:**

* VMPZ_Main (LE3_VMPZ_ID_Main)

**Consumers:**

* VMPZ_Visibility (LE3_VMPZ_ID_Visibility)

.. PECreatorEnd

Processing function using the data product
____________________________________________
.. PFUsingStart

* 2PCF-WL, PK-WL, 2PCF-GC, 3PCF-GC, PK-GC, DET-CL, PROF-CL, VMSP-ID
* SWG-GC, SWG-WL, SWG-CL

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in SAS: yes

This product is used by different PFs in OU-LE3 and expected to be used in scientific analysis in SWG-GC, SWG-WL and SWG-CL.

.. IncludeInSASEnd

Data Product Elements
______________________
.. DataProductElementsStart

:Header: object of type sys:genericHeader
:Data: object of type vmpzid:infoMapMOCVMPZ
:QualityFlags: object of type dqc:sqfPlaceHolder
:Parameters: object of type ppr:genericKeyValueParameters

.. DataProductElementsEnd

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This output product collects environmental/instrumental information
for a filter of an instrument to ultimately compute depth maps.

This output product is composed of **InfoMapMOC**, a container with a FITS file
in MOC HEALPix format (of type le3.id.vmpz.mocinfomap) collecting environmental/instrumental
information for a filter of an instrument to ultimately compute depth maps.
A raw description with polygons of the envelope of the sky covered is added as well
to ease future queries on the product (**SpatialCoverage** metadata, see `spatialFootprint <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/develop/ST_DM_Schema/auxdir/ST_DM_Schema/dictionary/bas/cot/euc-cot.xsd>`_).
Finally, the map parameters **InfoMapMOCParams** can optionally be associated to the product.

Keywords (Primary HDU)
++++++++++++++++++++++

The primary HDU is expected to contain the following keywords, characterizing
important parameters of the input product:

+----------+-----------+---+-----------------------------------------------------------------+
| SIMPLE   |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| BITPIX   |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| NAXIS    |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| EXTEND   |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| DATE-OBS |           | / | e.g. Start date for observations considered                     |
+----------+-----------+---+-----------------------------------------------------------------+
| DATE-END |           | / | e.g. End date for observations considered                       |
+----------+-----------+---+-----------------------------------------------------------------+
| TELESCOP |           | / | e.g. Euclid or -1                                               |
+----------+-----------+---+-----------------------------------------------------------------+
| INSTRUME |           | / | e.g. VIS or -1                                                  |
+----------+-----------+---+-----------------------------------------------------------------+
| FILTER   |           | / | e.g. VIS or -1                                                  |
+----------+-----------+---+-----------------------------------------------------------------+
| FILTLST  |           | / | index for combination of filters if intersection of footprints  |
+----------+-----------+---+-----------------------------------------------------------------+
| TILEID   |           | / | e.g. 5237, or -1 if not single tile                             |
+----------+-----------+---+-----------------------------------------------------------------+
| LISTID   |           | / | Product ID for a MER list of tiles                              |
+----------+-----------+---+-----------------------------------------------------------------+
| NSIDE_WK |           | / | Nside used for mosaic frame to HEALPix                          |
+----------+-----------+---+-----------------------------------------------------------------+
| BITSEL   |           | / | e.g. Bit mask selection applied based on MER binary values      |
+----------+-----------+---+-----------------------------------------------------------------+
| DEPTHEST |           | / | Estimator of depth                                              |
+----------+-----------+---+-----------------------------------------------------------------+
| BINSEL   |           | / | ID of galaxy sample/bin selection                               |
+----------+-----------+---+-----------------------------------------------------------------+
| SOFTNAME |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| SOFTVERS |           | / |                                                                 |
+----------+-----------+---+-----------------------------------------------------------------+
| END                                                                                        |
+----------+-----------+---+-----------------------------------------------------------------+

#. **DATE-OBS**: start of observation with format 'yyyy-mm-ddThh:mm:ss.sss' [StringKeyword]
#. **DATE-END**: end of observation with format 'yyyy-mm-ddThh:mm:ss.sss' [StringKeyword]
#. **TELESCOP**: name of the telescope [StringKeyword]
#. **INSTRUME**: name of the instrument [StringKeyword]
#. **FILTER**: name of the filter [StringKeyword]
#. **FILTLST**: selection of filter if intersection of multiple footprints [StringKeyword]
#. **TILEID**: identifier of the MER Tile processed (-1 if multiple Tiles) [IntegerKeyword]
#. **LISTID**: identifier of a MER list of tiles product (-1 if single Tile) [StringKeyword]
#. **NSIDE_WK**: Nside parameter used for frame->HEALPix [StringKeyword]
#. **INFO**: Information collected in the maps, e.g. "Noise", "PSF" [StringKeyword]
#. **STATS**: statiscts collected - e.g. RMS, median, max [StringKeyword]

   and basic software parameters:

#. **SOFTNAME**: name of software used [StringKeyword]
#. **SOFTVERS**: version of software used  [StringKeyword]

Partial MOC Footprint Table (First Extension, Binary Table)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

The following keywords are used to describe what MOC conventions are followed:

+----------+--------------+---------------------------------+-----------+
| HDU *VISIBILITY_MASK*                                                 |
+==========+==============+=================================+===========+
| 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    |
+          +--------------+---------------------------------+-----------+
|          | **PIXTYPE**  |                                 | string    |
+          +--------------+---------------------------------+-----------+
|          | **ORDERING** |                                 | string    |
+          +--------------+---------------------------------+-----------+
|          | **COORDSYS** |                                 | string    |
+          +--------------+---------------------------------+-----------+
|          | **EXTNAME**  |                                 | string    |
+          +--------------+---------------------------------+-----------+
|          | **NSIDE**    |                                 | integer   |
+          +--------------+---------------------------------+-----------+
|          | **INDXSCHM** |                                 | string    |
+          +--------------+---------------------------------+-----------+
|          | **OBJECT**   |                                 | string    |
+----------+--------------+---------------------------------+-----------+
| 2 columns table                                                       |
+----------+--------------+---------------------------------+-----------+
| Columns  | **PIXEL**    | Index of the HEALPix pixel cell | FITS *K*  |
+          +--------------+---------------------------------+-----------+
|          | **WEIGHT**   | Depth                           | FITS *E*  |
+----------+--------------+---------------------------------+-----------+


#. **TTYPE1**  (= 'UNIQ') [StringKeyword]
#. **TFORM1**  (= 'K') [StringKeyword]
#. **TTYPE2**  (= 'WEIGHT') [StringKeyword]
#. **TFORM2**  (= 'E') [StringKeyword]
#. **PIXTYPE** (= 'HEALPIX') [StringKeyword]
#. **ORDERING** (= 'NUNIQ') [StringKeyword]
#. **COORDSYS** (= 'C'=celestial, 'E'=ecliptic or 'G'=galactic) [StringKeyword]
#. **MOCORDER** (best HEALPix order) [IntegerKeyword]
#. **MOCTYPE** [StringKeyword]
#. **DATE**  [StringKeyword]
#. **EXTNAME** (= 'INFO_MAP') [StringKeyword]


The table is then expected to contain the following columns:

#. **UNIQ**: index of pixel [K, int64]
#. **WEIGHT**: (floating-point) weight associated to pixel indicating the value of the instrumental
   or environmental parameter collected  [E, float32]

.. DetailedDescEnd