.. include:: ../../idsubstitutions.txt
.. _VMPZIDHEALPixInfoMap:
Output Product: HEALPix Information Maps
============================================
Data Product Name
_________________
.. DataProductNameStart
DpdHealpixInfoMapVMPZ
.. DataProductNameEnd
Data Product Custodian
______________________
.. DataProductCustodianStart
IDVMPZ
.. DataProductCustodianEnd
Name of the Schema File
_______________________
.. NameSchemaStart
.. raw:: html
euc-le3-id-vmpz-HealpixInfoMap.xsd
.. NameSchemaEnd
Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart
2.0
.. 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:infoMapHealpixVMPZ
: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.
This output product is composed of **InfoMapHealpix**, a container with a FITS file
in partial HEALPix format (of type le3.id.vmpz.healpixinfomap) collecting environmental/instrumental
information for a filter of an instrument.
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 `_).
Finally, the map parameters **InfoMapHealpixParams** can optionally be associated to the product.
+------------------------------+-----------------------------------+-------------------------------------+
| Measurements | Subtype (XML) / INFO (FITS) field | Data source |
+==============================+===================================+=====================================+
| Tile Index | Tile | MER Tile |
+------------------------------+-----------------------------------+-------------------------------------+
| Solar Aspect Angle | SAA | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| Alpha Angle | AA | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| Beta Angle | BA | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| Exposures | Exposures | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| Noise (RMS) | Noise | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| PSF FWHM | PSF | MER Bks Mosaic |
+------------------------------+-----------------------------------+-------------------------------------+
| Galactic Extinction / band | GalacticExtinction | from Plank E(B-V) map, see :sup:`1` |
+------------------------------+-----------------------------------+-------------------------------------+
| Zodiacal Light / band | ZodiacalLight | see :sup:`1` |
+------------------------------+-----------------------------------+-------------------------------------+
| Galaxy Number Density | GalaxyNumberDensity | CatRed catalogs |
+------------------------------+-----------------------------------+-------------------------------------+
| PhotoZ Weight | GalaxyPhZWeight | CatRed catalogs |
+------------------------------+-----------------------------------+-------------------------------------+
| PHZ70 Mean / RMS / Std | GalaxyRelPhZSeventy{Mean,Rms,Std} | CatRed catalogs |
+------------------------------+-----------------------------------+-------------------------------------+
| Star Number Density | StarNumberDensity | Gaia catalogs |
+------------------------------+-----------------------------------+-------------------------------------+
| Star FLUX_G Mean / RMS / Std | StarBrightness{Mean,Rms,Std} | Gaia catalogs |
+------------------------------+-----------------------------------+-------------------------------------+
:sup:`1`: `Euclid preparation: I. The Euclid Wide Survey (Scaramella et al, 2022, A&A 662 A112) `.
Keywords (Primary HDU)
++++++++++++++++++++++
The primary HDU is expected to contain the following keywords, characterizing
important parameters of the input product:
.. table::
:width: 100%
+--------------------------------------------------------------------------------------------------+
| **HDU** *PRIMARY*: header |
+==========+==========+================================================================+===========+
| | **Name** | **Description** | **Value** |
+----------+----------+----------------------------------------------------------------+-----------+
| Keywords | SIMPLE | | logical |
+ +----------+----------------------------------------------------------------+-----------+
| | BITPIX | | integer |
+ +----------+----------------------------------------------------------------+-----------+
| | NAXIS | | integer |
+ +----------+----------------------------------------------------------------+-----------+
| | EXTEND | | logical |
+ +----------+----------------------------------------------------------------+-----------+
| | DATE-OBS | e.g. Start date for observations considered | string |
+ +----------+----------------------------------------------------------------+-----------+
| | DATE-END | e.g. End date for observations considered | string |
+ +----------+----------------------------------------------------------------+-----------+
| | TELESCOP | e.g. Euclid or -1 | string |
+ +----------+----------------------------------------------------------------+-----------+
| | INSTRUME | e.g. VIS or -1 | string |
+ +----------+----------------------------------------------------------------+-----------+
| | FILTER | e.g. VIS or -1 | string |
+ +----------+----------------------------------------------------------------+-----------+
| | FILTLST | index for combination of filters if intersection of footprints | string |
+ +----------+----------------------------------------------------------------+-----------+
| | TILEID | e.g. 5237, or -1 if not single tile | integer |
+ +----------+----------------------------------------------------------------+-----------+
| | LISTID | Product ID for a MER list of tiles | string |
+ +----------+----------------------------------------------------------------+-----------+
| | NSIDE_WK | Nside used for mosaic frame to HEALPix | string |
+ +----------+----------------------------------------------------------------+-----------+
| | BITSEL | e.g. Bit mask selection applied based on MER binary values | string |
+ +----------+----------------------------------------------------------------+-----------+
| | INFO | Info collected e.g. Noise, PSF, Seeing, Airmass, SAA etc | string |
+ +----------+----------------------------------------------------------------+-----------+
| | SOFTNAME | | string |
+ +----------+----------------------------------------------------------------+-----------+
| | SOFTVERS | | string |
+ +----------+----------------------------------------------------------------+-----------+
| | SOFTINST | | string |
+----------+----------+----------------------------------------------------------------+-----------+
Time have format 'yyyy-mm-ddThh:mm:ss.sss' and basic software parameters:
* **SOFTNAME**: name of software used [StringKeyword]
* **SOFTVERS**: version of software used [StringKeyword]
* **SOFTINST**: institute developing the software [StringKeyword]
Partial HEALPix Footprint Table (First Extension, Binary Table)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
The following keywords are used to describe what HEALPix conventions are followed:
.. table::
:width: 100%
+------------------------------------------------------------------------------+
| **HDU** *INFO_MAP*: header |
+===============+===============+===========================+==================+
| | **Name** | **Description** | **Value** |
+---------------+---------------+---------------------------+------------------+
| 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 |
+ +---------------+---------------------------+------------------+
| | PIXTYPE | | string |
+ +---------------+---------------------------+------------------+
| | ORDERING | | string |
+ +---------------+---------------------------+------------------+
| | COORDSYS | | string |
+ +---------------+---------------------------+------------------+
| | EXTNAME | | string |
+ +---------------+---------------------------+------------------+
| | NSIDE | | integer |
+ +---------------+---------------------------+------------------+
| | INDXSCHM | | string |
+---------------+---------------+---------------------------+------------------+
.. table::
:width: 100%
+------------------------------------------------------------------------------+
| **HDU** *INFO_MAP*: 3 columns table |
+=========+==========+=================================+==========+============+
| | **Name** | **Description** | **Unit** | **Format** |
+---------+----------+---------------------------------+----------+------------+
| Columns | PIXEL | Index of the HEALPix pixel cell | NA | FITS *K* |
+ +----------+---------------------------------+----------+------------+
| | WEIGHT | Mask value, ranging from O to 1 | NA | FITS *E* |
+ +----------+---------------------------------+----------+------------+
| | ERROR | Mask error value | NA | FITS *E* |
+---------+----------+---------------------------------+----------+------------+
#. **TTYPE1** (= 'PIXEL') [StringKeyword]
#. **TFORM1** (= 'K') [StringKeyword]
#. **TTYPE2** (= 'WEIGHT') [StringKeyword]
#. **TFORM2** (= 'E') [StringKeyword]
#. **PIXTYPE** (= 'HEALPIX') [StringKeyword]
#. **ORDERING** (= 'RING' or 'NESTED') [StringKeyword]
#. **COORDSYS** (= 'C'=celestial, 'E'=ecliptic or 'G'=galactic) [StringKeyword]
#. **EXTNAME** (= 'INFO_MAP') [StringKeyword]
#. **NSIDE** [IntegerKeyword]
#. **INDEXSCHM** (= 'EXPLICIT') [StringKeyword]
The table is then expected to contain the following columns:
* **PIXEL**: 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