stips 2.2.1__tar.gz → 2.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. {stips-2.2.1 → stips-2.3}/CHANGES.rst +17 -0
  2. stips-2.3/CITATION.cff +41 -0
  3. {stips-2.2.1/stips.egg-info → stips-2.3}/PKG-INFO +4 -4
  4. {stips-2.2.1 → stips-2.3}/README.md +29 -2
  5. {stips-2.2.1 → stips-2.3}/docs/basic_tutorial.rst +1 -1
  6. {stips-2.2.1 → stips-2.3}/docs/index.rst +3 -1
  7. {stips-2.2.1 → stips-2.3}/docs/installation.rst +13 -6
  8. {stips-2.2.1 → stips-2.3}/docs/release.rst +67 -10
  9. {stips-2.2.1 → stips-2.3}/docs/using_stips/catalogue_formats.rst +1 -1
  10. {stips-2.2.1 → stips-2.3}/docs/using_stips/config_file.rst +2 -2
  11. stips-2.3/docs/using_stips/phoenix_grid.rst +76 -0
  12. {stips-2.2.1 → stips-2.3}/docs/using_stips/psf_grid.rst +1 -1
  13. {stips-2.2.1 → stips-2.3}/docs/using_stips.rst +1 -0
  14. {stips-2.2.1 → stips-2.3}/environment.yml +2 -3
  15. {stips-2.2.1 → stips-2.3}/environment_dev.yml +4 -5
  16. {stips-2.2.1 → stips-2.3}/notebooks/STIPS Advanced II - PSFs.ipynb +2 -2
  17. {stips-2.2.1 → stips-2.3}/ref_data/retrieve_stips_data.py +4 -4
  18. {stips-2.2.1 → stips-2.3}/setup.cfg +3 -3
  19. {stips-2.2.1 → stips-2.3}/stips/__init__.py +1 -1
  20. {stips-2.2.1 → stips-2.3}/stips/astro_image/astro_image.py +53 -32
  21. {stips-2.2.1 → stips-2.3}/stips/data/CreatePhoenixGrid.py +20 -12
  22. {stips-2.2.1 → stips-2.3}/stips/data/stips_config.yaml +3 -3
  23. {stips-2.2.1 → stips-2.3}/stips/instruments/instrument.py +9 -3
  24. {stips-2.2.1 → stips-2.3}/stips/instruments/roman_instrument.py +2 -5
  25. {stips-2.2.1 → stips-2.3}/stips/instruments/wfi.py +39 -30
  26. {stips-2.2.1 → stips-2.3}/stips/stellar_module/star_generator.py +2 -2
  27. {stips-2.2.1 → stips-2.3}/stips/utilities/tests/test_makePSF.py +1 -1
  28. {stips-2.2.1 → stips-2.3}/stips/utilities/utilities.py +36 -35
  29. {stips-2.2.1 → stips-2.3/stips.egg-info}/PKG-INFO +4 -4
  30. {stips-2.2.1 → stips-2.3}/stips.egg-info/SOURCES.txt +4 -2
  31. {stips-2.2.1 → stips-2.3}/stips.egg-info/requires.txt +2 -2
  32. {stips-2.2.1 → stips-2.3}/.github/workflows/ci_workflows.yml +0 -0
  33. {stips-2.2.1 → stips-2.3}/.gitignore +0 -0
  34. {stips-2.2.1 → stips-2.3}/.readthedocs.yaml +0 -0
  35. {stips-2.2.1 → stips-2.3}/.rtd-environment.yml +0 -0
  36. {stips-2.2.1 → stips-2.3}/CITATION +0 -0
  37. {stips-2.2.1 → stips-2.3}/CODE_OF_CONDUCT.md +0 -0
  38. {stips-2.2.1 → stips-2.3}/CONTRIBUTING.md +0 -0
  39. {stips-2.2.1 → stips-2.3}/Dockerfile +0 -0
  40. {stips-2.2.1 → stips-2.3}/MANIFEST.in +0 -0
  41. {stips-2.2.1 → stips-2.3}/docs/Makefile +0 -0
  42. {stips-2.2.1 → stips-2.3}/docs/bugs.rst +0 -0
  43. {stips-2.2.1 → stips-2.3}/docs/conf.py +0 -0
  44. {stips-2.2.1 → stips-2.3}/docs/examples.rst +0 -0
  45. {stips-2.2.1 → stips-2.3}/docs/exts/numfig.py +0 -0
  46. {stips-2.2.1 → stips-2.3}/docs/help.rst +0 -0
  47. {stips-2.2.1 → stips-2.3}/docs/make.bat +0 -0
  48. {stips-2.2.1 → stips-2.3}/docs/requirements.txt +0 -0
  49. {stips-2.2.1 → stips-2.3}/docs/roman_figures/stips_basic_tutorial.png +0 -0
  50. {stips-2.2.1 → stips-2.3}/docs/roman_figures/stips_demo.png +0 -0
  51. {stips-2.2.1 → stips-2.3}/docs/rtd-pip-requirements +0 -0
  52. {stips-2.2.1 → stips-2.3}/licenses/LICENSE.rst +0 -0
  53. {stips-2.2.1 → stips-2.3}/licenses/README.rst +0 -0
  54. {stips-2.2.1 → stips-2.3}/licenses/TEMPLATE_LICENCE.rst +0 -0
  55. {stips-2.2.1 → stips-2.3}/notebooks/STIPS Advanced I /342/200/223 Further Observations, Noise and Distortion.ipynb" +0 -0
  56. {stips-2.2.1 → stips-2.3}/notebooks/STIPS Basic Tutorial.ipynb +0 -0
  57. /stips-2.2.1/notebooks/notebooks_data/psf_WFI_2.0.0_F129_sca01.fits → /stips-2.3/notebooks/notebooks_data/psf_WFI_2.0.0_F129_wfi01.fits +0 -0
  58. {stips-2.2.1 → stips-2.3}/setup.py +0 -0
  59. {stips-2.2.1 → stips-2.3}/stips/astro_image/__init__.py +0 -0
  60. {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/__init__.py +0 -0
  61. {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_AstroImage.py +0 -0
  62. {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_header.py +0 -0
  63. {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_wcs.py +0 -0
  64. {stips-2.2.1 → stips-2.3}/stips/conftest.py +0 -0
  65. {stips-2.2.1 → stips-2.3}/stips/data/CreateIsochroneGrid.py +0 -0
  66. {stips-2.2.1 → stips-2.3}/stips/data/__init__.py +0 -0
  67. /stips-2.2.1/stips/data/psf_WFI_2.0.0_F129_sca01.fits → /stips-2.3/stips/data/psf_WFI_2.0.0_F129_wfi01.fits +0 -0
  68. {stips-2.2.1 → stips-2.3}/stips/errors/__init__.py +0 -0
  69. {stips-2.2.1 → stips-2.3}/stips/errors/make_cosmic_ray.py +0 -0
  70. {stips-2.2.1 → stips-2.3}/stips/instruments/__init__.py +0 -0
  71. {stips-2.2.1 → stips-2.3}/stips/observation_module/__init__.py +0 -0
  72. {stips-2.2.1 → stips-2.3}/stips/observation_module/observation_module.py +0 -0
  73. {stips-2.2.1 → stips-2.3}/stips/scene_module/__init__.py +0 -0
  74. {stips-2.2.1 → stips-2.3}/stips/scene_module/convert_units.py +0 -0
  75. {stips-2.2.1 → stips-2.3}/stips/scene_module/scene_module.py +0 -0
  76. {stips-2.2.1 → stips-2.3}/stips/stellar_module/__init__.py +0 -0
  77. {stips-2.2.1 → stips-2.3}/stips/tests/__init__.py +0 -0
  78. {stips-2.2.1 → stips-2.3}/stips/utilities/DataTable.py +0 -0
  79. {stips-2.2.1 → stips-2.3}/stips/utilities/__init__.py +0 -0
  80. {stips-2.2.1 → stips-2.3}/stips/utilities/makePSF.py +0 -0
  81. {stips-2.2.1 → stips-2.3}/stips/utilities/testing.py +0 -0
  82. {stips-2.2.1 → stips-2.3}/stips/utilities/tests/test_config.py +0 -0
  83. {stips-2.2.1 → stips-2.3}/stips.egg-info/dependency_links.txt +0 -0
  84. {stips-2.2.1 → stips-2.3}/stips.egg-info/not-zip-safe +0 -0
  85. {stips-2.2.1 → stips-2.3}/stips.egg-info/top_level.txt +0 -0
  86. {stips-2.2.1 → stips-2.3}/tox.ini +0 -0
@@ -5,6 +5,23 @@ Release Notes
5
5
  Version History and Change Log
6
6
  ------------------------------
7
7
 
8
+ Version 2.3.0
9
+ =============
10
+ - Added support for F213 filter.
11
+ - Updated constants for PHOTPLAM (pivot wavelength) and mirror area.
12
+ - Allowed users to specify `psf_cache_location` in `addCatalogue` function.
13
+ - Transitioned detector naming convention from 'SCANN' to 'WFINN' to match other Roman SOC simulation tools.
14
+ - Fixed bug with reading Internal tables.
15
+ - Updated pandeia version to be >= 2024.12
16
+ - Updated WebbPSF to STPSF and constrained version to be >= 2.0.0
17
+ - Updated documentation to reflect that STIPS creates an intermediate product between L2 and L3 images.
18
+ - Added documentation on (non-physical) gaps in the Phoenix grid.
19
+ - Added citation to STIPS paper.
20
+
21
+ Version 2.2.2
22
+ =============
23
+ - Updated pandeia.engine version to be >= 3.1 instead of == 3.1
24
+
8
25
  Version 2.2.1
9
26
  =============
10
27
  - Fixed a bug on the version of STIPS in __init__.py
stips-2.3/CITATION.cff ADDED
@@ -0,0 +1,41 @@
1
+ cff-version: 1.2.0
2
+ message: "If you use this software, please cite it as below."
3
+ authors:
4
+ - name: "STIPS Development Team"
5
+ - family-names: "Gomez"
6
+ given-names: "Sebastian"
7
+ orcid: "https://orcid.org/0000-0001-6395-6702"
8
+ - family-names: "Bellini"
9
+ given-names: "Andrea"
10
+ orcid: "https://orcid.org/0000-0003-3858-637X"
11
+ - family-names: "Al-Kowsi"
12
+ given-names: "Hanna"
13
+ - family-names: "Desjardins"
14
+ given-names: "Tyler"
15
+ orcid: "https://orcid.org/0000-0001-6905-1859"
16
+ - family-names: "Geda"
17
+ given-names: "Robel"
18
+ orcid: "https://orcid.org/0000-0003-1509-9966"
19
+ - family-names: "Han"
20
+ given-names: "Eunkyu"
21
+ orcid: "https://orcid.org/0000-0001-9797-0019"
22
+ - family-names: "Otor"
23
+ given-names: "O. Justin"
24
+ orcid: "https://orcid.org/0000-0002-4679-5692"
25
+ - family-names: "Riedel"
26
+ given-names: "Adric"
27
+ orcid: "https://orcid.org/0000-0003-1645-8596"
28
+ - family-names: "Ryan"
29
+ given-names: "Russell"
30
+ orcid: "https://orcid.org/0000-0003-0894-1588"
31
+ - family-names: "Spitzer"
32
+ given-names: "Isaac"
33
+ - family-names: "York"
34
+ given-names: "Brian"
35
+ title: "STIPS"
36
+ version: 2.3.0
37
+ doi: https://doi.org/10.5281/zenodo.15232587
38
+ date-released: 2025-06-27
39
+ url: "https://github.com/spacetelescope/STScI-STIPS"
40
+
41
+ # see a full list of contributors here: https://github.com/spacetelescope/STScI-STIPS/graphs/contributors
@@ -1,6 +1,6 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.4
2
2
  Name: stips
3
- Version: 2.2.1
3
+ Version: 2.3
4
4
  Summary: STIPS is the Space Telescope Imaging Product Simulator.
5
5
  Home-page: https://github.com/spacetelescope/STScI-STIPS
6
6
  Author: Space Telescope Science Institute
@@ -12,8 +12,8 @@ Requires-Dist: scipy
12
12
  Requires-Dist: photutils
13
13
  Requires-Dist: synphot>=1.1.1
14
14
  Requires-Dist: stsynphot>=1.1.0
15
- Requires-Dist: webbpsf>=1.1.1
16
- Requires-Dist: pandeia.engine==3.1
15
+ Requires-Dist: stpsf>=2.0.0
16
+ Requires-Dist: pandeia.engine>=2024.12
17
17
  Requires-Dist: montage-wrapper
18
18
  Requires-Dist: pyyaml
19
19
  Requires-Dist: soc_roman_tools
@@ -2,6 +2,7 @@
2
2
 
3
3
  [![Build Status](https://github.com/spacetelescope/STScI-STIPS/actions/workflows/ci_workflows.yml/badge.svg?branch=main)](https://github.com/spacetelescope/STScI-STIPS/actions/workflows/ci_workflows.yml?query=branch:main)
4
4
  [![STScI](https://img.shields.io/badge/powered%20by-STScI-blue.svg?colorA=707170&colorB=3e8ddd&style=flat)](http://www.stsci.edu)
5
+ [![DOI](https://zenodo.org/badge/94350619.svg)](https://zenodo.org/badge/latestdoi/94350619)
5
6
 
6
7
  For documentation and installation instructions please visit https://stips.readthedocs.io
7
8
 
@@ -21,8 +22,10 @@ It does not include instrument saturation effects.
21
22
 
22
23
  ## Why use STIPS?
23
24
 
24
- STIPS is intended to produce quick simulations of Level 2 (L2) images, and is provided for
25
- cases where [Pandeia](https://pypi.org/project/pandeia.engine) does not
25
+ STIPS is intended to produce quick simulations that are corrected for distortion, but not mosaicked.
26
+ We note there is no equivalent flight product, since Roman Level 3 (L3) files are both distortion
27
+ corrected and mosaicked, while Level 2 (L2) files are neither. STIPS is ideal for
28
+ cases where `Pandeia <https://pypi.org/project/pandeia.engine/>`_ does not
26
29
  provide a large enough simulation area (e.g., full-detector or multiple-detector
27
30
  observations). STIPS obtains its Roman instrument and filter values from
28
31
  Pandeia, so it should produce output within 10% of output produced by Pandeia.
@@ -43,3 +46,27 @@ developed by Andrea Bellini ([@AndreaBellini](https://github.com/AndreaBellini))
43
46
 
44
47
  ![Alt text](docs/roman_figures/stips_demo.png?raw=true "Roman WFI Image of a Star Cluster and Background Galaxies")
45
48
 
49
+ ## Citation
50
+
51
+ If you use STIPS, please cite the [STIPS PASP Paper](https://ui.adsabs.harvard.edu/abs/2024PASP..136l4502S/abstract) that describes the code.
52
+
53
+ ```
54
+ @ARTICLE{2024PASP..136l4502S,
55
+ author = {{Stips Development Team} and {Gomez}, Sebastian and {Bellini}, Andrea and {Al-Kowsi}, Hanna and {Desjardins}, Tyler and {Geda}, Robel and {Han}, Eunkyu and {Otor}, O. Justin and {Riedel}, Adric and {Ryan}, Russell and {Spitzer}, Isaac and {York}, Brian},
56
+ title = "{STIPS: The Nancy Grace Roman Space Telescope Imaging Product Simulator}",
57
+ journal = {\pasp},
58
+ keywords = {Astronomical techniques, Telescopes, Astronomical methods, 1684, 1689, 1043, Astrophysics - Instrumentation and Methods for Astrophysics},
59
+ year = 2024,
60
+ month = dec,
61
+ volume = {136},
62
+ number = {12},
63
+ eid = {124502},
64
+ pages = {124502},
65
+ doi = {10.1088/1538-3873/ad9524},
66
+ archivePrefix = {arXiv},
67
+ eprint = {2411.11978},
68
+ primaryClass = {astro-ph.IM},
69
+ adsurl = {https://ui.adsabs.harvard.edu/abs/2024PASP..136l4502S},
70
+ adsnote = {Provided by the SAO/NASA Astrophysics Data System}
71
+ }
72
+ ```
@@ -29,7 +29,7 @@ an output set of the following form:
29
29
 
30
30
  Pandeia version a.b.c with Data Version a.b.c. at /Some/Path/To/pandeia_refdata
31
31
 
32
- Webbpsf Version d.e.f with Data Version d.e.f at /Some/Path/To/webbpsf_data_path
32
+ STPSF Version d.e.f with Data Version d.e.f at /Some/Path/To/stpsf_data_path
33
33
 
34
34
 
35
35
  Setting Up Some Basics
@@ -16,7 +16,9 @@ It does not include instrument saturation effects.
16
16
 
17
17
  Why use STIPS?
18
18
  --------------
19
- STIPS is intended to produce quick simulations of Level 2 (L2) images, and is provided for
19
+ STIPS is intended to produce quick simulations that are corrected for distortion, but not mosaicked.
20
+ We note there is no equivalent flight product, since Roman Level 3 (L3) files are both distortion
21
+ corrected and mosaicked, while Level 2 (L2) files are neither. STIPS is ideal for
20
22
  cases where `Pandeia <https://pypi.org/project/pandeia.engine/>`_ does not
21
23
  provide a large enough simulation area (e.g., full-detector or multiple-detector
22
24
  observations). STIPS obtains its Roman instrument and filter values from
@@ -9,10 +9,10 @@ in this section along with instructions.
9
9
  STIPS Requirements
10
10
  ##################
11
11
 
12
- * ``pandeia>=3.1``: Exposure time calculator.
12
+ * ``pandeia>=2024.12``: Exposure time calculator.
13
13
 
14
- * ``webbpsf>=1.1.1``: Nancy Grace Roman PSF calculator. STIPS also requires that ``poppy``, a
15
- support package used by WebbPSF, have version ``>=1.0.3``.
14
+ * ``stpsf>=2.0.0``: Nancy Grace Roman PSF calculator. STIPS also requires that ``poppy``, a
15
+ support package used by STPSF (Formerly WebbPSF), have version ``>=1.0.3``.
16
16
 
17
17
  * ``astropy``: STIPS uses Astropy in order to:
18
18
 
@@ -97,7 +97,7 @@ Installing as a Developer
97
97
  Downloading Required Reference Data
98
98
  ************************************
99
99
 
100
- STIPS, Pandeia, and WebbPSF need the reference datasets.
100
+ STIPS, Pandeia, and STPSF require additional reference datasets.
101
101
  You will need to download the data and add them to your environmental path.
102
102
 
103
103
  1. Add the following paths to your bash environmental path. It is recommended that you add the path to your ``.bash_profile`` file:
@@ -105,7 +105,7 @@ You will need to download the data and add them to your environmental path.
105
105
  .. code-block:: text
106
106
 
107
107
  export stips_data="<absolute_path_to_this_folder>/ref_data/stips_data"
108
- export WEBBPSF_PATH="<absolute_path_to_this_folder>/ref_data/webbpsf-data"
108
+ export STPSF_PATH="<absolute_path_to_this_folder>/ref_data/stpsf-data"
109
109
  export PYSYN_CDBS="<absolute_path_to_this_folder>/ref_data/grp/redcat/trds"
110
110
  export pandeia_refdata="<absolute_path_to_this_folder>/ref_data/pandeia_data-x.x.x_roman"
111
111
 
@@ -119,6 +119,13 @@ You will need to download the data and add them to your environmental path.
119
119
 
120
120
  python retrieve_stips_data.py
121
121
 
122
+ .. caution::
123
+
124
+ Running ``retrieve_stips_data.py`` will fetch the latest versions of each
125
+ package's reference data. If you have manually configured your software
126
+ environment to use other versions of any of these packages, download their
127
+ reference data separately and configure your environment variables
128
+ appropriately to avoid confusion.
122
129
 
123
130
  Testing Installation
124
131
  *********************
@@ -144,7 +151,7 @@ You should receive an output of the following form:
144
151
 
145
152
  Pandeia version a.b.c with Data Version a.b.c. at /Some/Path/To/pandeia_refdata
146
153
 
147
- Webbpsf Version d.e.f with Data Version d.e.f at /Some/Path/To/webbpsf_data_path
154
+ STPSF Version d.e.f with Data Version d.e.f at /Some/Path/To/stpsf_data_path
148
155
 
149
156
 
150
157
  Ignore the following warning message if it appears:
@@ -2,9 +2,41 @@
2
2
  Developer Release Instructions
3
3
  ******************************
4
4
 
5
- This page offers a complete walkthrough on how to prepare and release a new
6
- version of STIPS on GitHub and PyPI, as well as how to sync the ReadTheDocs
7
- documentation with the new release.
5
+ This page offers a complete walkthrough on how to update the STIPS reference
6
+ data, prepare and release a new version of STIPS on GitHub and PyPI, and sync
7
+ the ReadTheDocs documentation with the new release.
8
+
9
+ Reference data
10
+ ==============
11
+
12
+ **Not every release will require an update to the reference data.** If one is
13
+ necessary, begin by incrementing the version number in ``VERSION.txt`` at the
14
+ base of the reference data directory.
15
+
16
+ Next, regenerate the Phoenix grid by running ``stips/data/CreatePhoenixGrid.py``
17
+ from the STIPS GitHub repository. (The file may run for an extended period.)
18
+ Save the results to the reference data directory's ``grid/`` folder. There
19
+ should be a ``.npy`` file for each WFI imaging filter, a coordinates file
20
+ (``input.pkl``), and a grid-specific version file.
21
+
22
+ Copy existing files from the ``test/`` folder and, if necessary, add any that
23
+ are needed to run new tests added to the GitHub codebase during the development
24
+ cycle. The ``.db`` files and ``residual_files`` folder at the base of the
25
+ reference data directory can be copied as they are.
26
+
27
+ Add notes on any oddities or adjustments to the reference data in ``NOTES.txt``
28
+ at the base of the reference data directory. Finally, use the following command
29
+ to compress the files while making sure that they will have the name STIPS
30
+ expects (``stips_data``) when they are unzipped. Don't accidentally delete the carat (^):
31
+
32
+ .. code-block:: text
33
+
34
+ tar -czvf stips_data-X.Y.Z.tgz -s /^YOUR-DIR-NAME/stips_data/ YOUR-DIR-NAME
35
+
36
+ Upload the zipped reference data file to Box with the name
37
+ ``stips_data-X.Y.Z.tgz``, substituting in the version numbers selected in the
38
+ first paragraph. **Wait to update** ``stips_data_current.tgz`` until you've
39
+ completed the software release on GitHub.
8
40
 
9
41
  Pre-merge instructions
10
42
  ======================
@@ -24,6 +56,8 @@ intended for a release:
24
56
  * ``environment.yml``
25
57
  * ``environment_dev.yml``
26
58
  * ``docs/installation.rst``
59
+ * ``ref_data/retrieve_stips_data.py``
60
+ * ``utilities/utilities.py`` (if any reference data links have changed)
27
61
 
28
62
  * Are you able to install the new version of STIPS locally with ``pip`` and ``conda``?
29
63
 
@@ -31,6 +65,8 @@ intended for a release:
31
65
 
32
66
  * Has ``CHANGES.rst`` been updated to include the current release and its associated updates at the top?
33
67
 
68
+ * Has ``CITATION.cff`` been updated with the relevant values in its ``version`` and ``date-released`` fields?
69
+
34
70
  * Are all CI tests in the release's pull request passing?
35
71
 
36
72
  * Has at least one developer given the pull request an official approval on GitHub?
@@ -44,6 +80,17 @@ Post-merge instructions
44
80
  Tagging the merge commit
45
81
  ------------------------
46
82
 
83
+ On your machine, check out the branch that tracks the official ``main`` branch
84
+ on the ``spacetelescope`` remote. Rebase it so it includes the newly merged pull
85
+ request. (If your local names for that branch or the ``spacetelescope`` remote
86
+ are different than the defaults – ``main`` and ``origin``, respectively – be
87
+ sure to substitute them in below.)
88
+
89
+ .. code-block:: text
90
+
91
+ git checkout origin main
92
+ git rebase origin/main
93
+
47
94
  Apply a tag to the merge commit, substituting in the proper version number.
48
95
 
49
96
  .. code-block:: text
@@ -57,9 +104,7 @@ Apply a tag to the merge commit, substituting in the proper version number.
57
104
  and `adding it to your account <https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account>`_
58
105
  if you don't have one.
59
106
 
60
- Next, push the tag online. (If your remote that points to ``spacetelescope``'s
61
- online version of the repository is not named ``origin``, be sure to substitute
62
- its name in below.)
107
+ Push the tag online.
63
108
 
64
109
  .. code-block:: text
65
110
 
@@ -75,7 +120,7 @@ manually create a new release in the ``spacetelescope/STScI-STIPS`` GitHub repos
75
120
  #. Press the "Draft a new release" button above the list of releases.
76
121
  #. Press "Choose a tag" and select the one you just pushed online. The target branch should already be selected as ``main``.
77
122
  #. Press "Generate release notes" to list the commits included in this release.
78
- #. In the "Release title" textbox, type ``Release X.Y.Z``, substituting in the proper version number.
123
+ #. In the "Release title" textbox, type ``STIPS Version X.Y.Z``, substituting in the proper version number.
79
124
  #. Above the list of commits in the larger textbox for comments, write a single-sentence summary of the release's major updates.
80
125
  #. Press "Publish" to complete this section.
81
126
 
@@ -130,12 +175,18 @@ Finally, upload them to PyPI:
130
175
 
131
176
  .. code-block:: text
132
177
 
133
- python setup.py sdist bdist_wheel
178
+ python -m twine upload dist/*
134
179
 
135
180
  Note that PyPI uploads now require an API token.
136
181
  `Refer to their instructions <https://pypi.org/help/#apitoken>`_ if you haven't
137
182
  yet set one up.
138
183
 
184
+
185
+ .. note::
186
+
187
+ If you updated the reference data, now is the proper time to update
188
+ ``stips_data_current.tgz`` on Box.
189
+
139
190
  While the official release is now complete, keep reading for instructions on
140
191
  updating the documentation on ReadTheDocs.
141
192
 
@@ -151,8 +202,14 @@ commit will be the repository's current latest commit, so both versions should
151
202
  be identical for the moment.
152
203
 
153
204
  The versions of the documentation that should be visible to the public and
154
- marked as "Active" on their "Edit" pages are ``latest`` and the new release,
155
- ``vX.Y.Z``. In the future, we may make past versions visible, too.
205
+ marked as "Active" on their "Edit" pages are ``main``, ``latest``, and the new
206
+ release, ``vX.Y.Z``. On `the "Versions" page <https://readthedocs.org/projects/stips/versions/>`_,
207
+ press "Edit" beside any other publicly visible versions and select the "Hidden"
208
+ checkbox for them. In the future, we may make past versions visible, too.
209
+
210
+ Finally, go to the "Admin" tab, make sure you're in the "Settings" section, and
211
+ change the "Default branch" to the new ``vX.Y.Z``. (Note that this is different
212
+ from the "Default version" setting further down the page, which should be ``latest``.)
156
213
 
157
214
  Troubleshooting: webhooks
158
215
  -------------------------
@@ -238,7 +238,7 @@ but is limited to a single filter. It must contain the following columns:
238
238
  retained in the observed catalog produced during the observation.)
239
239
 
240
240
  In order to identify the catalog as an Internal catalog, and in order to use
241
- it for STIPS observations, the following columns must be present:
241
+ it for STIPS observations, the following metadata must be present:
242
242
 
243
243
  * ``type=internal``
244
244
 
@@ -116,12 +116,12 @@ PSF Convolution Configuration
116
116
 
117
117
  psf_grid_default_size (default *1*)
118
118
  What size PSF grid should be created. Note that this value is expressed as
119
- a side length, so if psf_grid_default_size is set to n, WebbPSF will create
119
+ a side length, so if psf_grid_default_size is set to n, STPSF will create
120
120
  a total of n^2 PSF images. If used as a keyword argument, ``psf_grid_size``
121
121
  can be used instead of ``psf_grid_default_size`` for historical reasons.
122
122
 
123
123
  psf_cache_enable (default *true*)
124
- Whether PSF grids created by webbpsf should be cached after creation for
124
+ Whether PSF grids created by STPSF should be cached after creation for
125
125
  potential re-use.
126
126
 
127
127
  psf_cache_location (default *$DATA*)
@@ -0,0 +1,76 @@
1
+ Phoenix Model Grid and Gaps
2
+ ===========================
3
+
4
+ Grids for the pre-computed Phoenix models are available for each Roman filter. These grids will be used when the input table type is set to :ref:`'type=phoenix' <phoenix-tables>` for point sources. The grids cover stellar parameters for a range of effective temperature (teff), surface gravity (logg), and metallicity (Z).
5
+
6
+ * Effective temperature spans from 2,000 K to 70,000 K:
7
+
8
+ * at 100 K increment from 2,000 K to 7,000 K
9
+
10
+ * at 200 K increment from 7,000 K to 12,000 K
11
+
12
+ * at 500 K increment from 12,000 K to 20,000 K
13
+
14
+ * at 1000 K increment from 20,000 K to 70,000 K
15
+
16
+ * Surface gravity spans from 0.0 to 5.5 at 0.5 increment
17
+
18
+ * Metallicity spans from -4.0 to 0.5 dex
19
+
20
+ * at 0.5 dex increment from -4.0 to 0.0 dex
21
+
22
+ * above 0.0 dex, two points are available at 0.3 dex and 0.5 dex
23
+
24
+ Gaps exist where the Phoenix models are not available due to the combination of grid points being non-physical. These are the locations of the gaps:
25
+
26
+ * At logg 0.0:
27
+
28
+ * With teff above 3,000 K and Z from -4.0 dex to -2.0 dex
29
+
30
+ * With teff above 12,500 K and Z from -1.5 dex to 0.5 dex and
31
+
32
+ * At logg 0.5:
33
+
34
+ * With teff above 3,000 K and Z from -4.0 dex to -2.0 dex
35
+
36
+ * With teff above 15,500 K and Z from -1.5 dex to 0.5 dex
37
+
38
+ * At logg 1.0:
39
+
40
+ * With teff above 21,000K and all Z
41
+
42
+ * At logg 1.5:
43
+
44
+ * With teff above 26,000K and all Z
45
+
46
+ * At logg 2.0:
47
+
48
+ * With teff above 31,000K and all Z
49
+
50
+ * At logg 2.5:
51
+
52
+ * With teff above 41,000 K and Z between -4.0 dex to -0.5 dex, at 0.3 dex, or at 0.5 dex
53
+
54
+ * With teff at 41,000 K, 43,000 K, 45,000 K, 47,000 K, 49,000 K, or above 51,000 K and Z at 0.0 dex
55
+
56
+ * At logg 3.0:
57
+
58
+ * With teff above 41,000 K and all Z
59
+
60
+ * At logg 3.5:
61
+
62
+ * With teff above 51,000 K and all Z
63
+
64
+ * At logg 5.0:
65
+
66
+ * With teff above 10,200 K and Z between -4.0 dex to -1.5 dex
67
+
68
+ * With teff above 10,000 K and Z between -1.0 dex to 0.3 dex
69
+
70
+ * With teff above 3,000 K and Z at 0.5 dex
71
+
72
+ * At logg 5.5:
73
+
74
+ * With Teff above 5,100 K and Z between -4.0 dex to 0.3 dex
75
+
76
+ * With Teff above 3,000 K and Z at 0.5 dex
@@ -4,7 +4,7 @@ The STIPS PSF Grid
4
4
  Overview
5
5
  --------
6
6
 
7
- As of version 2.0.0, STIPS uses WebbPSF PSF grids to implement an ePSF. The ePSF
7
+ As of version 2.0.0, STIPS uses STPSF PSF grids to implement an ePSF. The ePSF
8
8
  uses a 3x3 grid of PSFs to handle PSF variation across the detector, and an oversample of
9
9
  4x4 to handle sub-pixel positioning. Each point source has its PSF calculated individually
10
10
  as it is added to the detector.
@@ -9,3 +9,4 @@ This section describes several important characteristics of STIPS.
9
9
  using_stips/catalogue_formats
10
10
  using_stips/config_file
11
11
  using_stips/psf_grid
12
+ using_stips/phoenix_grid
@@ -20,7 +20,6 @@ name: stips
20
20
  channels:
21
21
  - conda-forge
22
22
  - astropy
23
- - defaults
24
23
 
25
24
  dependencies:
26
25
  # Base dependencies
@@ -35,8 +34,8 @@ dependencies:
35
34
  - poppy==1.0.3
36
35
 
37
36
  # Core Modules
38
- - webbpsf>=1.1.1
39
- - pandeia.engine==3.1
37
+ - stpsf>=2.0.0
38
+ - pandeia.engine>=2024.12
40
39
  - synphot>=1.1.1
41
40
  - stsynphot>=1.1.0
42
41
  - soc_roman_tools
@@ -23,7 +23,6 @@ name: stips_dev
23
23
  channels:
24
24
  - conda-forge
25
25
  - astropy
26
- - defaults
27
26
 
28
27
  dependencies:
29
28
  # Base dependencies
@@ -38,14 +37,14 @@ dependencies:
38
37
  # Special Modules. These are temporary entries and require documentation.
39
38
  #
40
39
  # poppy 1.0.3 fixes a bug with the way poppy was calling factorial with non-integer
41
- # values. Currently this is the only way to ensure that webbpsf picks up the correct
42
- # poppy version. This peg should be removed as soon as webbpsf has updated to only
40
+ # values. Currently this is the only way to ensure that stpsf picks up the correct
41
+ # poppy version. This peg should be removed as soon as stpsf has updated to only
43
42
  # use poppy versions that include this fix.
44
43
  - poppy==1.0.3
45
44
 
46
45
  # Core Modules
47
- - webbpsf>=1.1.1
48
- - pandeia.engine==3.1
46
+ - stpsf>=2.0.0
47
+ - pandeia.engine>=2024.12
49
48
  - synphot>=1.1.1
50
49
  - stsynphot>=1.1.0
51
50
  - soc_roman_tools
@@ -66,7 +66,7 @@
66
66
  "source": [
67
67
  "## Generating and Manipulating a PSF\n",
68
68
  "\n",
69
- "PSFs can be generated using FITS input files and the makePSF module within STIPS. For this example, we will be using the example PSF file \"psf_WFI_2.0.0_F129_sca01.fits\", a PSF generated with Roman WFI F129. This file is available in the \"notebooks\" directory of STIPS. The generated PSF will be returned as an array."
69
+ "PSFs can be generated using FITS input files and the makePSF module within STIPS. For this example, we will be using the example PSF file \"psf_WFI_2.0.0_F129_wfi01.fits\", a PSF generated with Roman WFI F129. This file is available in the \"notebooks\" directory of STIPS. The generated PSF will be returned as an array."
70
70
  ]
71
71
  },
72
72
  {
@@ -76,7 +76,7 @@
76
76
  "metadata": {},
77
77
  "outputs": [],
78
78
  "source": [
79
- "example_file = fits.open('notebooks_data/psf_WFI_2.0.0_F129_sca01.fits')\n",
79
+ "example_file = fits.open('notebooks_data/psf_WFI_2.0.0_F129_wfi01.fits')\n",
80
80
  "\n",
81
81
  "test_psf = stips.utilities.makePSF.make_epsf(example_file[0].data[0])\n",
82
82
  "\n",
@@ -1,12 +1,12 @@
1
1
  ### Instructions ###
2
2
  # 1. In your ~/.bash_profile file, copy the following environment variables into
3
- # the same file (making sure to update 1.x.x version of Pandeia you're using
4
- # –– for STIPS this should be 1.7):
3
+ # the same file:
5
4
  # export stips_data="<absolute_path_to_this_folder>/ref_data/stips_data"
6
- # export WEBBPSF_PATH="<absolute_path_to_this_folder>/ref_data/webbpsf-data"
5
+ # export STPSF_PATH="<absolute_path_to_this_folder>/ref_data/stpsf-data"
7
6
  # export PYSYN_CDBS="<absolute_path_to_this_folder>/ref_data/grp/redcat/trds"
8
7
  # export pandeia_refdata="<absolute_path_to_this_folder>/ref_data/pandeia_data-
9
- # 1.7_roman"
8
+ # 2024.12-roman"
9
+ #
10
10
  # 2. In the ref_data folder, run the script: python retrieve_stips_data.py
11
11
 
12
12
  import stips
@@ -1,6 +1,6 @@
1
1
  [metadata]
2
2
  name = stips
3
- version = 2.2.1
3
+ version = 2.3
4
4
  author = Space Telescope Science Institute
5
5
  author_email = york@stsci.edu
6
6
  description = STIPS is the Space Telescope Imaging Product Simulator.
@@ -22,8 +22,8 @@ install_requires =
22
22
  photutils
23
23
  synphot>=1.1.1
24
24
  stsynphot>=1.1.0
25
- webbpsf>=1.1.1
26
- pandeia.engine==3.1
25
+ stpsf>=2.0.0
26
+ pandeia.engine>=2024.12
27
27
  montage-wrapper
28
28
  pyyaml
29
29
  soc_roman_tools
@@ -4,7 +4,7 @@ import os
4
4
 
5
5
  __all__ = ['observation_module', 'scene_module']
6
6
 
7
- __version__ = "2.2.1"
7
+ __version__ = "2.3"
8
8
  version = __version__
9
9
 
10
10
  from .utilities import SetupDataPaths