Mirage

=====

APT
---

Modify APT pointing file reader to ignore the new Glossary section in the pointing file (815)


Dependencies
------------

Update to use pysiaf version 0.19.0 (809)


Source Brightness
-----------------

Update the filter throughput files and zeropoints for NIRCam to use values derived from in-flight measurements. (809)

=====

APT
---

Bugfix in the APT xml reader for MOS programs with no dithers. (806)


CRDS Reference Files
--------------------

Remove references to the pixel area map from code and documentation, as this is no longer used. (790)


Packaging
---------

Update dependency list. Drop support for python 3.7. (783)

Remove python 3.6 environment file. (784)


Catalogs
--------

Update the import location of Irsa from astroquery.irsa to the new location of astroquery.ipac.irsa (772)


Dark Current
------------

Correct bug that was causing metadata from raw darks to not be read in correctly. Allow input raw darks with no ZEROFRAME extension as long as they were collected with a RAPID readout pattern. (762)

Remove JWST calibration pipeline config files, as they are non longer supported by the pipeline. (791)


Moving Targets
--------------

Updated the MOVING_TARGET_POSITION table from detector -> sci. (757)

Fix a bug that was resulting in moving target sources that were brighter than they should have been. (807)


Galaxy and Extended Source Position Angles
------------------------------------------

Fixed a bug that was causing incorrect position angles of galaxy and extended sources when PAV3 was non-zero. (767)

Fix galaxy/extended source rotation test (778)


NIRISS SOSS
-----------

Stores the input star and planet data (including the orbital parameters) to the output FITS files so users can make direct comparisons. The data is stored in a new 'STAR' and (when applicable) 'PLANET' extensions with the units and orbital params saved as header keywords. (773)

Moves hardcoded max_frames variable into SossSim.create keyword args so users can adjust memory allocation. (775)

Allow a user to generate a custom wavelength solution before generating SOSS simulations (787)


WFSS
----

Save "seed_cube" pickle files of point source, galaxy, and extended sources. These are then picked up by the disperser. This will allow overlapping sources to be treated correctly when everything is disersed. (779)

=====

NIRISS Ghosts
-------------

Update to new version of NIRISS ghost gap file. (751)

Remove the NIRISS ghost gap file from the Mirage repository. Download the file from the niriss_ghost repository whenever a
NIRISS simulation including ghosts is run. (753)


Moving Targets
--------------

Populate the MOVING_TARGET_POSITION table extension in the output files. (749)


Output File Headers
-------------------

Populate the PPS_APER header keyword in saved uncal and linear files. This information comes from the APT pointing file. (752)

Populate the NOUTPUTS header keyword in saved uncal and linear files. This is needed in order to find the correct CRDS reference files in some cases. (756)

=====


APT Reader
----------

Update NIRSpec MOS APT xml reader to make use of ConfigurationPointing fields, in order to determine order and number of exposures. (707)

Be sure that the number of primary dithers as read from the xml file is an integer, in order to correctly populate the new NRIMDTPT
header keyword. (718)

Set the observation mode to "wfss" for NIRISS observations that use the External Calibration template and use a grism. (737)


Documentation
-------------

Remove mentions of outdated mode name from documentation. "moving_target" is not a mode. Instead, refer to "non-sidereal" tracking. (740)

Use a newer ReadTheDocs build image in order to avoid build errors associated with new version of jupyter-core. (745)


Example Notebooks
-----------------

Add missing function definition in imaging mode notebook. (735)


NIRCam Coronagraphic Modes
--------------------------

Correctly populate the array_name entry of the input yaml file for NIRCam coronagraphic observations. This aperture name is needed when
running coronagraphic simuations. While Mirage still does not directly support coronagraphic simuations, extended images can be used to
create a coronagraphic scene. (728)


NIRCam TSO Simulations
----------------------

Fix the location of the target in the TSO apertures. The location of the dispersed source is dictated by the intermediate aperture
location in APT, rather than the imaging aperture. (722)


NIRISS Simulations
------------------

Add F158M to the list of filters for which ghosts can be added. Update the ghost positions for WFSS simualations,
to better reflect ground testing results. (714)


Non-sidereal target simulations
-------------------------------

Add PSF convolution keyword when making an extended source image with a moving target simulation. (706)

