Webbpsf

Minor documentation update

We are pleased to announce the release of the latest version of WebbPSF version 1.2.0, now available on PyPi and GitHub. This release comes with new features and improvements including but not limited to:

1. The addition of detector effects for JWST simulations. H2RG detector effects are included in two flavors, a simple ad hoc Gaussian convolution to model charge diffusion effects and a set of convolution kernels to model interpixel capacitance (IPC) and post-pixel coupling effects. We have found that these effects greatly improve the agreement between observations and simulations. See [JWST Detector Effects for more details](https://webbpsf.readthedocs.io/en/latest/jwst_detector_effects.html).
2. A new utility function for simulating matching PSFs to science data. See [Matching PSF sims to in-flight JWST data](https://webbpsf.readthedocs.io/en/latest/jwst_matching_psfs_data.html).
2. Implement geometric distortion for Roman using the Roman SIAF.
3. Various improvements for OTE trending.

What's Changed
* Fixed trending histogram binning so that bars add up to 1.0 by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/634

* Add phase retrieval crosscheck plot and wfs obs delta plot by mperrin in https://github.com/spacetelescope/webbpsf/pull/650

* 597 - add opdtable as positional param to monthly_trending_plot by kulpster85 in https://github.com/spacetelescope/webbpsf/pull/600

* Update to read SI pixelscales directly from pysiaf by mperrin in https://github.com/spacetelescope/webbpsf/pull/626

* Update/enhance trending plot to show WSS proposed corrections by mperrin in https://github.com/spacetelescope/webbpsf/pull/642

* Add notebooks for plotting JWST SI WFE, and JWST SI MIMF field points by mperrin in https://github.com/spacetelescope/webbpsf/pull/652

* Add H2RG detector effects sim framework by mperrin and obi-wan76 in https://github.com/spacetelescope/webbpsf/pull/671

* Tune detector effects model parameters to better match measured ePSFs by mperrin in https://github.com/spacetelescope/webbpsf/pull/693

* Non-standard pixel sizes for distortion by JarronL in https://github.com/spacetelescope/webbpsf/pull/669

* Add setup_sim_to_match_data function by mperrin in https://github.com/spacetelescope/webbpsf/pull/706

* Add trending plot function "show_wfs_around_obs" by mperrin in https://github.com/spacetelescope/webbpsf/pull/705

* Additional fixes to trending.py by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/688

* Implement distortion for Roman by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/668

**Full Changelog**: https://github.com/spacetelescope/webbpsf/compare/v1.1.1...v1.2.0

Note, this release requires updating your WebbPSF data files to version 1.2.0, [webbpsf-data-1.2.0.tar.gz](https://stsci.box.com/shared/static/34g3slaq4jidgccqj25qqo80tlk6tubl.gz)

2022 December 14

Minor fixes and trending plot enhancements from first half of JWST Cycle 1. .

Note, this release requires updating your WebbPSF data files to version 1.1.1. See [our installation instructions](https://webbpsf.readthedocs.io/en/v1.1.1/installation.html#installing-the-required-data-files) for more information.

This release's upgraded requirements drop support for Python 3.7, meaning conda installation is temporarily unavailable since the AstroConda channel is not equipped for newer Python versions. Installation with pip works as normal.

For full release notes, see https://webbpsf.readthedocs.io/en/v1.1.1/relnotes.html#version-1-1-1
Full changelog: https://github.com/spacetelescope/webbpsf/compare/v1.1.0...v1.1.1

*2022 September 23*

*First release with JWST in flight optical performance!* Updates and tools added after completion of commissioning.

Note, this release requires updating your WebbPSF data files to version 1.1.0. See [our installation instructions](https://webbpsf.readthedocs.io/en/v1.1.0/installation.html#installing-the-required-data-files) for more information.

This release's upgraded requirements drop support for Python 3.7, meaning conda installation is temporarily unavailable since the AstroConda channel is not equipped for newer Python versions. Installation with pip works as normal.

For full release notes, see https://webbpsf.readthedocs.io/en/latest/relnotes.html#version-1-1-0
**Full changelog:** https://github.com/spacetelescope/webbpsf/compare/v1.0.0...v1.1.0

*2021 December 10*

Milestone release shortly before JWST launch, with significant updates to both JWST and Roman optical models.

See [release notes on readthedocs](https://webbpsf.readthedocs.io/en/latest/relnotes.html#version-1-0-0) for a more informative summary than the below which was auto-generated by GitHub.

What's Changed
* update branch URLs in docs for master -> stable (or develop, as appropriate) by mperrin in https://github.com/spacetelescope/webbpsf/pull/372
* avoid reloading SIAF multiple times, for small runtime speed improvement by mperrin in https://github.com/spacetelescope/webbpsf/pull/377
* Update thermal slew scaling by JarronL in https://github.com/spacetelescope/webbpsf/pull/375
* Added line to include clocking from SUR by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/385
* Toward better OTE field dependence modeling: use OTE linear model class by default by mperrin in https://github.com/spacetelescope/webbpsf/pull/378
* Move jwxml code into webbpsf by shanosborne in https://github.com/spacetelescope/webbpsf/pull/390
* update syntax to remove unnecessary underscores after poppy PR 386 by mperrin in https://github.com/spacetelescope/webbpsf/pull/395
* Move missing data files message inside error by shanosborne in https://github.com/spacetelescope/webbpsf/pull/391
* update opd thermal slew test, in particular for a change in pupil segment data file by mperrin in https://github.com/spacetelescope/webbpsf/pull/396
* Gridded PSF library generation should copy hexike P/T/T keywords, if present by mperrin in https://github.com/spacetelescope/webbpsf/pull/398
* WebbPSF: Rename WFIRST -> Roman by robelgeda in https://github.com/spacetelescope/webbpsf/pull/400
* JWST Help Desk instead of helpstsci.edu by dancoe in https://github.com/spacetelescope/webbpsf/pull/402
* WIP: OTE Secondary Mirror IFM field-dependence implementation by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/392
* Updating to meet INS-JWST Software Standards by shanosborne in https://github.com/spacetelescope/webbpsf/pull/404
* Create Dependabot config file by dependabot-preview in https://github.com/spacetelescope/webbpsf/pull/405
* Add a travis test for latest dep versions by shanosborne in https://github.com/spacetelescope/webbpsf/pull/408
* bug fix: avoid matplotlib deprecation of changing colormaps by mperrin in https://github.com/spacetelescope/webbpsf/pull/410
* Use consistent lengths for Zernike/Hexike coefficients and basis vectors by mperrin in https://github.com/spacetelescope/webbpsf/pull/422
* Bump numpy from 1.19.4 to 1.20.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/407
* Fix broken link to notebook by kjbrooks in https://github.com/spacetelescope/webbpsf/pull/423
* For Ball LookupTableOPD, add support for general defocus, e.g. for MIMF by Skyhawk172 in https://github.com/spacetelescope/webbpsf/pull/425
* Update MIRI detector cross artifact model; fixes 415 by mperrin in https://github.com/spacetelescope/webbpsf/pull/417
* add unit test for sign convention; adapted from notebook version in PR 418 by mperrin in https://github.com/spacetelescope/webbpsf/pull/419
* Bump ipython from 7.20.0 to 7.21.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/421
* Bump scipy from 1.6.0 to 1.6.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/420
* Updates for sign convention and poppy 1.0 by mperrin in https://github.com/spacetelescope/webbpsf/pull/397
* Coronagraphic mask offset by JarronL in https://github.com/spacetelescope/webbpsf/pull/428
* Replace griddata with RegularGridInterpolator for distortions by JarronL in https://github.com/spacetelescope/webbpsf/pull/429
* Update dependencies min versions by shanosborne in https://github.com/spacetelescope/webbpsf/pull/436
* Adding synphot by shanosborne in https://github.com/spacetelescope/webbpsf/pull/424
* bugfix synphot refactor by mperrin in https://github.com/spacetelescope/webbpsf/pull/437
* Update rotation sign for consistency after poppy PR 411 by mperrin in https://github.com/spacetelescope/webbpsf/pull/438
* Remove deprecated code for GUIs and obssim by mperrin in https://github.com/spacetelescope/webbpsf/pull/439
* Bump ipython from 7.21.0 to 7.22.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/431
* Bump matplotlib from 3.3.4 to 3.4.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/434
* Bump scipy from 1.6.1 to 1.6.2 by dependabot in https://github.com/spacetelescope/webbpsf/pull/432
* Bump photutils from 1.0.2 to 1.1.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/433
* Bump numpy from 1.20.1 to 1.20.2 by dependabot in https://github.com/spacetelescope/webbpsf/pull/435
* Update GitHub URLs in tutorial notebook by robelgeda in https://github.com/spacetelescope/webbpsf/pull/441
* calculate SI WFE header keyword over just the JWST aperture, not the full array by mperrin in https://github.com/spacetelescope/webbpsf/pull/427
* specify jitter arcseconds per axis by robelgeda in https://github.com/spacetelescope/webbpsf/pull/442
* MNT: Do not write config on import by pllim in https://github.com/spacetelescope/webbpsf/pull/444
* fix set_position_from_aperture_name by mperrin in https://github.com/spacetelescope/webbpsf/pull/447
* update data files release script by mperrin in https://github.com/spacetelescope/webbpsf/pull/454
* Move CI to github actions, replacing Travis by shanosborne in https://github.com/spacetelescope/webbpsf/pull/455
* Bump astropy from 4.2 to 4.2.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/449
* Bump scipy from 1.6.2 to 1.6.3 by dependabot in https://github.com/spacetelescope/webbpsf/pull/452
* Update the OPD linear model so that we can adjust the pixel sampling by kjbrooks in https://github.com/spacetelescope/webbpsf/pull/440
* Bump pysiaf from 0.10.0 to 0.11.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/450
* Bump ipython from 7.22.0 to 7.23.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/457
* Streamline CI test runtimes by mperrin in https://github.com/spacetelescope/webbpsf/pull/459
* Bump matplotlib from 3.4.1 to 3.4.2 by dependabot in https://github.com/spacetelescope/webbpsf/pull/463
* Bump ipython from 7.23.1 to 7.24.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/462
* Bump numpy from 1.20.2 to 1.20.3 by dependabot in https://github.com/spacetelescope/webbpsf/pull/461
* Undefined variables in optics.py by JarronL in https://github.com/spacetelescope/webbpsf/pull/464
* update MIRI detector scale params to match current SIAF by mperrin in https://github.com/spacetelescope/webbpsf/pull/456
* Bump numpy from 1.20.3 to 1.21.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/469
* Bump scipy from 1.6.3 to 1.7.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/467
* Bump ipython from 7.24.0 to 7.25.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/468
* Roman Prism and Grism by robelgeda in https://github.com/spacetelescope/webbpsf/pull/416
* WFR4+MIMF_KDP: add LookupTable optic class for Ball-delivered OPDs by mperrin in https://github.com/spacetelescope/webbpsf/pull/328
* Bump numpy from 1.21.0 to 1.21.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/476
* Update CI by shanosborne in https://github.com/spacetelescope/webbpsf/pull/480
* Bump astropy from 4.2.1 to 4.3.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/478
* Bump ipython from 7.25.0 to 7.27.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/483
* Bump numpy from 1.21.1 to 1.21.2 by dependabot in https://github.com/spacetelescope/webbpsf/pull/484
* Bump matplotlib from 3.4.2 to 3.4.3 by dependabot in https://github.com/spacetelescope/webbpsf/pull/485
* Bump scipy from 1.7.0 to 1.7.1 by dependabot in https://github.com/spacetelescope/webbpsf/pull/486
* LRE4 and MIMF KDP Practice 2: add options to LookupTableOPD for importing Ball-delivered OPDs by mperrin in https://github.com/spacetelescope/webbpsf/pull/474
* Extend MIRI Lyot occulter to edge of FoV by JarronL in https://github.com/spacetelescope/webbpsf/pull/482
* Merge and deconflict from develop-0.9.2 to develop by mperrin in https://github.com/spacetelescope/webbpsf/pull/473
* Bump photutils from 1.1.0 to 1.2.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/489
* Bump ipython from 7.27.0 to 7.28.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/490
* Bump pysiaf from 0.11.0 to 0.13.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/491
* MNT: Update codecov-action version to v2 by pllim in https://github.com/spacetelescope/webbpsf/pull/492
* Use "==" instead of "is" for string comparisons by JarronL in https://github.com/spacetelescope/webbpsf/pull/493
* Bump numpy from 1.21.2 to 1.21.3 by dependabot in https://github.com/spacetelescope/webbpsf/pull/494
* Bump ipython from 7.28.0 to 7.29.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/495
* Add field dependence into weak lens model by mperrin in https://github.com/spacetelescope/webbpsf/pull/496
* Remove Python 3.6 by shanosborne in https://github.com/spacetelescope/webbpsf/pull/498
* bug fix: avoid filling OPD outer regions with NaNs when using the global zernike option by mperrin in https://github.com/spacetelescope/webbpsf/pull/497
* Bump ipython from 7.29.0 to 7.30.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/500
* Bump scipy from 1.7.1 to 1.7.3 by dependabot in https://github.com/spacetelescope/webbpsf/pull/501
* Bump matplotlib from 3.4.3 to 3.5.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/502
* Bump astropy from 4.3.1 to 5.0 by dependabot in https://github.com/spacetelescope/webbpsf/pull/503
* Rename 'P750L LRS grating' -> 'P750L', per 477 by mperrin in https://github.com/spacetelescope/webbpsf/pull/499
* add synphot as required dependency, and update some other min vers by mperrin in https://github.com/spacetelescope/webbpsf/pull/504
* OTE field dependence, clean branch, try 2 by mperrin in https://github.com/spacetelescope/webbpsf/pull/505
* JWST "visual optical budget" display toolkit by mperrin in https://github.com/spacetelescope/webbpsf/pull/506
* Added distortion/crop arguments to Roman calc_psf by ojustino in https://github.com/spacetelescope/webbpsf/pull/488
* Roman Cycle 9 Updates by ojustino in https://github.com/spacetelescope/webbpsf/pull/466
* Added GRISM0 back to WFI filter tests by ojustino in https://github.com/spacetelescope/webbpsf/pull/508
* Fix spacing issue in docs by shanosborne in https://github.com/spacetelescope/webbpsf/pull/510
* Updating bar mask offsets directly from pySIAF by kammerje in https://github.com/spacetelescope/webbpsf/pull/509
* Release prep for 1.0.0 by mperrin in https://github.com/spacetelescope/webbpsf/pull/507
* Corrected info on Roman reference pixels by ojustino in https://github.com/spacetelescope/webbpsf/pull/515
* Added Roman updates to v1.0.0 release notes by ojustino in https://github.com/spacetelescope/webbpsf/pull/514
* Drop CGI references in Roman code by ojustino in https://github.com/spacetelescope/webbpsf/pull/516
* Roman documentation and coronagraph demo changes by ojustino in https://github.com/spacetelescope/webbpsf/pull/517
* JWST OTE OPD updates for Release 1.0.0 by mperrin in https://github.com/spacetelescope/webbpsf/pull/512
* last additional release notes update for 1.0.0 by mperrin in https://github.com/spacetelescope/webbpsf/pull/518

New Contributors
* dancoe made their first contribution in https://github.com/spacetelescope/webbpsf/pull/402
* dependabot-preview made their first contribution in https://github.com/spacetelescope/webbpsf/pull/405
* dependabot made their first contribution in https://github.com/spacetelescope/webbpsf/pull/407
* pllim made their first contribution in https://github.com/spacetelescope/webbpsf/pull/444
* ojustino made their first contribution in https://github.com/spacetelescope/webbpsf/pull/488
* kammerje made their first contribution in https://github.com/spacetelescope/webbpsf/pull/509

**Full Changelog**: https://github.com/spacetelescope/webbpsf/compare/v0.9.1...v1.0.0

*2021 July 23*

This release improves a subset of WFIRST functionality to add WFI's Prism and Grism modes using cycle 8 models for wavefront error.

This release only improves a subset of WFIRST functionality; additional improvements to both WFIRST (including renaming to Roman) and JWST models will be at the upcoming 1.0.0 major release.

**WFIRST Improvements**

- New Grism and Prism filters: [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- `GRISM_FILTER = 'G150'`
- `PRISM_FILTER = 'P120'`
- Changing filters to `G150` or `P120` changes the mode of the WFI and the aberrations files (unless there is a user aberrations override) [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- New `WFI.mode`: Class property that returns the current mode of the WFI instance by passing the current filter to `WFI. _get_filter_mode`. WFI modes are: [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- Imaging
- Grism
- Prisim
- New `WFI.override_aberrations(aberrations_path)`: Overrides and locks the current aberrations with aberrations at `aberrations_path`. Lock means changing the filter/mode has no effect on the aberrations. [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- New `WFI.reset_override_aberrations()`: Releases `WFI.override_aberrations` lock and start using the default aberrations. [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- New Tests for mode and filter switching. [:pr:`416`, :pr:`471`, :user:`robelgeda`]
- New Field point nearest point approximation (extrapolation). [:pr:`416`, :pr:`471`, :user:`robelgeda`]

**Software and Package Infrastructure Updates:**

- This release uses Github Actions CI and removes TravisCI. [:pr:`455`, :user:`shanosborne`, :pr:`471`, :user:`robelgeda`]