Skip to content

Commit 5c87fa8

Browse files
authored
Merge branch 'main' into bkuhn_wfc3_edits
2 parents a96b236 + 57103d3 commit 5c87fa8

83 files changed

Lines changed: 39502 additions & 598 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,14 +36,14 @@ it requires no special tools beyond your web browser.
3636
See [this website](https://spacetelescope.github.io/hst_notebooks/)
3737

3838
To download and execute the notebooks, we recommend you clone
39-
the `hst_notebooks <https://github.com/spacetelescope/hst_notebooks>`_
39+
the `hst_notebooks <https://github.com/spacetelescope/hst_notebooks>`
4040
repository to your local computer.
4141

4242
You can also click the "Download ZIP" option for the entire repository listed under the green "Code" button at the top of the repository landing page. You are also able to download individual notebooks, but it is not as straight forward or recommended, so we do not provide details here.
4343

4444
Most notebooks have additional associated files in their folder,
4545
including a requirements file that lists packages necessary to run the notebooks.
46-
The packages in the requirements file can be installed using `pip <https://pip.pypa.io/en/stable/>`_ .
46+
The packages in the requirements file can be installed using `pip <https://pip.pypa.io/en/stable/>`.
4747

4848
Any version dependencies are contained in the requirements file in
4949
each notebook folder. Please use at least the minimum supported
@@ -69,12 +69,12 @@ You can then proceed to install the requirements for the specific notebook you a
6969
Run the notebook in an appropriate environment
7070
----------------------------------------------
7171

72-
Once you are in the directory of the notebook you want to use, make sure you have a populated environment that contains the required pacages::
72+
Once you are in the directory of the notebook you want to use, make sure you have a populated environment that contains the required packages:
7373

7474
cd hst_notebooks/notebooks/<notebook-name>
7575

7676
You may want to consider installing your notebooks in a new conda/mamba environment
77-
to avoid version conflicts with other packages you may have installed, for example::
77+
to avoid version conflicts with other packages you may have installed, for example:
7878

7979
conda create -n hstnb python pip jupyter
8080
conda activate hstnb

_toc.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,18 @@ parts:
4545
- file: notebooks/DrizzlePac/drizzle_wfpc2/drizzle_wfpc2.ipynb
4646
- caption: HASP
4747
chapters:
48+
- file: notebooks/HASP/README.md
4849
- file: notebooks/HASP/Setup/Setup.ipynb
4950
- file: notebooks/HASP/CoaddTutorial/CoaddTutorial.ipynb
5051
- file: notebooks/HASP/FluxScaleTutorial/FluxScaleTutorial.ipynb
5152
- file: notebooks/HASP/DataDiagnostic/DataDiagnostics.ipynb
5253
- file: notebooks/HASP/WavelengthAdjustment/WavelengthAdjustment.ipynb
53-
- file: notebooks/HASP/COSLifetimePositions/COSLifetimePositions.ipynb
54+
- caption: HSLA
55+
chapters:
56+
- file: notebooks/HSLA/README.md
57+
- file: notebooks/HSLA/COSLifetimePositions/COSLifetimePositions.ipynb
58+
- file: notebooks/HSLA/Intro/Intro.ipynb
59+
- file: notebooks/HSLA/Setup/Setup.ipynb
5460
- caption: NICMOS
5561
chapters:
5662
- file: notebooks/NICMOS/nicmos_unit_conversion/nicmos_unit_conversion.ipynb

index.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[![DOI](https://zenodo.org/badge/605151805.svg)](https://zenodo.org/badge/latestdoi/605151805)
66

7-
Welcome to the STScI HST Notebook Repository
7+
Welcome to the STScI HST Notebook Repository!
88

99
This resource provides comprehensive documentation and interactive notebooks created by the Hubble Space Telescope instruments' teams.
1010

@@ -13,6 +13,8 @@ Explore our interactive notebooks for hands-on experience with HST data.
1313
- [ACS notebooks](./notebooks/ACS/README.md)
1414
- [COS notebooks](./notebooks/COS/README.md)
1515
- [DrizzlePac notebooks](./notebooks/DrizzlePac/README.md)
16+
- [HASP notebooks](./notebooks/HASP/README.md)
17+
- [HSLA notebooks](./notebooks/HSLA/README.md)
1618
- [NICMOS notebooks](./notebooks/NICMOS/nicmos_unit_conversion/nicmos_unit_conversion.ipynb)
1719
- [STIS notebooks](./notebooks/STIS/README.md)
1820
- [WFC3 notebooks](./notebooks/WFC3/README.md)
@@ -26,6 +28,10 @@ Here, you can find detailed documentation for each instrument the Hubble Space T
2628

2729
- [DrizzlePac](https://www.stsci.edu/scientific-community/software/drizzlepac)
2830

31+
- [Hubble Advanced Spectral Products (HASP)](https://archive.stsci.edu/missions-and-data/hst/hasp)
32+
33+
-[Hubble Spectroscopic Legacy Archive (HSLA)](https://archive.stsci.edu/missions-and-data/hsla)
34+
2935
- [Near Infrared Camera and Multi-Object Spectrometer (NICMOS)](https://www.stsci.edu/hst/instrumentation/legacy/nicmos)
3036

3137
- [Space Telescope Imaging Spectrograph (STIS)](https://www.stsci.edu/hst/instrumentation/stis)
@@ -46,7 +52,7 @@ You can also click the "Download ZIP" option for the entire repository listed un
4652

4753
Most notebooks have additional associated files in their folder,
4854
including a requirements file that lists packages necessary to run the notebooks.
49-
The packages in the requirements file can be installed using `pip <https://pip.pypa.io/en/stable/>` .
55+
The packages in the requirements file can be installed using `pip <https://pip.pypa.io/en/stable/>`.
5056

5157
Any version dependencies are contained in the requirements file in
5258
each notebook folder. Please use at least the minimum supported

notebooks/ACS/README.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,31 +15,36 @@ Jupyter Notebooks allow code to be packaged with formatted text to create illust
1515

1616

1717
## Before Running a Notebook
18-
Before running these examples you **must** follow the general instructions on creating an environment that can run the notebooks, shown in STScI HST Notebook Repository HQ page under [Installation Instructions](https://spacetelescope.github.io/hst_notebooks/index.html).
18+
Before running these examples, you **must** follow the general instructions on creating an environment that can run the notebooks, shown in STScI HST Notebook Repository HQ page under [**Installation Instructions**](https://spacetelescope.github.io/hst_notebooks/index.html).
1919

2020

2121
## Contents
2222

2323
### Simple Example Notebooks
2424

25-
* **acs_subarrays**: Instructions for how to use the `acstools.acs_destripe_plus` module to calibrate, de-stripe, and correct ACS subarray observations for charge transfer efficiency (CTE). Also included are instructions for updating the `OSCNTAB` reference file to subtract the bias level from the prescan columns in user-defined subarray observations.
25+
* [**acs_subarrays**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_subarrays/acs_subarrays.html): Instructions for how to use the `acstools.acs_destripe_plus` module to calibrate, de-stripe, and correct ACS subarray observations for charge transfer efficiency (CTE). Also included are instructions for updating the `OSCNTAB` reference file to subtract the bias level from the prescan columns in user-defined subarray observations.
2626

27-
* **acs_pixel_area_maps**: This notebook shows how to use Python to create pixel area maps (PAMs) to account for the effects of geometric distortion in distorted images. This enables users to perform photometry on distorted images.
27+
* [**acs_pixel_area_maps**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_pixel_area_maps/acs_pixel_area_maps.html): This notebook shows how to use Python to create pixel area maps (PAMs) to account for the effects of geometric distortion in distorted images. This enables users to perform photometry on distorted images.
2828

29-
* **acs_polarization_tools**: ACS/WFC offers two sets of polarizers, UV and visible, for imaging polarimetry and imaging spectropolarimetry. This notebook provides guidance on using the `acstools.polarization_tools` module to retrieve polarization calibration coefficients and calculate polarization properties of a source.
29+
* [**acs_polarization_tools**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_polarization_tools/acs_polarization_tools.html): ACS/WFC offers two sets of polarizers, UV and visible, for imaging polarimetry and imaging spectropolarimetry. This notebook provides guidance on using the `acstools.polarization_tools` module to retrieve polarization calibration coefficients and calculate polarization properties of a source.
30+
31+
* [**acs_exception_report**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_exception_report/exception_report_checks.html): This notebook provides a step-by-step guide for examining your ACS data and observing logs to identify potential data quality issues via an HST Exception Report, and outlines the process for deciding whether a HOPR or Help Desk ticket is warranted.
3032

3133
### Complex Workflow Notebooks
3234

33-
* **acs_reduction**: This worked example demonstrates how to use the CALACS pipeline to re-process raw ACS data retrieved from MAST. Users are shown how to update reference files in the image headers, retrieve reference files from the Calibration Reference Data System (CRDS), and how to toggle steps in the calibration pipeline (e.g., CTE correction).
35+
* [**acs_reduction**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_reduction/acs_reduction.html): This worked example demonstrates how to use the CALACS pipeline to re-process raw ACS data retrieved from MAST. Users are shown how to update reference files in the image headers, retrieve reference files from the Calibration Reference Data System (CRDS), and how to toggle steps in the calibration pipeline (e.g., CTE correction).
36+
37+
* [**acs_cte_forward_model**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_cte_forward_model/acs_cte_forward_model_example.html): The capability to simulate the readout of an ACS image at a given epoch is a feature of CALACS that does not run during standard calibration. This example demonstrates how to take a pristine image, or one corrected for time-dependent CTE loss, and simulate CTE losses for an arbitrary observation date using `acstools.acscteforwardmodel`.
3438

35-
* **acs_cte_forward_model** The capability to simulate the readout of an ACS image at a given epoch is a feature of CALACS that does not run during standard calibration. This example demonstrates how to take a pristine image, or one corrected for time-dependent CTE loss, and simulate CTE losses for an arbitrary observation date using `acstools.acscteforwardmodel`.
39+
* [**acs_saturation_trails**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_saturation_trails/acs_saturation_trails.html): The ACS/WFC CCDs remain linear beyond the full-well saturation, which allows users the opportunity to perform photometry on saturated stars. This notebook demonstrates the methods and caveats when performing saturated star photometry.
3640

37-
* **acs_saturation_trails** The ACS/WFC CCDs remain linear beyond the full-well saturation, which allows users the opportunity to perform photometry on saturated stars. This notebook demonstrates the methods and caveats when performing saturated star photometry.
41+
* [**acs_sbc_dark_analysis**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_sbc_dark_analysis/acs_sbc_dark_analysis.html): The ACS Solar Blind Channel (SBC) has nominally negligible dark current. However, the temperature of the SBC detector increases steadily over time while it is in use, and the dark current is proportional to temperature. At temperatures above 25 ºC, the dark current is no longer negligible and must be subtracted. This workflow demonstrates how to account for dark current in ACS/SBC observations.
3842

39-
* **acs_sbc_dark_analysis**: The ACS Solar Blind Channel (SBC) has nominally negligible dark current. However, the temperature of the SBC detector increases steadily over time while it is in use, and the dark current is proportional to temperature. At temperatures above 25 ºC, the dark current is no longer negligible and must be subracted. This workflow demonstrates how to account for dark current in ACS/SBC observations.
43+
* [**acs_findsat_mrt_example**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_findsat_mrt/acs_findsat_mrt_example.html): ACS/WFC imaging data is often affected by contamination by artificial satellites, compromising science data. The `acstools.findsat_mrt` module can be used to identify satellite trails and create masks to reject affected pixels from further analysis.
4044

41-
* **acs_findsat_mrt_example.ipynb**: ACS/WFC imaging data is often affected by contamination by artificial satellites, compromising science data. The `acstools.findsat_mrt` module can be used to identify satellite trails and create masks to reject affected pixels from further analysis.
45+
* [**acs_focus_diverse_epsfs**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/acs_focus_diverse_epsfs/acs_focus_diverse_epsfs.html): This notebook provides instructions on using the `acstools.focus_diverse_epsfs` module to retrieve empirical, focus-diverse ePSFs for ACS/WFC data.
4246

47+
* [**hst_orbits_ephem**](https://spacetelescope.github.io/hst_notebooks/notebooks/ACS/hst_orbits_ephem/hst_orbits_ephem.html): Instructions on how to obtain information about HST’s location and pointing direction relative to Earth and the Sun for a given observation.
4348

4449
## Contributing
4550

notebooks/ACS/acs_cte_forward_model/acs_cte_forward_model_example.ipynb

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1315,9 +1315,7 @@
13151315
"<hr>\n",
13161316
"\n",
13171317
"[Top of Page](#title_ID)\n",
1318-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> \n",
1319-
"<br></br>\n",
1320-
"<br></br>"
1318+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
13211319
]
13221320
}
13231321
],

notebooks/ACS/acs_exception_report/exception_report_checks.ipynb

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -631,7 +631,9 @@
631631
"id": "3d93d354-cad5-4b57-bb40-29b0272750d5",
632632
"metadata": {},
633633
"source": [
634-
"## Citations <a id=\"citations\"></a>\n",
634+
" <a id=\"citations\"></a>\n",
635+
"\n",
636+
"## Citations\n",
635637
"If you use Python packages for published research, please cite the authors. Follow these links for more <br>\n",
636638
"information about citing packages such as `astropy`, `astroquery`, `matplotlib`, `photutils`, etc.:\n",
637639
"\n",
@@ -641,9 +643,7 @@
641643
"* [Citing `numpy`](https://numpy.org/citing-numpy/)\n",
642644
"* [Citing `photutils`](https://photutils.readthedocs.io/en/stable/getting_started/citation.html)\n",
643645
"* [Citing `scipy`](https://scipy.org/citing-scipy/)\n",
644-
"<br>\n",
645-
"\n",
646-
"<hr>\n"
646+
"<br>"
647647
]
648648
},
649649
{
@@ -660,7 +660,7 @@
660660
"<hr>\n",
661661
"\n",
662662
"[Top of Page](#top)\n",
663-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
663+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
664664
]
665665
}
666666
],

notebooks/ACS/acs_findsat_mrt/acs_findsat_mrt_example.ipynb

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1124,9 +1124,7 @@
11241124
"<hr>\n",
11251125
"\n",
11261126
"[Top of Page](#titleFindsat)\n",
1127-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> \n",
1128-
"<br></br>\n",
1129-
"<br></br>"
1127+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
11301128
]
11311129
}
11321130
],

notebooks/ACS/acs_focus_diverse_epsfs/acs_focus_diverse_epsfs.ipynb

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -400,7 +400,7 @@
400400
"id": "041df5ae",
401401
"metadata": {},
402402
"source": [
403-
"## For more help:\n",
403+
"### For more help:\n",
404404
"\n",
405405
"More details may be found on the [ACS website](http://www.stsci.edu/hst/instrumentation/acs) and in the [ACS Instrument](https://hst-docs.stsci.edu/display/ACSIHB) and [Data Handbooks](https://hst-docs.stsci.edu/acsdhb).\n",
406406
"\n",
@@ -409,9 +409,7 @@
409409
"<hr>\n",
410410
"\n",
411411
"[Top of Page](#titleFocus)\n",
412-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> \n",
413-
"<br></br>\n",
414-
"<br></br>"
412+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
415413
]
416414
}
417415
],

notebooks/ACS/acs_pixel_area_maps/acs_pixel_area_maps.ipynb

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -283,9 +283,7 @@
283283
"<hr>\n",
284284
"\n",
285285
"[Top of Page](#titlePixelArea)\n",
286-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> \n",
287-
"<br></br>\n",
288-
"<br></br>"
286+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
289287
]
290288
}
291289
],

notebooks/ACS/acs_polarization_tools/acs_polarization_tools.ipynb

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -194,9 +194,7 @@
194194
"<hr>\n",
195195
"\n",
196196
"[Top of Page](#titlePolarization)\n",
197-
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/notebooks/master/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> \n",
198-
"<br></br>\n",
199-
"<br></br>"
197+
"<img style=\"float: right;\" src=\"https://raw.githubusercontent.com/spacetelescope/hst_notebooks/main/assets/stsci_pri_combo_mark_horizonal_white_bkgd.png\" alt=\"Space Telescope Logo\" width=\"200px\"/> "
200198
]
201199
}
202200
],

0 commit comments

Comments
 (0)