Merge pull request #480 from bjkuhn/wfc3_su_patch

miscellaneous changes for WFC3 grism notebooks

Author: cshanahan1

_toc.yml

@@ -85,7 +85,6 @@ parts:
         - file: notebooks/WFC3/exception_report/wfc3_exception_report.ipynb
         - file: notebooks/WFC3/calwf3_v1.0_cte/calwf3_with_v1.0_PCTE.ipynb
         - file: notebooks/WFC3/persistence/wfc3_ir_persistence.ipynb
-        - file: notebooks/WFC3/uvis_g280_transit/G280_Exoplanet_Transits.ipynb
     - file: notebooks/WFC3/ir_tvb.md
       sections:
         - file: notebooks/WFC3/ir_ima_visualization/IR_IMA_Visualization_with_an_Example_of_Time_Variable_Background.ipynb
@@ -105,3 +104,9 @@ parts:
       sections:
       - file: notebooks/WFC3/point_spread_function/hst_point_spread_function.ipynb
       - file: notebooks/WFC3/mast_api_psf/download_psf_cutouts.ipynb
+    - file: notebooks/WFC3/grism_spectroscopy.md
+      sections:
+      - file: notebooks/WFC3/uvis_g280_transit/G280_Exoplanet_Transits.ipynb
+      - file: notebooks/WFC3/slitlessutils_IR_extraction/slitlessutils_IR_extraction.ipynb
+      - file: notebooks/WFC3/slitlessutils_UVIS_fullframe_extraction/slitlessutils_UVIS_fullframe_extraction.ipynb
+      - file: notebooks/WFC3/slitlessutils_UVIS_subarray_extraction/slitlessutils_UVIS_subarray_extraction.ipynb

notebooks/WFC3/README.md

