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.
- {stips-2.2.1 → stips-2.3}/CHANGES.rst +17 -0
- stips-2.3/CITATION.cff +41 -0
- {stips-2.2.1/stips.egg-info → stips-2.3}/PKG-INFO +4 -4
- {stips-2.2.1 → stips-2.3}/README.md +29 -2
- {stips-2.2.1 → stips-2.3}/docs/basic_tutorial.rst +1 -1
- {stips-2.2.1 → stips-2.3}/docs/index.rst +3 -1
- {stips-2.2.1 → stips-2.3}/docs/installation.rst +13 -6
- {stips-2.2.1 → stips-2.3}/docs/release.rst +67 -10
- {stips-2.2.1 → stips-2.3}/docs/using_stips/catalogue_formats.rst +1 -1
- {stips-2.2.1 → stips-2.3}/docs/using_stips/config_file.rst +2 -2
- stips-2.3/docs/using_stips/phoenix_grid.rst +76 -0
- {stips-2.2.1 → stips-2.3}/docs/using_stips/psf_grid.rst +1 -1
- {stips-2.2.1 → stips-2.3}/docs/using_stips.rst +1 -0
- {stips-2.2.1 → stips-2.3}/environment.yml +2 -3
- {stips-2.2.1 → stips-2.3}/environment_dev.yml +4 -5
- {stips-2.2.1 → stips-2.3}/notebooks/STIPS Advanced II - PSFs.ipynb +2 -2
- {stips-2.2.1 → stips-2.3}/ref_data/retrieve_stips_data.py +4 -4
- {stips-2.2.1 → stips-2.3}/setup.cfg +3 -3
- {stips-2.2.1 → stips-2.3}/stips/__init__.py +1 -1
- {stips-2.2.1 → stips-2.3}/stips/astro_image/astro_image.py +53 -32
- {stips-2.2.1 → stips-2.3}/stips/data/CreatePhoenixGrid.py +20 -12
- {stips-2.2.1 → stips-2.3}/stips/data/stips_config.yaml +3 -3
- {stips-2.2.1 → stips-2.3}/stips/instruments/instrument.py +9 -3
- {stips-2.2.1 → stips-2.3}/stips/instruments/roman_instrument.py +2 -5
- {stips-2.2.1 → stips-2.3}/stips/instruments/wfi.py +39 -30
- {stips-2.2.1 → stips-2.3}/stips/stellar_module/star_generator.py +2 -2
- {stips-2.2.1 → stips-2.3}/stips/utilities/tests/test_makePSF.py +1 -1
- {stips-2.2.1 → stips-2.3}/stips/utilities/utilities.py +36 -35
- {stips-2.2.1 → stips-2.3/stips.egg-info}/PKG-INFO +4 -4
- {stips-2.2.1 → stips-2.3}/stips.egg-info/SOURCES.txt +4 -2
- {stips-2.2.1 → stips-2.3}/stips.egg-info/requires.txt +2 -2
- {stips-2.2.1 → stips-2.3}/.github/workflows/ci_workflows.yml +0 -0
- {stips-2.2.1 → stips-2.3}/.gitignore +0 -0
- {stips-2.2.1 → stips-2.3}/.readthedocs.yaml +0 -0
- {stips-2.2.1 → stips-2.3}/.rtd-environment.yml +0 -0
- {stips-2.2.1 → stips-2.3}/CITATION +0 -0
- {stips-2.2.1 → stips-2.3}/CODE_OF_CONDUCT.md +0 -0
- {stips-2.2.1 → stips-2.3}/CONTRIBUTING.md +0 -0
- {stips-2.2.1 → stips-2.3}/Dockerfile +0 -0
- {stips-2.2.1 → stips-2.3}/MANIFEST.in +0 -0
- {stips-2.2.1 → stips-2.3}/docs/Makefile +0 -0
- {stips-2.2.1 → stips-2.3}/docs/bugs.rst +0 -0
- {stips-2.2.1 → stips-2.3}/docs/conf.py +0 -0
- {stips-2.2.1 → stips-2.3}/docs/examples.rst +0 -0
- {stips-2.2.1 → stips-2.3}/docs/exts/numfig.py +0 -0
- {stips-2.2.1 → stips-2.3}/docs/help.rst +0 -0
- {stips-2.2.1 → stips-2.3}/docs/make.bat +0 -0
- {stips-2.2.1 → stips-2.3}/docs/requirements.txt +0 -0
- {stips-2.2.1 → stips-2.3}/docs/roman_figures/stips_basic_tutorial.png +0 -0
- {stips-2.2.1 → stips-2.3}/docs/roman_figures/stips_demo.png +0 -0
- {stips-2.2.1 → stips-2.3}/docs/rtd-pip-requirements +0 -0
- {stips-2.2.1 → stips-2.3}/licenses/LICENSE.rst +0 -0
- {stips-2.2.1 → stips-2.3}/licenses/README.rst +0 -0
- {stips-2.2.1 → stips-2.3}/licenses/TEMPLATE_LICENCE.rst +0 -0
- {stips-2.2.1 → stips-2.3}/notebooks/STIPS Advanced I /342/200/223 Further Observations, Noise and Distortion.ipynb" +0 -0
- {stips-2.2.1 → stips-2.3}/notebooks/STIPS Basic Tutorial.ipynb +0 -0
- /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
- {stips-2.2.1 → stips-2.3}/setup.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/astro_image/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_AstroImage.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_header.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/astro_image/tests/test_wcs.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/conftest.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/data/CreateIsochroneGrid.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/data/__init__.py +0 -0
- /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
- {stips-2.2.1 → stips-2.3}/stips/errors/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/errors/make_cosmic_ray.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/instruments/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/observation_module/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/observation_module/observation_module.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/scene_module/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/scene_module/convert_units.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/scene_module/scene_module.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/stellar_module/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/tests/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/utilities/DataTable.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/utilities/__init__.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/utilities/makePSF.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/utilities/testing.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips/utilities/tests/test_config.py +0 -0
- {stips-2.2.1 → stips-2.3}/stips.egg-info/dependency_links.txt +0 -0
- {stips-2.2.1 → stips-2.3}/stips.egg-info/not-zip-safe +0 -0
- {stips-2.2.1 → stips-2.3}/stips.egg-info/top_level.txt +0 -0
- {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
|
+
Metadata-Version: 2.4
|
|
2
2
|
Name: stips
|
|
3
|
-
Version: 2.
|
|
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:
|
|
16
|
-
Requires-Dist: pandeia.engine
|
|
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
|
[](https://github.com/spacetelescope/STScI-STIPS/actions/workflows/ci_workflows.yml?query=branch:main)
|
|
4
4
|
[](http://www.stsci.edu)
|
|
5
|
+
[](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
|
|
25
|
-
|
|
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
|

|
|
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
|
-
|
|
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
|
|
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>=
|
|
12
|
+
* ``pandeia>=2024.12``: Exposure time calculator.
|
|
13
13
|
|
|
14
|
-
* ``
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
6
|
-
version of STIPS on GitHub and PyPI,
|
|
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
|
-
|
|
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 ``
|
|
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
|
|
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
|
|
155
|
-
``vX.Y.Z``.
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
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.
|
|
@@ -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
|
-
-
|
|
39
|
-
- pandeia.engine
|
|
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
|
|
42
|
-
# poppy version. This peg should be removed as soon as
|
|
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
|
-
-
|
|
48
|
-
- pandeia.engine
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
#
|
|
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.
|
|
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
|
-
|
|
26
|
-
pandeia.engine
|
|
25
|
+
stpsf>=2.0.0
|
|
26
|
+
pandeia.engine>=2024.12
|
|
27
27
|
montage-wrapper
|
|
28
28
|
pyyaml
|
|
29
29
|
soc_roman_tools
|