.. _SHELensMcChains:

Shear LensMC Chains
-------------------

Data product name
=================
.. DataProductNameStart

sheLensMcChains

.. 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 sheLensMcChains:`

This product contains the MCMC chains made by the LensMC shear measurement method for a given observation.

:emphasis:`Documentation for data product element Header:`

The generic header of the product.

.. SchemaDocTagEnd

Data product elements
=====================
.. DataProductElementsStart

* DataStorage (sheLensMcChainsFile)
 * DataContainer (dss:dataContainer)
* Valid (sheValidStatus)

.. DataProductElementsEnd

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

SHE

.. PECreatorEnd

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

LE3

.. PFUsingEnd

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

An XML data product containing MCMC chains fits tables from the LensMC method. This is one of the final outputs of the
Shear Analysis pipeline, and will be passed on to the Shear Reconciliation pipeline.

This product will contain the following catalogContainer object pointing to a fits binary table:

- LensMcChains

Since the storage is a binary table, the table and
its header will be stored in the first extension, with the primary HDU being a default, empty image.

Output Catalog
++++++++++++++

This fits catalog will contain the following header keywords and columns:

LensMCChains
------------

Header keywords:

+--------------+-----------+------------------------------------------------------------------------+
| Keyword name | Optional? | Brief description                                                      |
+==============+===========+========================================================================+
| SS_VER       | No        | Table format version number                                            |
+--------------+-----------+------------------------------------------------------------------------+
| SS_FMT       | No        | Table format label                                                     |
+--------------+-----------+------------------------------------------------------------------------+
| EXTNAME      | No        | HDU label                                                              |
+--------------+-----------+------------------------------------------------------------------------+
| MHASH        | Yes       | Model hash of simulations used as input                                |
+--------------+-----------+------------------------------------------------------------------------+
| MSEED        | Yes       | Model seed of simulations used as input                                |
+--------------+-----------+------------------------------------------------------------------------+
| NSEED        | Yes       | Noise seed of simulations used as input                                |
+--------------+-----------+------------------------------------------------------------------------+
| DATE_OBS     | No        | Date observation was taken                                             |
+--------------+-----------+------------------------------------------------------------------------+
| VALID        | No        | 0: Not tested; 1: Pass; -1: Fail                                       |
+--------------+-----------+------------------------------------------------------------------------+
| LCHAIN       | No        | Number of samples per MCMC chain                                       |
+--------------+-----------+------------------------------------------------------------------------+

Columns:

+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
| Parameter name           | Fits Data type | Brief description                                                                                                            |
+==========================+================+==============================================================================================================================+
|OBJECT_ID                 | K              | Galaxy ID                                                                                                                    |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_FIT_FLAGS      | K              | Set of bit flags based on fit status (see :doc:`she_measurements.rst`)                                                       |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_VAL_FLAGS      | K              | Set of bit flags based on validation status (definition TBD)                                                                 |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_FIT_CLASS      | I              | Classification of object as galaxy (0), star(1), or unknown (2)                                                              |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_G1             | E200           | MCMC chain of 200 samples for G1                                                                                             |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_G2             | E200           | MCMC chain of 200 samples for G2                                                                                             |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_RA             | E200           | MCMC chain of 200 samples for RA                                                                                             |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_DEC            | E200           | MCMC chain of 200 samples for DEC                                                                                            |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_RE             | E200           | MCMC chain of 200 samples for RE                                                                                             |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_FLUX           | E200           | MCMC chain of 200 samples for FLUX                                                                                           |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_BULGE_FRAC     | E200           | MCMC chain of 200 samples for BULGE_FRAC                                                                                     |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_SNR            | E200           | MCMC chain of 200 samples for SNR                                                                                            |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_LR             | E200           | MCMC chain of 200 samples for internal correction likelihood ratio                                                           |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_CHI2           | E200           | Goodness of fit reduced chi-squared                                                                                          |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_DOF            | E              | Number of degrees of freedom                                                                                                 |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_ACCEPTANCE     | E              | MCMC acceptance rate                                                                                                         |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+
|SHE_LENSMC_NEXP           | E              | Number of exposures contributing to the measurements on this object                                                          |
+--------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------+


.. DetailedDescEnd