.. _SIRExtractedSpectraCollection:
  
Extracted Spectra Collection Product
------------------------------------
  
Data product name
=================
.. DataProductNameStart
   
ExtractedSpectraCollection
   
.. DataProductNameEnd
   
Data product custodian
======================
.. DataProductCustodianStart
   
SIR
   
.. DataProductCustodianEnd
   
Data model tag
==============
.. DataModelTagStart
   
R-1.6.6
   
.. DataModelTagEnd
   
Name of the Schema file
=======================
.. NameSchemaStart
   
euc-test-sir-ExtractedSpectraCollection.xsd
   
.. NameSchemaEnd
   
Schema documentation tag
========================
.. SchemaDocTagStart
   
No documentation element was found in schema file! 
Data Model custodian: even minimal information can be helpful
   
.. SchemaDocTagEnd
   
Data product elements
=====================
.. DataProductElementsStart
   
Header of type: sys:genericHeader

Data of type: sir:extractedSpectraCollection

Parameters of type: ppr:genericKeyValueParameters

   
.. DataProductElementsEnd
   
Processing Element(s) creating/using the data product
=====================================================
.. PECreatorStart
   
This data product is produced by the SIR_SpectraExtraction PE. 

It is used and updated by SIR_FluxCalibration PE.

.. PECreatorEnd
   
Processing function using the data product
==========================================
.. PFUsingStart
   
This is an internal data product. It is used only by SIR-PEs.

.. PFUsingEnd
   
Detailed description of the data product
========================================
.. DetailedDescStart
  
The SIR_SpectraExtraction works on decontaminated spectra; it uses the **LocationTable** to extact 2D and 1D spectra linearly resampled, lambda calibrated and without distortions. Foreach **LocationObject** in the **LocationTable** one **ExtractedSpectrum** is produced.

.. _ExtractedSpectrum:

.. figure:: ./figures/ExtractedSpectrum.png

   : The ExtractedSpectrum structure.

The **ExtractedSpectrum** (cyan box in :numref:`ExtractedSpectrum`) is the atomic part of the **ExtractedSpectraCollection**. Spectrum data are collected in the **DataSets** (purple boxes in :numref:`ExtractedSpectrum`):

* *2D* contains data of 2D spectrum
* *1D* contains data of 1D spectrum
* *1D FLUX* contains data of 1D spectrum flux calibrated (in case SIR_FluxCalibration has been applied on the **ExtractedSpectraCollection**).

Each **DataSet** group contains: 

* the spectrum data values: *Science* HDF5 dataset
* the spectrum quality: *Quality* HDF5 dataset
* the spectrum covariance matrix: the combination of *Variance*, *Covariance mask* and *Covariance* HDF5 datasets.

2D, 1D and 1D FLUX spectra are linearly resampled and they have the same wavelength solution. For this reason the spectrum wavelength solution is described once for all by the attributes (in Angstrom):

* *Wlen start*: value of starting wavelength 
* *Wlen inc*: the increment step of wavelength solution
* *Wlen end*: value of last wavelength

Beside spectrum data, the **ExtractedSpectrum** contains also the **AstronomicalObject** (yellow box in :numref:`ExtractedSpectrum`) and the **LocationSpectrum** (green box in :numref:`ExtractedSpectrum`) used to create it. 

**ExtractedSpectraCollection** organizes **ExtractedSpectra** in 2 levels: first level by object ID and a second level by detector (see :numref:`ExtractedSpectraCollectionLevels`).

.. _ExtractedSpectraCollectionLevels:

.. figure:: ./figures/ExtractedSpectraCollectionLevels.png

   : The 2 levels of the ExtractedSpectraCollection.

The **Recipes Parameters** group is dedicated to collect recipe parameters used to obtain the current **ExtractedSpectraCollection** data product. 

.. DetailedDescEnd