.. include:: ../../clsubstitutions.txt
.. _richclMembers:

Galaxy Membership Output Product
===================================

Metadata
______________________

+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product name                              | DpdLE3clRichMembers                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Data product custodian                         | CLRICHCL                                                                                     |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Name of the Schema file                        | .. raw:: html                                                                                |
|                                                |                                                                                              |
|                                                | `euc-le3-cl-richcl-member.xsd <https://gitlab.euclid-sgs.uk/ST-DM/ST_DataModel/-/blob/10.1.2 |
|                                                | /ST_DM_Schema/auxdir/ST_DM_Schema/dpd/le3/cl/euc-le3-cl-richcl-member.xsd>`_                 |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Last Edited for DPDD Version                   | 1.1                                                                                          |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing Element(s) creating/using the data  | **Creators:**                                                                                |
| product                                        |                                                                                              |
|                                                | * LE3_RICH_CL                                                                                |
|                                                |                                                                                              |
|                                                | **Consumers:**                                                                               |
|                                                |                                                                                              |
|                                                | * LE3_RICH_CL                                                                                |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Processing function using the data product     | * RICH-CL                                                                                    |
|                                                | * SEL-CL                                                                                     |
|                                                | * CAT-CL                                                                                     |
+------------------------------------------------+----------------------------------------------------------------------------------------------+
| Proposed for inclusion in EAS/SAS              | This product is proposed for inclusion in the SAS: Yes                                       |
|                                                |                                                                                              |
|                                                | It is part of the output products from RICH-CL, and needs to be recorded (independently of   |
|                                                | its inclusion in CAT-CL output product).                                                     |
+------------------------------------------------+----------------------------------------------------------------------------------------------+

Data Product Elements
______________________
+--------------+----------------------------------------------+
| Header       | object of type sys:genericHeader             |
+--------------+----------------------------------------------+
| Data         | object of type cl:clustersRichMembers        |
+--------------+----------------------------------------------+
| QualityFlags | object of type dqc:sqfPlaceHolder            |
+--------------+----------------------------------------------+
| Parameters   | object of type ppr:genericKeyValueParameters |
+--------------+----------------------------------------------+

Detailed Description of the Data Product
_________________________________________
.. DetailedDescStart

This output product contains the galaxy membership estimates of the candidate clusters, from RICH-CL

This output data product contains the list of the membership associations of the galaxies in the detected clusters. This RICH-CL data product is similar to the detclMembers_

.. _detclMembers: http://euclid.esac.esa.int/dm/dpdd/latest/le3dpd/cl/det-cl/dpcards/det-cloutMembers.html

output produced by the AMICO cluster detection code in PF DET-CL.

Keywords
+++++++++++++

This fits file is expected to contain the following keywords in the primary HDU,
characterizing the important parameters of the product:


#. **DET_CODE**: DETECTION PARAMETERS
#. **MODEL_ID**: Name that identifies the adopted model used in the filtering procedure
#. **SNR_THR**: the S/N threshold for extracting a detection
#. **MAX_NB**: SPECIFIC RICH PARAMETERS Maximum number of structures to which a galaxy can be associated
#. **MIN_PROB**: Minimum probability for the association to be saved


Table
+++++++++++++

The richclMembers table is expected to contain the following columns, for each detected cluster:

.. table::
   :width: 100%

   +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   |                                                                                **Catalog**: 14 columns table                                                                                |
   +=============================+=======================================================================================================================================+==========+============+
   |           **Name**          |                                                            **Description**                                                            | **Unit** | **Format** |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |          OBJECT_ID          |                          Galaxy identifier, as it appears in detclGalaxies (see Galaxy catalog Input Product)                         |    NA    |  FITS *K*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |          ID_CLUSTER         |                           Identifier of the associated cluster, as it appears out of DET-CL clusters catalog                          |    NA    |  FITS *K*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |             PMEM            | probability (0 LE p LE 1) of the galaxy membership in cluster OBJECT_ID, according to Pmem method. Note that PMEM = PMEM_RAD * PMEM_Z |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |          PMEM_LERR          |                                error associated with PMEM (lower/left side), according to Pmem method                                 |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |          PMEM_UERR          |                                error associated with PMEM (upper/right side), according to Pmem method                                |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |           PMEM_RAD          |                                    Cluster-centric (i.e. tangential for observer) component of PMEM                                   |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |            PMEM_Z           |                                         Redshift (i.e. along line of sight) component of PMEM                                         |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |           PMEM_RS           |               probability (0 LE p LE 1) of the galaxy membership in cluster OBJECT_ID, according to RedSequence method                |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |         PMEM_LERR_RS        |                             error associated with PMEM (lower/left side), according to RedSequence method                             |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |         PMEM_UERR_RS        |                             error associated with PMEM (upper/right side), according to RedSequence method                            |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |     DIST_TO_CL_MPC_PMEM     |                                                 distance to PMEM cluster center in Mpc                                                |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   | DIST_TO_CL_OVER_RADIUS_PMEM |                                  distance to PMEM cluster center, normalized by PMEM radius estimate                                  |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |      DIST_TO_CL_MPC_RS      |                                                  Distance to RS cluster center in Mpc                                                 |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+
   |  DIST_TO_CL_OVER_RADIUS_RS  |                                     Distance to RS cluster center,normalized by RS Radius estimate                                    |    NA    |  FITS *E*  |
   +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------+----------+------------+


.. DetailedDescEnd