.. _SHEPSFFieldParameters: Shear PSF Field Parameters -------------------------- Metadata ______________________ +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product name | DpdShePsfFieldParameters | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Data product custodian | SHE | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Name of the Schema file | .. raw:: html | | | | | | `euc-she-PsfFieldParameters.xsd `_ | +------------------------------------------------+----------------------------------------------------------------------------------------------+ | Processing Element(s) creating/using the data | **Creators:** | | product | | | | * SHE_PSFToolkit_Fitting_FitPSFs | | | | | | **Consumers:** | | | | | | * 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 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. Name of file: ``EUC_SHE_PSF-FIELDPARAMS_[OBSERVATION_ID]_[YYYYMMDDThhmmss.s]Z_[VERSION].fits`` where ``OBSERVATION_ID`` is the observation ID for this field, ``YYYYMMDDThhmmss.s`` is the time the product was created in UTC, and ``VERSION`` is the version number of the SHE pipeline used to create the data product. The FITS output file will contain the following information: 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 | FITS_VER | | string = 9.0 | + +----------+-----------------+---------------------------------+ | | FITS_DEF | | string = she.psfFieldParameters | + +----------+-----------------+---------------------------------+ | | DATE-FIT | | string | + +----------+-----------------+---------------------------------+ | | EXP_PID | | string | + +----------+-----------------+---------------------------------+ | | OBS_ID | | integer | + +----------+-----------------+---------------------------------+ | | PNT_ID | | integer | + +----------+-----------------+---------------------------------+ | | DATE_OBS | | string | +----------+----------+-----------------+---------------------------------+ *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.psfFieldParameters.SheTelescopeModeParams | +----------+----------+-----------------+--------------------------------------------------------+ .. table:: :width: 100% +------------------------------------------------------------------------------------------------+ | **HDU** *SheTelescopeModeParams*: 19 columns table | +===========+===============================+=====================+============+=================+ | | **Name** | **Description** | **Unit** | **Format** | +-----------+-------------------------------+---------------------+------------+-----------------+ | Columns | SHE_PSF_FIELD_M1TRAD | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2TRAD | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_FOM1TRFN | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_FOM2TRFN | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3TRAD | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_DIC_TRFN | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M1TCON | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2TCON | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3TCON | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2TZ | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2TX | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2TY | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2RX | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M2RY | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3TZ | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3TX | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3TY | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3RX | | NA | FITS *E* | + +-------------------------------+---------------------+------------+-----------------+ | | SHE_PSF_FIELD_M3RY | | NA | FITS *E* | +-----------+-------------------------------+---------------------+------------+-----------------+ *Zernike Basis Coefficients* _________________________ These coefficients are the weights for the she.psfLevel2CalibrationParameters.SheBasisZernikeModeParams to find the best fit Zernike parameters from the array of Zernike modes at different roll angle and solar-aspect angle using the roll angle and solar-aspect angle of the field observation. .. table:: :width: 100% +-----------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeBasisCoeffs*: header | +==========+==========+=================+=======================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+-------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+-------------------------------------------------------+ | | FITS_DEF | | string = she.psfFieldParameters.SheZernikeBasisCoeffs | + +----------+-----------------+-------------------------------------------------------+ | | NLEVEL1 | | integer | +----------+----------+-----------------+-------------------------------------------------------+ .. table:: :width: 100% +-----------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeBasisCoeffs*: 2 columns table | +===========+===========================+=====================+============+====================+ | | **Name** | **Description** | **Unit** | **Format** | +-----------+---------------------------+---------------------+------------+--------------------+ | Columns | LEVEL1_BASIS_INDEX | | NA | FITS *PE(20)* | + +---------------------------+---------------------+------------+--------------------+ | | BASIS_ZERN_AMP_COEFF | | NA | FITS *PE(20)* | +-----------+---------------------------+---------------------+------------+--------------------+ *Zernike Mode Parameters* _________________________ The Zernike mode parameters describe the wavefront errors as a set of orthoganol functions that change in radial and azimuthal degree. For field fitting, many parameters are derived from the solar-aspect and roll angle using the Level 2 calibration product, but others that are strongly linked to focus are fitted for. 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. .. table:: :width: 100% +----------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeModeParams*: header | +==========+==========+=================+======================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+------------------------------------------------------+ | | FITS_DEF | | string = she.psfFieldParameters.SheZernikeModeParams | + +----------+-----------------+------------------------------------------------------+ | | NZERNMDE | | integer | + +----------+-----------------+------------------------------------------------------+ | | NPLOYCFF | | integer | +----------+----------+-----------------+------------------------------------------------------+ .. table:: :width: 100% +----------------------------------------------------------------------------------------------+ | **HDU** *SheZernikeModeParams*: 1 columns table | +==========+===========================+====================+============+=====================+ | | **Name** | **Description** | **Unit** | **Format** | +----------+---------------------------+--------------------+------------+---------------------+ | Columns | ZERNIKE_POLY_AMP_WFE | | NA | FITS *PE(500)* | +----------+---------------------------+--------------------+------------+---------------------+ *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** *ShePsfFieldFisherMatrix*: header | +==========+==========+=================+============================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+------------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+------------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfFieldParameters.SheDetectorModelParams | +----------+----------+-----------------+------------------------------------------------------------+ .. table:: :width: 100% +----------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfFieldFisherMatrix*: 1 columns table | +===========+=============================+=====================+============+=======================+ | | **Name** | **Description** | **Unit** | **Format** | +-----------+-----------------------------+---------------------+------------+-----------------------+ | Columns | FISHER_MATRIX_ZNK_WFE | | NA | FITS *PE(2500)* | +-----------+-----------------------------+---------------------+------------+-----------------------+ *Star Residual Parameters* ___________________________ Details of the fit for each star used: how well the PSF models each individual star. .. table:: :width: 100% +---------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfFieldStarResiduals*: header | +==========+==========+=================+===========================================================+ | | **Name** | **Description** | **Value** | +----------+----------+-----------------+-----------------------------------------------------------+ | Keywords | FITS_VER | | string = 9.0 | + +----------+-----------------+-----------------------------------------------------------+ | | FITS_DEF | | string = she.she.psfFieldParameters.SheFieldStarResiduals | +----------+----------+-----------------+-----------------------------------------------------------+ .. table:: :width: 100% +---------------------------------------------------------------------------------------------------+ | **HDU** *ShePsfFieldStarResiduals*: 15 columns table | +===========+=============================+======================+============+=====================+ | | **Name** | **Description** | **Unit** | **Format** | +-----------+-----------------------------+----------------------+------------+---------------------+ | Columns | OBJECT_ID | | NA | FITS *K* | + +-----------------------------+----------------------+------------+---------------------+ | | EXPOSURE_PRODUCT_ID | | NA | FITS *K* | + +-----------------------------+----------------------+------------+---------------------+ | | 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.psfFieldParameters.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* | +------------+----------------------------+-----------------------+-------------+-------------------+ *Diagnostic 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.psfFieldParameters.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