.. _SHEPSFLevel2CalibrationParameters:
  
Shear PSF Level 2 Calibration Parameters
--------------------------------

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | DpdShePsfLevel2CalibrationParameters                                                         |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | SHE                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | .. raw:: html                                                                                |
|                                                |                                                                                              |
|                                                | `euc-she-PsfLevel2CalibrationParameters.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel |
|                                                | /-/blob/10.1.2/ST_DM_Schema/auxdir/ST_DM_Schema/dpd/she/euc-she-PsfLevel2CalibrationParamete |
|                                                | rs.xsd>`_                                                                                    |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  | **Creators:**                                                                                |
| product                                        |                                                                                              |
|                                                | * SHE_PSF_LE1_LE2_Converter                                                                  |
|                                                |                                                                                              |
|                                                | **Consumers:**                                                                               |
|                                                |                                                                                              |
|                                                | * SHE_PSFToolkit_Fitting_FitPSFs                                                             |
|                                                | * SHE_PSFToolkit_ModelPSFs                                                                   |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | SHE                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Proposed for inclusion in EAS/SAS              | This product is proposed for inclusion in the SAS: no                                        |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Detailed description of the data product
========================================
.. DetailedDescStart

PSF Level2 Calibration parameters, giving the current state of the telescope after fitting to defocused and infocus 
data at multiple solar angles and roll angles. 

Will include a basis set of Zernike amplitude/telescope optical layout parameters which describe wavefront propagation 
through the system, expected to consist of < 100 params (floats).

Detector state format TBD, will include parameters describing the brighter-fatter effect, chip-to-chip variation.

Will contain parameters describing the FOV-dependent mapping between the telescope model (optical layout) and zernike 
amplitudes, as a list of coefficients to a polynomial fit. TBD.

Output File
===========

The FITS output file will contain the following information:

**HDU List**

   
*Primary Header*
________________

The primary head will contain the following additional information:

.. table::
   :width: 100%

   +-------------------------------------------------------------------------------------+
   |                              **HDU** *PRIMARY*: header                              |
   +==========+==========+=================+=============================================+
   |          | **Name** | **Description** |                  **Value**                  |
   +----------+----------+-----------------+---------------------------------------------+
   | Keywords | DATE-FIT |                 |                    string                   |
   +          +----------+-----------------+---------------------------------------------+
   |          | FITS_VER |                 |                 string = 9.0                |
   +          +----------+-----------------+---------------------------------------------+
   |          | FITS_DEF |                 | string = she.psfLevel2CalibrationParameters |
   +----------+----------+-----------------+---------------------------------------------+


*Basis Zernike Mode Parameters*
_________________________

A basis set of the Zernike mode parameters from the PSF Level1 Calibration Parameters products at
different solar-aspect and roll angles. 

.. table::
   :width: 100%

   +---------------------------------------------------------------------------------------------------------------+
   |                                  **HDU** *SheBasisZernikeModeParams*: header                                  |
   +==========+==========+=================+=======================================================================+
   |          | **Name** | **Description** |                               **Value**                               |
   +----------+----------+-----------------+-----------------------------------------------------------------------+
   | Keywords | FITS_VER |                 |                              string = 9.0                             |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | FITS_DEF |                 | string = she.psfLevel2CalibrationParameters.SheBasisZernikeModeParams |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | NZERNMDE |                 |                                integer                                |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | NPLOYCFF |                 |                                integer                                |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | NLEVEL1  |                 |                                integer                                |
   +----------+----------+-----------------+-----------------------------------------------------------------------+

.. table::
   :width: 100%

   +---------------------------------------------------------------------------------------------------------------+
   |                              **HDU** *SheBasisZernikeModeParams*: 1 columns table                             |
   +==========+========================================+=====================+============+========================+
   |          |                **Name**                |   **Description**   |  **Unit**  |       **Format**       |
   +----------+----------------------------------------+---------------------+------------+------------------------+
   | Columns  |     BASIS_SET_ZERNIKE_POLY_AMP_WFE     |                     |     NA     |    FITS *PE(10000)*    |
   +----------+----------------------------------------+---------------------+------------+------------------------+


*Mean Detector Model Parameters*
___________________________

The mean detector model parameters from the PSF Level1 Calibration Parameters products at
different solar-aspect and roll angles.

.. table::
   :width: 100%

   +----------------------------------------------------------------------------------------------------------------+
   |                                  **HDU** *SheMeanDetectorModelParams*: header                                  |
   +==========+==========+=================+========================================================================+
   |          | **Name** | **Description** |                               **Value**                                |
   +----------+----------+-----------------+------------------------------------------------------------------------+
   | Keywords | FITS_VER |                 |                              string = 9.0                              |
   +          +----------+-----------------+------------------------------------------------------------------------+
   |          | FITS_DEF |                 | string = she.psfLevel2CalibrationParameters.SheMeanDetectorModelParams |
   +----------+----------+-----------------+------------------------------------------------------------------------+

.. table::
   :width: 100%

   +----------------------------------------------------------------------------------------------------------------+
   |                             **HDU** *SheMeanDetectorModelParams*: 4 columns table                              |
   +===========+======================================+=======================+=============+=======================+
   |           |               **Name**               |    **Description**    |   **Unit**  |       **Format**      |
   +-----------+--------------------------------------+-----------------------+-------------+-----------------------+
   |  Columns  |               DET_IDX                |                       |      NA     |        FITS *I*       |
   +           +--------------------------------------+-----------------------+-------------+-----------------------+
   |           |                DET_IX                |                       |      NA     |        FITS *I*       |
   +           +--------------------------------------+-----------------------+-------------+-----------------------+
   |           |                DET_IY                |                       |      NA     |        FITS *I*       |
   +           +--------------------------------------+-----------------------+-------------+-----------------------+
   |           |      MEAN_GAUSSIAN_KERNAL_COEFF      |                       |      NA     |     FITS *PE(36)*     |
   +-----------+--------------------------------------+-----------------------+-------------+-----------------------+


*Mean Spectral Throughput Parameters*
___________________________

The mean spectral throughput parameters from the PSF Level1 Calibration Parameters products at
different solar-aspect and roll angles.

.. table::
   :width: 100%

   +---------------------------------------------------------------------------------------------------------------+
   |                                   **HDU** *ShePsfCalMeanSpecThrough*: header                                  |
   +==========+==========+=================+=======================================================================+
   |          | **Name** | **Description** |                               **Value**                               |
   +----------+----------+-----------------+-----------------------------------------------------------------------+
   | Keywords | FITS_VER |                 |                              string = 9.0                             |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | FITS_DEF |                 | string = she.she.psfLevel2CalibrationParameters.ShePsfMeanSpecThrough |
   +          +----------+-----------------+-----------------------------------------------------------------------+
   |          | NPLYCFF  |                 |                                integer                                |
   +----------+----------+-----------------+-----------------------------------------------------------------------+

.. table::
   :width: 100%

   +---------------------------------------------------------------------------------------------------------------+
   |                              **HDU** *ShePsfCalMeanSpecThrough*: 1 columns table                              |
   +===========+==========================================+=====================+============+=====================+
   |           |                 **Name**                 |   **Description**   |  **Unit**  |      **Format**     |
   +-----------+------------------------------------------+---------------------+------------+---------------------+
   |  Columns  |     MEAN_SPEC_THROUGHPUT_POLY_COEFF      |                     |     NA     |    FITS *PE(10)*    |
   +-----------+------------------------------------------+---------------------+------------+---------------------+


.. DetailedDescEnd