.. _NIRRelPhotoDetCalibration:
  
[to complete]  NIR Relative Photometric Calibration factors among Detectors
==============================================================

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | DpdNirRelPhotoDetCalibration                                                                 |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | NIR                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | .. raw:: html                                                                                |
|                                                |                                                                                              |
|                                                | `euc-nir-RelPhotoDetCalibration.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/ |
|                                                | 10.1.2/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/nir/euc-nir-RelPhotoDetCalibration.xsd>`_        |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  | The **DpdNirRelPhotoDetCalibration** is created by the *NIR_SelfCalib_Pipeline*. This        |
| product                                        | pipeline compare source fluxes extracted in                                                  |
|                                                | dedicated Self Calibration Field observations to derive detector by detector flux variations |
|                                                | offset together with                                                                         |
|                                                | LargeScale pixel by pixel variations tracked by the :ref:`NIRLargeFlat` Data Product.        |
|                                                |                                                                                              |
|                                                | The task responsible for the DpdNirRelPhotoDetCalibration creation is **NIR_Compute** (under |
|                                                | *NIR_SelfCalib* project).                                                                    |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | This is an internal NIR data product, and it is used only by the NIR PF.                     |
|                                                |                                                                                              |
|                                                | It is applied by the **NIR_apply_relative_calibrations** task (under                         |
|                                                | *NIR_RelativePhotometry* project) inside the *NIR_ProcessField_Pipeline*.                    |
|                                                | The task writes the photometric offset and corresponding error in *PHRELDT* and *PHRELDTE*   |
|                                                | keywords respectively                                                                        |
|                                                | on detector headers of scientific images.                                                    |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Data Product structure description
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. DataProductDescrStart

The main elements inside the *Data* section are:

* **Filter**: The filter name (e.g. NIR_Y, NIR_J, NIR_H)
* **ValidityRange**: Calibration file validity period estimated
* **CorrectionFactorList**: a list of single detector correction factors
    * **Value**: detector photometric correction factor
    * **Error**: detector photometric correction factor error
    * **DetectorId**: detector Id

.. DataProductDescrEnd

.. DetailedDescEnd