This is the readme file for the simulated MIRI data products. 
The simulations and data reductions follow the procedures detailed in Yang et al. (2021, ApJ, 908, 144).


Final reduced images and weight maps are available in the mosaics directory. 
    We note that the final images and weight maps in the mosaics directory were produced 
    with an earlier version of the jupyter notebook (pipeline_v1.0.ipynb). The images appear 
    to have striping-like noise in the vertical direction. This issue is due to running the 
    reference pixel correction (refpix) step of Stage 1 on data simulated with MIRISim, as 
    the MIRISim products do not include the effect that refpix is removing. This issue has 
    been fixed in the notebook version 1.1 (pipeline_v1.1.ipynb) that is provided with Part1 
    and Part2 of this data release.

Raw data and step-by-step instructions for reducing the raw data are available in two parts:

    We recommend starting with part1, which provides all necessary files (including a 
    Jupyter notebook, pipeline_v1.1.ipynb) to reduce MIRI imaging in F770W and F2100W for 
    CEERS pointing 7b. Part1 requires ~10.5 GB of disk space.

    If you wish to reduce additional CEERS MIRI pointings, download and untar the directory 
    of raw data for each pointing you wish to reduce. The raw data in each CEERS pointing 
    directory are sorted by filter, as required by the notebook. Place all directories in 
    one location and set the path to this location in the notebook (see pipeline_v1.1.ipynb  
    for details). All raw files present in the specified path will be reduced and combined 
    to form final mosaics and preliminary photometric catalogs for each pointing/filter.
    The total disk space required to run all CEERS pointings through the notebook is ~65 GB.
    
Software requirements for pipeline reduction:
    python (version >= 3.7)
    numpy 
    matplotlib
    astropy
    jwst (https://github.com/spacetelescope/jwst)
    sep (https://github.com/kbarbary/sep)
    astroscrappy (https://github.com/astropy/astroscrappy)

File explanation:
    pipeline_v1.1.ipynb
        is the script that reduced the raw MIRI data and produced the science and weight images.
        The file is in the format of python jupyter notebook file.

    CEERS{pt_id}/{filter}/det_image_seq{dth_id}_MIRIMAGE_{filter}exp{exp_id}.fits
        are the raw (pipeline-ready) MIRI data generated by MIRISIM v.2.4.0.
        {pt_id} is the pointing ID.
        {filter} is the filter name. 
        {dth_id} is the dither ID.
        {exp_id} is the exposure ID.
        The input sources are from the SAM catalog.

    CEERS{pt_id}/{filter}/final_image.fits
        are the science images produced by pipeline_v1.1.ipynb
        The units are megajansky per steradian (MJy/sr)

    CEERS{pt_id}/{filter}/final_wht.fits
        are the weight images produced by pipeline_v1.1.ipynb

    pointing_info/miri{pt_id}_reg.fits
        are the pointing WCS information.
        These are needed by pipeline_v1.1.ipynb

    model_cat/miri{pt_id}_src_sam.fits
        are the SAM model properties used as input for the MIRI simulations. 
        These can be considered as "true" quantities, testing your measurements. 

Contact:
    Guang Yang, gyang206265@gmail.com