Updates to the non-sidereal catalog creation method such that users can input the type of source to use for the tracked target. Remove
the movingTargetConvolveExtended entry from the yaml file since it was not being used. Convolution of any extended taget (sidereal,
non-sidereal, tracked, untracked) with the PSF are all controlled by the PSFConvolveExtended yaml entry. Tracked, non-sidereal sources
are now considered opaque. That is, background sources that fall behind the tracked non-sidereal target will not be added to the seed
image. (743)


Outputs
-------

Following changes in jwst version 1.2.3, replace the NDITHPTS header keyword with NRIMDTPT. (705)

Correct the file-splitting calculations when creating data with a non-RAPID readout pattern. (731)


Packaging
---------

Remove secondary dependencies from environment files and requirements.txt. (733)


PSF Libraries
-------------

Fix bug that was preventing Mirage from finding the correct gridded PSF library for WLP4 simulations. (724)

In cases where the total signal in a gridded PSF library is greater than 1.0 but less than 1.1, renormalize the PSF to have a total
signal of 1.0. PSFs with total signals greater than 1.1 will raise an exception. The renormalization is done because in some cases,
WebbPSF will create a PSF with a total signal just slightly greater than 1.0. (725)


Source Catalogs
---------------

Remove CLEAR and CLEARP from the list of filters read in from the pointing file during source catalog creation. (710)

Fix bug that was causing inconsistencies in the crossmatching of sources between the 2MASS/Gaia/WISE catalogs. (726)

Fix a bug that was placing NIRISS filter/pupil names in the wrong entry of the exposure dictionary when using for_proposal()
to create source catalogs. (730)

Subarray Apertures
------------------

Correct the subarray name associated with the NRCB5_MASKLWB aperture name in APT. (744)


SOSS Mode Simulations
---------------------

Prevent the SOSS simulator from looking for a non-existing 2nd order with F277W. (700)

Update SOSS simulator to use astropy's BlackBody model rather than the deprecated BlackBody1D. (720)


Transmission Image
------------------

Create a pom transmission image composed of all 1's for NIRISS AMI and NIRCam imaging TSO simulations, as is done now for regular imaging simulations. (701)

=====

Flux calibration
----------------

Updated the gain and filter-based zeropoint values for NIRCam observations. These values were changed in order to stay consistent with new gain and photom reference files delivered to CRDS. The new gain values are ~20% lower than the previous versions, which means the zeropoints have changed by the same amount. (686)


Logging
-------

Fix logging error so that in NIRISS simulations where ghosts are requested, if the filter used does not support the addition of ghosts, this fact is logged only once, rather than for each source. (667)


NIRISS Simulations
------------------

Fix bug that was preventing NIRISS External Calibration observations from being read in by the yaml_generator when they were in parallel rather than prime. (679)

When creating "pom" mode simulations, create a seed image that is larger than the detector. (681)


Reference Files
---------------

Fix the name of the directory into which the NIRCam longwave linearized darks are saved. Prevously the files were being saved into e.g. BLONG, while later, Mirage was looking for B5. (692)

Allow the name of the transmission file to be None or 'None' when working in imaging mode. (695)


Seed Image
----------

Enable the use of IRAC mosaic images as input seed images (670)


SOSS Simulations
----------------

Allow SOSS simulations to be made using a parameter file or keyword arguments (671)


Source Catalogs
---------------

Updates to the for_proposal() catalog generation function to populate ra_ref and dec_ref dictionary entries. (696)


Timer
-----

Stop the timer before moving on to the next source in the source catalog when the current source is completely off the detector. Prior to this, sources that were outside the detector would sometimes raise a timer error when Mirage attempted to start the timer for the next source while that for the current source was still running. (669)


TSO Simulations
---------------

Update the batman package to version 2.4.8 in order to avoid a problem with version 2.4.7. (680)


V3 Position Angle
-----------------

Remove the skipped_obs_from_xml keyword value in the call to get_pointing_info within default_obs_v3pa_on_date() and all_obs_v3pa_on_date(). (674)

=====

NIRISS AMI
----------

Updated the PSF normalization check threshold value to match the new value from an updated NRM mask calculation. Prior to this, Mirage was stopping AMI simulations because the normalization threshold was too low. (664)