.. _SHEPSFFieldParameters:
  
Shear PSF Field Parameters
--------------------------
  
Data product name
=================
.. DataProductNameStart
   
shePsfFieldParameters
   
.. DataProductNameEnd
   
Data product custodian
======================
.. DataProductCustodianStart
   
SHE
   
.. DataProductCustodianEnd
   
Data model tag
==============
.. DataModelTagStart
   
8.0
   
.. DataModelTagEnd
   
Name of the Schema file
=======================
.. NameSchemaStart
   
ST_DM_Schema/dictionary/pro/she/euc-test-she.xsd
   
.. NameSchemaEnd
   
Schema documentation tag
========================
.. SchemaDocTagStart
   
:emphasis:`Documentation for data product element shePsfFieldParameters:`
    
This product contains the parameters for the Shear PSF Field.

:emphasis:`Documentation for data product element Header:`
    
The generic header of the product.

   
.. SchemaDocTagEnd
   
Data product elements
=====================
.. DataProductElementsStart
   
* DataStorage (shePsfFieldParametersFile)
 * DataContainer (dss:dataContainer)

.. DataProductElementsEnd
   
Processing Element(s) creating/using the data product
=====================================================
.. PECreatorStart

SHE
   
.. PECreatorEnd
   
Processing function using the data product
==========================================
.. PFUsingStart

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

PSF field parameters product, giving the telescope state for a given exposure. Parameterisation for this data model 
largely consists of a subset of those included in the she_psfcalibration data product, as it is limited to only those 
parameters which are expected to vary on an exposure-to-exposure time scale (or on a time scale less than calibration 
observation cadence). Finalised Format TBD.

The FITS output file will contain the following information:

**HDU List**

#. *Telescope Mode parameters*
#. *Zernike Mode Parameters*
#. *Other model parameters*
#. *Diagnostics*

*Primary Header*
________________

The primary head will contain the following additional information:

#. *Time Stamp*: Indentifies the date and time of fit.
#. *VIS ExtName*: Identifies the VIS exposure that this is linked to  
   
*Telescope Mode parameters*
___________________________

Currently 19 telescope model parameters are considered:

* *TCON*: Change in conicity
* *TRAD*: Perturbations on radius of element
* *TFRN*: FOM1,2,3 only. Flatness of mirror
* *TX*: Translation in X (plane of exit pupil)
* *TY*: Translation in Y (plane of exit pupil)
* *TZ*: Translation in Z
* *RX*: Rotation in X
* *RY*: Rotation in Y

The catalogue will contain the following columns

+------------------------+----------+---------------+
| Parameter name         | Element  | Type          |
+========================+==========+===============+
| SHE_PSF_FIELD_M1TRAD   | M1       | Radial        |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2TRAD   | M2       | Radial        |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_FOM1TFRN | FOM1     | Flatness      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_FOM2TFRN | FOM2     | Flatness      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3TRAD   | M3       | Radial        |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_DIC_TFRN | Dichroic | Flatness      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M1TCON   | M1       | Conicity      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2TCON   | M2       | Conicity      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3TCON   | M3       | Conicity      |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2TZ     | M2       | Translation Z |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2TX     | M2       | Translation X |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2TY     | M2       | Translation Y |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2RX     | M2       | Rotation X    |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M2RY     | M2       | Rotation Y    |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3TZ     | M3       | Translation Z |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3TX     | M3       | Translation X |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3TY     | M3       | Translation Y |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3RX     | M3       | Rotation X    |
+------------------------+----------+---------------+
| SHE_PSF_FIELD_M3RY     | M3       | Rotation Y    |
+------------------------+----------+---------------+


*Zernike Mode Parameters*
_________________________

Zernike fit parameters refer to Zernike Polynomial amplitudes themselves. The FITS catalogue will contain the following 
columns:

#. *SHE_PSF_FIELD_FOVRNGX*: Region of fit on the field of view in X
#. *SHE_PSF_FIELD_FOVRNGY*: Region of fit on the field of view in Y
#. *SHE_PSF_FIELD_ZNKPLYAMP*: List of Zernike Polynomial amplitudes 

*Diagnostics*
_____________

Diagnostics includes information used to verify the quality of the fit on a per-training object basis. The catalogue 
form is TBF, but is expected to contain a list of stellar object identifiers, as well as :math:`\chi^2` for each.
   
Will include catalogue of star identifier with :math:`\chi^2` value per star, to satisfy R-SHE-PRD-F-100, as well as sub-pixel 
stellar position on the detector (2 floats).
   
.. DetailedDescEnd