.. _SHEPSFLevel1CalibrationParameters: Shear PSF Level 1 Calibration Parameters -------------------------------- Metadata ______________________ +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product name | DpdShePsfLevel1CalibrationParameters | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product custodian | SHE | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Name of the Schema file | .. raw:: html | | | | | | `euc-she-PsfLevel1CalibrationParameters.xsd `_ | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Processing Element(s) creating/using the data | **Creators:** | | product | | | | * SHE_CompareDefocPSFState | | | | | | **Consumers:** | | | | | | * SHE_ConvertLE1ProductToQuadrants | | | * SHE_PSF_LE1_LE2_Converter | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | 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 Level1 Calibration parameters, giving the current state of the telescope after fitting to defocused and infocus data at a particular roll angle. Will include a 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. 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), for the stellar images used in the calibration CTI residual parameterisation 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.psfLevel1CalibrationParameters | + +----------+-----------------+---------------------------------------------+ | | NPIECES | | integer | +----------+----------+-----------------+---------------------------------------------+ *Telescope Mode parameters* ___________________________ These are parameters that describe mirror movements, based on a ray tracing model. .. table:: :width: 100% +------------------------------------------------------------------------------------------------------------+ | **HDU** *SheTelescopeModeParams*: header | +==========+==========+=================+====================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+--------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+--------------------------------------------------------------------+ | | FITS_DEF | | string = she.psfLevel1CalibrationParameters.SheTelescopeModeParams | +----------+----------+-----------------+--------------------------------------------------------------------+ .. table:: :width: 100% +------------------------------------------------------------------------------------------------------------+ | **HDU** *SheTelescopeModeParams*: 19 columns table | +============+=================================+=========================+==============+====================+ | | **Name** | **Description** | **Unit** | **Format** | +------------+---------------------------------+-------------------------+--------------+--------------------+ | Columns | SHE_PSF_CAL_M1TRAD | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2TRAD | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_FOM1TRFN | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_FOM2TRFN | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3TRAD | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_DIC_TRFN | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M1TCON | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2TCON | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3TCON | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2TZ | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2TX | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2TY | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2RX | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M2RY | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3TZ | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3TX | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3TY | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3RX | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+--------------------+ | | SHE_PSF_CAL_M3RY | | NA | FITS *E* | +------------+---------------------------------+-------------------------+--------------+--------------------+ *Zernike Mode Parameters* _________________________ The Zernike mode parameters describe the wavefront errors as a set of orthoganol functions that change in radial and azimuthal degree. A subset of all possible Zernike modes are used to describe the wavefront error. The coefficients are a combination of the modes that are related to different optical effects and polynomial functions that describe the variation across the field-of-view. A combination of defocused and infocus data helps to break the degeneracy between some of the different modes. .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeModeParams*: header | +==========+==========+=================+==================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+------------------------------------------------------------------+ | | FITS_DEF | | string = she.psfLevel1CalibrationParameters.SheZernikeModeParams | + +----------+-----------------+------------------------------------------------------------------+ | | NZERNMDE | | integer | + +----------+-----------------+------------------------------------------------------------------+ | | NPLOYCFF | | integer | +----------+----------+-----------------+------------------------------------------------------------------+ .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeModeParams*: 4 columns table | +============+==============================+=======================+=============+========================+ | | **Name** | **Description** | **Unit** | **Format** | +------------+------------------------------+-----------------------+-------------+------------------------+ | Columns | PIECEWISE_ID | | NA | FITS *I* | + +------------------------------+-----------------------+-------------+------------------------+ | | FOV_RANGE_X | | pixel | FITS *PE(2)* | + +------------------------------+-----------------------+-------------+------------------------+ | | FOV_RANGE_Y | | pixel | FITS *PE(2)* | + +------------------------------+-----------------------+-------------+------------------------+ | | ZERNIKE_POLY_AMP_WFE | | NA | FITS *PE(500)* | +------------+------------------------------+-----------------------+-------------+------------------------+ *Detector Model Parameters* ___________________________ TBD. These are effects due to the detector electronics, such as the brighter-fatter effect. .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------------+ | **HDU** *SheDetectorModelParams*: header | +==========+==========+=================+========================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+------------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+------------------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfLevel1CalibrationParameters.SheDetectorModelParams | +----------+----------+-----------------+------------------------------------------------------------------------+ .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------------+ | **HDU** *SheDetectorModelParams*: 5 columns table | +============+==================================+========================+==============+========================+ | | **Name** | **Description** | **Unit** | **Format** | +------------+----------------------------------+------------------------+--------------+------------------------+ | Columns | PIECEWISE_ID | | NA | FITS *I* | + +----------------------------------+------------------------+--------------+------------------------+ | | DET_IDX | | NA | FITS *I* | + +----------------------------------+------------------------+--------------+------------------------+ | | DET_IX | | NA | FITS *I* | + +----------------------------------+------------------------+--------------+------------------------+ | | DET_IY | | NA | FITS *I* | + +----------------------------------+------------------------+--------------+------------------------+ | | GAUSSIAN_KERNAL_COEFF | | NA | FITS *PE(36)* | +------------+----------------------------------+------------------------+--------------+------------------------+ *Spectral Throughput Parameters* ___________________________ A polynomial model describing the derived spectral throughput. .. table:: :width: 100% +--------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalSpecThrough*: header | +==========+==========+=================+======================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+----------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+----------------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfLevel1CalibrationParameters.ShePsfCalSpecThrough | + +----------+-----------------+----------------------------------------------------------------------+ | | NPLYCFF | | integer | +----------+----------+-----------------+----------------------------------------------------------------------+ .. table:: :width: 100% +--------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalSpecThrough*: 1 columns table | +===========+======================================+======================+=============+======================+ | | **Name** | **Description** | **Unit** | **Format** | +-----------+--------------------------------------+----------------------+-------------+----------------------+ | Columns | SPEC_THROUGHPUT_POLY_COEFF | | NA | FITS *PE(10)* | +-----------+--------------------------------------+----------------------+-------------+----------------------+ *Fisher Matrix Parameters* ___________________________ The Fisher matrix parameters calculated from the maximum likelihood fit of the model to the stars in these field. .. table:: :width: 100% +---------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalFisherMatrix*: header | +==========+==========+=================+=======================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+-----------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+-----------------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfLevel1CalibrationParameters.ShePsfCalFisherMatrix | +----------+----------+-----------------+-----------------------------------------------------------------------+ .. table:: :width: 100% +---------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalFisherMatrix*: 3 columns table | +============+================================+========================+=============+==========================+ | | **Name** | **Description** | **Unit** | **Format** | +------------+--------------------------------+------------------------+-------------+--------------------------+ | Columns | PIECEWISE_ID | | NA | FITS *I* | + +--------------------------------+------------------------+-------------+--------------------------+ | | FISHER_MATRIX_ZNK_WFE | | NA | FITS *PE(2500)* | + +--------------------------------+------------------------+-------------+--------------------------+ | | FISHER_MATRIX_DET | | NA | FITS *PE(25)* | +------------+--------------------------------+------------------------+-------------+--------------------------+ *Star Residual Parameters* ___________________________ Details of the fit for each star used: how well the PSF models each individual star. .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalStarResiduals*: header | +==========+==========+=================+========================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+------------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+------------------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfLevel1CalibrationParameters.ShePsfCalStarResiduals | +----------+----------+-----------------+------------------------------------------------------------------------+ .. table:: :width: 100% +----------------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfCalStarResiduals*: 16 columns table | +=============+=================================+=========================+==============+=======================+ | | **Name** | **Description** | **Unit** | **Format** | +-------------+---------------------------------+-------------------------+--------------+-----------------------+ | Columns | OBJECT_ID | | NA | FITS *K* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | EXPOSURE_PRODUCT_ID | | NA | FITS *K* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | PIECEWISE_ID | | NA | FITS *I* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | DET_IDX | | NA | FITS *I* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | X_POS | | pixel | FITS *E* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | Y_POS | | pixel | FITS *E* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | FOV_X | | deg | FITS *D* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | FOV_Y | | deg | FITS *D* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | STAR_WEIGHT | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | REGION_SIZE | | pixel | FITS *I* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | RESIDUAL_RMS | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | STAR_PSF_CHISQ | | NA | FITS *E* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | STAR_NDOF | | NA | FITS *I* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | MOMENTS_OF_FIT | | NA | FITS *PE(2)* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | MOMENTS_OF_DATA | | NA | FITS *PE(2)* | + +---------------------------------+-------------------------+--------------+-----------------------+ | | MOMENTS_OF_RESIDUALS | | NA | FITS *PE(2)* | +-------------+---------------------------------+-------------------------+--------------+-----------------------+ *Toolkit Input Parameters* ___________________________ The parameters used in the configuration of the SHE_PSF_Toolkit software. .. table:: :width: 100% +---------------------------------------------------------------------------------------------------------------+ | **HDU** *SheToolkitInputParams*: header | +==========+==========+=================+=======================================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+-----------------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+-----------------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psflevel1CalibrationParameters.SheToolkitInputParams | +----------+----------+-----------------+-----------------------------------------------------------------------+ .. table:: :width: 100% +---------------------------------------------------------------------------------------------------------------+ | **HDU** *SheToolkitInputParams*: 2 columns table | +=============+================================+===========================+===============+====================+ | | **Name** | **Description** | **Unit** | **Format** | +-------------+--------------------------------+---------------------------+---------------+--------------------+ | Columns | TOOLKIT_PARAM_NAME | | NA | FITS *40A* | + +--------------------------------+---------------------------+---------------+--------------------+ | | TOOLKIT_VALUE | | NA | FITS *60A* | +-------------+--------------------------------+---------------------------+---------------+--------------------+ *Diagnositic Parameters* ___________________________ The chi-squared and number of degrees of freedom of the fit. .. table:: :width: 100% +-------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfDiagnostics*: header | +==========+==========+=================+===============================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+---------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+---------------------------------------------------------------+ | | FITS_DEF | | string = she.psfLevel1CalibrationParameters.ShePsfDiagnostics | +----------+----------+-----------------+---------------------------------------------------------------+ .. table:: :width: 100% +-------------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfDiagnostics*: 2 columns table | +============+=============================+=========================+==============+===================+ | | **Name** | **Description** | **Unit** | **Format** | +------------+-----------------------------+-------------------------+--------------+-------------------+ | Columns | CHI_SQUARED_OF_FIT | | NA | FITS *E* | + +-----------------------------+-------------------------+--------------+-------------------+ | | NUMBER_DOF_OF_FIT | | NA | FITS *I* | +------------+-----------------------------+-------------------------+--------------+-------------------+ .. DetailedDescEnd