@@ -5,7 +5,7 @@
 WFC3 Notebooks is the primary repository for analyzing data from the 
 [Wide Field Camera 3](https://www.stsci.edu/hst/instrumentation/wfc3) on the 
 Hubble Space Telescope. The Jupyter notebooks include tools for general data analysis, 
-WFC3/IR time variable background (TVB), photometry and point spread function (PSF) modeling. This repository contains the 
+WFC3/IR time variable background (TVB), photometry, and point spread function (PSF) modeling. This repository contains the 
 complementary notebooks mentioned in the [WFC3 Data Handbook](https://hst-docs.stsci.edu/wfc3dhb).
 These notebooks include:
 
@@ -14,7 +14,6 @@ General Tools:
 - [Exception Report Checklist - WFC3](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/exception_report/wfc3_exception_report.html)
 - [Processing WFC3/UVIS Data with `calwf3` Using the v1.0 CTE-Correction](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/calwf3_v1.0_cte/calwf3_with_v1.0_PCTE.html)
 - [Masking Persistence in WFC3/IR Images](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/persistence/wfc3_ir_persistence.html)
-- [Analyzing WFC3/UVIS G280 Exoplanet Transit Observations](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/uvis_g280_transit/G280_Exoplanet_Transits.html)
 
 WFC3/IR Time Variable Background (TVB):
 - [WFC3/IR IMA Visualization Tools with an Example of Time Variable Background](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/ir_ima_visualization/IR_IMA_Visualization_with_an_Example_of_Time_Variable_Background.html)
@@ -35,6 +34,12 @@ Point Spread Function (PSF):
  - [HST WFC3 Point Spread Function Modeling](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/point_spread_function/hst_point_spread_function.html)
  - [Downloading WFC3 and WFPC2 PSF Cutouts from MAST](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/mast_api_psf/download_psf_cutouts.html)
 
+Grism Spectroscopy:
+- [Analyzing WFC3/UVIS G280 Exoplanet Transit Observations](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/uvis_g280_transit/G280_Exoplanet_Transits.html)
+- [`Slitlessutils` Cookbook: Spectral Extraction for WFC3/IR](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/slitlessutils_IR_extraction/slitlessutils_IR_extraction.html)
+- [`Slitlessutils` Cookbook: Spectral Extraction for WFC3/UVIS Full-Frame](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/slitlessutils_UVIS_fullframe_extraction/slitlessutils_UVIS_fullframe_extraction.html)
+- [`Slitlessutils` Cookbook: Spectral Extraction for WFC3/UVIS Subarray](https://spacetelescope.github.io/hst_notebooks/notebooks/WFC3/slitlessutils_UVIS_subarray_extraction/slitlessutils_UVIS_subarray_extraction.html)
+  
 See the [WFC3 Instrument Handbook](https://hst-docs.stsci.edu/wfc3ihb),
 [WFC3 Data Handbook](https://hst-docs.stsci.edu/wfc3dhb),
 [wfc3tools](https://github.com/spacetelescope/wfc3tools), and 
@@ -47,15 +52,15 @@ Before running these examples, you **must** follow the general instructions on c
 
 ## Contributing
 
-New contributions and feedback are very welcomed! Please open a new [issue](https://github.com/spacetelescope/hst_notebooks/issues) or new pull request for bugs, feedback, or new features you would like to see. If there is an issue you would like to work on, please leave a comment and we will be happy to assist. Questions can also be sent to the WFC3 team through the [HST Help Desk](https://stsci.service-now.com/hst).
+New contributions and feedback are very welcome! Please open a new [issue](https://github.com/spacetelescope/hst_notebooks/issues) or new pull request for bugs, feedback, or new features you would like to see. If there is an issue you would like to work on, please leave a comment and we will be happy to assist. Questions can also be sent to the WFC3 team through the [HST Help Desk](https://stsci.service-now.com/hst).
 
-WFC3 Notebooks follows the 
+WFC3 Notebooks follow the 
 [Astropy Code of Conduct](https://www.astropy.org/code_of_conduct.html)
 and strives to provide a welcoming community to all of our users and 
 contributors.
 
 Want more information about how to make a contribution?  Take a look at
-the the `astropy` 
+the `astropy` 
 [contributing](https://www.astropy.org/contribute.html)
 and [developer](https://docs.astropy.org/en/stable/index.html#developer-documentation) 
 documentation.

notebooks/WFC3/general_tools.md

@@ -26,10 +26,3 @@ persistence in the calibrated (FLT) science images. When the images are
 sufficiently dithered to step over the observed persistence artifacts, 
 AstroDrizzle may be used to exclude those flagged pixels when combining the FLT 
 frames. 
-
-## Analyzing WFC3/UVIS G280 Exoplanet Transit Observations
-We present the reduction and analysis of exoplanet transit observations of the 
-hot Jupiter HAT-P-41b taken with the WFC3/UVIS G280 grism. The notebook
-demonstrates source finding, background subtraction, cosmic ray rejection, 
-subarray embedding, spectral trace fitting, spectum extraction, and light curve
-generation.

notebooks/WFC3/grism_spectroscopy.md

@@ -0,0 +1,33 @@
+![STScI Logo](../../_static/stsci_header.png)
+
+# Grism Spectroscopy
+Here are brief descriptions of the WFC3 Notebooks for grism spectroscopy 
+analysis.
+
+## Analyzing WFC3/UVIS G280 Exoplanet Transit Observations
+We present the reduction and analysis of exoplanet transit observations of the 
+hot Jupiter HAT-P-41b taken with the WFC3/UVIS G280 grism. The notebook
+demonstrates source finding, background subtraction, cosmic ray rejection, 
+subarray embedding, spectral trace fitting, spectrum extraction, and light curve
+generation.
+
+## Slitlessutils Cookbook: Spectral Extraction for WFC3/IR
+This notebook demonstrates an end-to-end workflow for extracting 1D spectra from
+G102 or G141 data using `slitlessutils`. This example guides users through the 
+recommended procedure for analyzing slitless data, including downloading data, 
+preparing direct and dispersed images, performing background subtraction, and 
+executing the traditional extraction mode.
+
+## Slitlessutils Cookbook: Spectral Extraction for WFC3/UVIS Full-Frame
+This notebook demonstrates an end-to-end workflow for extracting 1D spectra from
+G280 full-frame data using `slitlessutils`. This example guides users through the 
+recommended procedure for analyzing slitless data, including downloading data, 
+preparing direct and dispersed images, performing background subtraction, and 
+executing the traditional extraction mode.
+
+## Slitlessutils Cookbook: Spectral Extraction for WFC3/UVIS Subarray
+This notebook demonstrates an end-to-end workflow for extracting 1D spectra from
+G280 subarray data using `slitlessutils`. This example guides users through the 
+recommended procedure for analyzing slitless data, including downloading data, 
+preparing direct and dispersed images, performing background subtraction, and 
+executing the traditional extraction mode.

notebooks/WFC3/slitlessutils_IR_extraction/requirements.txt

@@ -6,4 +6,4 @@ jupyterlab==4.3.1
 matplotlib==3.9.4
 pyregion
 wfc3tools
-git+https://github.com/spacetelescope/slitlessutils.git
+slitlessutils>=2.0

notebooks/WFC3/slitlessutils_UVIS_fullframe_extraction/requirements.txt

@@ -4,4 +4,4 @@ jupyter
 jupyterlab==4.3.1
 matplotlib==3.9.4
 pyregion
-git+https://github.com/spacetelescope/slitlessutils.git
+slitlessutils>=2.0

notebooks/WFC3/slitlessutils_UVIS_subarray_extraction/requirements.txt

@@ -4,4 +4,4 @@ jupyter
 jupyterlab==4.3.1
 matplotlib==3.9.4
 pyregion
-git+https://github.com/spacetelescope/slitlessutils.git
+slitlessutils>=2.0