.. _SHEKSBTraining:
  
Shear KSB Training
------------------
  
Data product name
=================
.. DataProductNameStart
   
sheKsbTraining
   
.. 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 sheKsbTraining:`
    
This product contains the required training data for the KSB shear estimation
method.

:emphasis:`Documentation for data product element Header:`
    
The generic header of the product.
   
.. SchemaDocTagEnd
   
Data product elements
=====================
.. DataProductElementsStart

Base class: cat:baseCatalog
   
* ValidityRange (ins:calibrationValidPeriod)
* DataStorage (sheKsbTrainingFile)
 * 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

An XML data product containing training data for the KSB shear measurement algorithm. This algorithm requires priors
on the unlensed shapes of galaxies in order to properly estimate errors, and so the training data is generated by
running the KSB algorithm on a reference set of images with minimal (or no) noise. The resulting shape measurements
are stored as the training data in a fits table with the following columns:

+------------------------+----------------+-------------------------------------------------------------------------------+
| Parameter name         | Fits Data type | Brief description                                                             |
+========================+================+===============================================================================+
|OBJECT_ID               | K              | ID of the galaxy in the reference                                             |
+------------------------+----------------+-------------------------------------------------------------------------------+
|SHE_KSB_TRAINING_E1     | E              | Measurement of first component of ellipticity                                 |
+------------------------+----------------+-------------------------------------------------------------------------------+
|SHE_KSB_TRAINING_E2     | E              | Measurement of second component of ellipticity                                |
+------------------------+----------------+-------------------------------------------------------------------------------+
|SHE_KSB_TRAINING_E1_ERR | E              | Error on measurement of first component of ellipticity                        |
+------------------------+----------------+-------------------------------------------------------------------------------+
|SHE_KSB_TRAINING_E2_ERR | E              | Error on measurement of second component of ellipticity                       |
+------------------------+----------------+-------------------------------------------------------------------------------+

The distinction we use betwee "Training" and "Calibration" data is that Training data is data which can be obtained
prior to any observations from Euclid (e.g. from Euclidized HST images), while Calibration data is obtained and updated
throughout the Euclid mission.


   
.. DetailedDescEnd