Merge pull request #483 from Jackie-Brown/add_timetag_notebook

add time_tag notebook

Author: cshanahan1

_toc.yml

@@ -76,6 +76,7 @@ parts:
     - file: notebooks/STIS/extraction/1D_Extraction.ipynb
     - file: notebooks/STIS/low_count_uncertainties/Low_Count_Uncertainties.ipynb
     - file: notebooks/STIS/contrast_sensitivity/STIS_Coronagraphic_Observation_Feasibility.ipynb
+    - file: notebooks/STIS/time_tag/time_tag.ipynb
   - caption: WFC3
     chapters:
     - file: notebooks/WFC3/README.md

notebooks/.gitignore

@@ -38,4 +38,5 @@ MAST/Kepler/Kepler_TPF/mastDownload/
 !**/inclusions*.txt
 !STIS/contrast_sensitivity/ETC_example.jpg
 !STIS/contrast_sensitivity/TWHya.txt
-!STIS/low_count_uncertainties/STIS_GJ436b_inttag.png
+!STIS/low_count_uncertainties/STIS_GJ436b_inttag.png
+!STIS/time_tag/oemw01030_a2centers.png

notebooks/STIS/README.md

@@ -25,6 +25,7 @@ The current operational notebooks with a short description:
 | extraction              | 1D Spectra Extraction                                  | An introductory Jupyter Notebook that shows how to visualize the 1-D extraction. This is useful for cases where a user may want to do a custom extraction or background subtraction. It shows how to find the important keywords and plot the extraction and background regions used for the extraction to generate X1D data. The notebook contains an example with a first order spectrum and with echelle data.                                                                                         | [1D_Extraction.ipynb](https://github.com/spacetelescope/hst_notebooks/tree/main/notebooks/STIS/extraction)                                        | [1D_Extraction.html](https://spacetelescope.github.io/hst_notebooks/notebooks/STIS/extraction/1D_Extraction.html)                                                                     |
 | low_count_uncertainties | Low Count Uncertainties in STIS                        | A Jupyter Notebook exploring how uncertainties are calculated in the STIS pipeline. This also shows how certain approximations break down in the low flux regime (e.g., dim FUV continua), and demonstrates how users can calculate more robust uncertainties when dealing with low flux data. Lastly, this explores a known bug in calculation of uncertainties when using INTTAG to split exposures into sub-exposures in TIME-TAG files.                                                               | [Low_Count_Uncertainties.ipynb](https://github.com/spacetelescope/hst_notebooks/tree/main/notebooks/STIS/low_count_uncertainties)                 | [Low_Count_Uncertainties.html](https://spacetelescope.github.io/hst_notebooks/notebooks/STIS/low_count_uncertainties/Low_Count_Uncertainties.html)                                    |
 | target_acquisition      | Evaluating STIS Target Acquisitions                    | An introductory Jupyter Notebook that shows how to visualize and obtain information about a target acquisition. It provides examples for a successful acquisition and several typical failure cases.                                                                                                                                                                                                                                                                                                      | [target_acquisition.ipynb](https://github.com/spacetelescope/hst_notebooks/tree/main/notebooks/STIS/target_acquisition)                           | [target_acquisition.html](https://spacetelescope.github.io/hst_notebooks/notebooks/STIS/target_acquisition/target_acquisition.html)                                                   |
+| time_tag | Introduction to TIME-TAG Data | An introductory Jupyter Notebook that shows how to navigate TIME-TAG file structures, display the raw data with several methods, calibrate the full exposure, and split data into sub-exposures. | [time_tag.ipynb](https://github.com/spacetelescope/hst_notebooks/tree/main/notebooks/STIS/time_tag) | [time_tag.html](https://spacetelescope.github.io/hst_notebooks/notebooks/STIS/time_tag/time_tag.html) |
 | view_data               | Viewing STIS Data                                      | The tutorial introduces handling STIS Data extensions, including examining Data Quality Flags. Several strategies explore how to visually examine STIS Data within a notebook to reproduce plots and tables. A section on using TIME-TAG mode data shows how to construct a flux plot and generate ACCUM images from TIME-TAG data with the stistools with the int_tag tool. A section on the STIS Gratings Echelle mode data shows how to display the echelle image and plot echelles by spectral order. | [view_data.ipynb](https://github.com/spacetelescope/hst_notebooks/tree/main/notebooks/STIS/view_data)                                             | [view_data.html](https://spacetelescope.github.io/hst_notebooks/notebooks/STIS/view_data/view_data.html)                                                                              |
 
 

notebooks/STIS/time_tag/oemw01030_a2centers.png

@@ -0,0 +1 @@
+conda install --yes -c conda-forge hstcal

notebooks/STIS/time_tag/pre-requirements.sh

@@ -0,0 +1,7 @@
+astroquery>=0.4.6
+astropy>=6.0.0
+numpy>=1.26.3
+scipy>=1.12.0
+matplotlib>=3.8.2
+stistools >=1.4.6
+crds>=11.17