.. _SIMGalaxyCatalogProduct:
  
Galaxy Catalog Product
======================

$SetSchemaPath sim/euc-sim-GalaxyCatalogProduct.xsd

Data Product Name
_________________
.. DataProductNameStart

$PrintDataProductName

.. DataProductNameEnd

Data Product Custodian
______________________
.. DataProductCustodianStart

$PrintDataProductCustodian

.. DataProductCustodianEnd

Name of the Schema File
________________________
.. NameSchemaStart

$PrintSchemaFilename

.. NameSchemaEnd


Last Edited for DPDD Version
____________________________
.. DpddVersionlTagStart

1.1

.. DpddVersionTagEnd


Processing Elements Creating / Updating / Using the Product
___________________________________________________________

.. PECreatorStart

**Creators:**

These catalogs are created by the CosmoSIM SWG, outside of the SIM PF.

**Consumers:**

Processing elements using the data product:

* SIM_Tools/EuclidTU
* SIM_Tools/ComputeFluxes
* SIM_ELViS_Simulator/EuclidVis
* SIM_TIPS_Simulator/EuclidNis
* SIM_Imagem/EuclidNip
* SIM_EXT/EuclidExt

.. PECreatorEnd


Processing Function using the products
______________________________________
.. PFUsingStart

SIM_Tools, SIM_ELViS_Simulator, SIM_TIPS_Simulator, SIM_Imagem, SIM_EXT

.. PFUsingEnd

Proposed for inclusion in EAS/SAS
_________________________________

.. IncludeInSASStart

This product is proposed for inclusion in the SAS: no

These catalogs are for internal use.

.. IncludeInSASEnd

Data Product Elements
_____________________
.. DataProductElementsStart

$PrintDataProductElements

.. DataProductElementsEnd

Detailed Description of the Data Product
________________________________________
.. DetailedDescStart

A GalaxyCatalogProduct contains the following elements that describe a sky patch and associated information required to reconstruct galaxy spectra:

* **GalaxyCatalog**: Galaxy catalogue filename, associated with the area it covers on the sky
* **SedLibrary**: Library identifier, and data container to a the galaxy SEDs templates used to produce galaxy spectra
* **ExtinctionLawLibrary**: Library identifier, and data container to the Extinction laws used to produce the galaxy spectra
* **ReferenceFilterFile**: Data container with the filter throughput filename, used to renormalize the galaxy templates to apparent flux. 
* **StampsLibrary**: List of FITS files containing galaxy image thumbnails to paste in the simulated images (optional)

The name of the release is given by the **DataSetRelease** element in **Header** section of the data product.

GalaxyCatalog FITS format
+++++++++++++++++++++++++

The format of the input galaxy catalogue is specified by the FITS format `sim.galaxyCatalog 0.5 <https://gitlab.euclid-sgs.uk/ST-DM/ST_FitsDataModel/-/blob/9.2.0/ST_DM_FitsSchema/auxdir/ST_DM_FitsSchema/instances/fit/euc-sim.xml?ref_type=tags#L70>`_. More information can be found on the `Redmine wiki <https://euclid.roe.ac.uk/projects/sim_trueuniverse/wiki/SPV3_TU_galaxies>`_. A catalogue contains the following columns.  

Note that the fluxes include the lensing magnification factor. The intrinsic fluxes can be recovered by multiplying them by mu = (1-kappa)**2 - gamma1**2 - gamma2**2.

**Catalog columns**

$PrintCatalog fit/euc-sim.xml sim.galaxyCatalog


Morphology parameters are ignored for QSO sources, because they are simulated point-like sources. 

.. DetailedDescEnd