# =============================================================================
# Simulated NIRSpec MSA MOS and reduction for CEERS pointing 3.
# =============================================================================

We present the complete set of NIRSpec MSA simulations for CEERS pointing 3.
This release includes the already reduced spectra in all the observing
configurations simulated for pointing 3, as well as two Jupyter notebooks with
the simulated count-rate maps (CRMs) and instructions on how to reduce them
using the STScI calibration pipeline.

We strongly recommend to start with the
CEERS3_NIRSpec_MSA_detailed_reduction.ipynb Jupyter notebook for a detailed
description of the simulated data and the reduction process.
CEERS3_NIRSpec_MSA_detailed_reduction.zip includes said notebook and all the
required data to run it.

############
### CAVEATS:
- Due to format discrepancies between the pipeline and the simulated data,
flux errors are not correctly propagated during the reduction process and
should not be considered.
- Realistic reference files for MSA flux calibration were not yet available in
pipeline version 1.4.2. Therefore the standard reduced spectra are in units of
counts per second. A set of simulated mock flat spectrum sources is included
for each observing configuration to carry out an approximated flux calibration
(check out the notebooks for further details).

############
### Summary:
Instrument: NIRSpec
Mode: MOS
Source of Simulations: IPS
Pipeline Version Used: 1.4.2

Subarray: FULL
Filters/Dispersers: clear/prism, F100LP-G140M, F170LP-G235 and F290LP/G395M
Readout: NRSIRS2
Groups/Ints/Exposures: 13/1/3
Comments: 3-shutter slitlet nod pattern. Only point-like sources simulated.
          Low background level.

Contact: Pablo Arrabal Haro (parrabalh@gmail.com)

##########
### Files:
reduced_spectra - Directory containing a folder with the reduced
                  spectra for each filter/disperser configuration. Those in
                  turn contain three .zip files:

    1D_spec.zip - Reduced 1D spectra .fits files for the galaxies (galaxy_spec)
                  and the mock flat spectrum sources (flat_spec).
                  Wavelength in microns; Flux in ADU s-1.

    2D_spec.zip - Reduced 2D spectra .fits files for the galaxies (galaxy_spec)
                  and the mock flat spectrum sources (flat_spec).

    fluxcal_ 1D_spec.zip - Reduced 1D spectra .dat files after applying a
                           custom flux calibration combining the reduced 1D
                           spectra of each galaxy and the flat spectrum source
                           simulated in its slitlet. Wavelength in microns;
                           Flux in mJy.

CEERS3_full_NIRSpec_reduction.zip - Contains all the raw simulated data for
                                    both normal and flat spectrum simulations,
                                    plus a Jupyter notebook to fully reduce
                                    them.

CEERS3_NIRSpec_MSA_detailed_reduction.zip - Contains raw simulated data
                                            of clear/prism and F290LP/G395M
                                            configurations in NRS1 and NRS2,
                                            respectively; as well as already
                                            reduced clear/prism flat spectra to
                                            perform a flux pseudo-calibration.
                                            The Jupyter notebook within hosts
                                            the complete documentation of the
                                            simulations and shows all the
                                            different reduction steps in detail.