Bugfix comments

Author: troyraen

tutorials/spherex/spherex_cutouts.md

@@ -212,7 +212,6 @@ def process_cutout_with_error_handling(row, ra, dec, cache):
     '''
     try:
         process_cutout(row, ra, dec, cache=cache)
-        # IncompleteRead: https://github.com/Caltech-IPAC/irsa-tutorials/issues/165#issuecomment-3821504954
     except (urllib.error.HTTPError, http.client.IncompleteRead):
         # Transient read errors. Skip this cutout.
         row["hdus"] = None

tutorials/spherex/spherex_intro.md

@@ -156,19 +156,26 @@ You can put this URL into a browser to download the file. Or you can work with i
 
 +++
 
-Use Astropy to examine the header of the URL from the previous step.
+First, use Astropy to load the data using the URL from the previous step.
+Transient read errors occur sometimes, so we'll catch those and retry a few times.
 
 ```{code-cell} ipython3
-Max number of times to retry HTTP errors.
+# Max number of times to retry HTTP errors.
 max_retries = 3
 for attempt in range(max_retries):
     try:
+        # Load the data.
         hdulist = fits.open(spectral_image_url)
         break
     except (urllib.error.HTTPError, http.client.IncompleteRead):
         if attempt == max_retries - 1:
             raise
         time.sleep(10 * (attempt + 1))
+```
+
+Examine the header.
+
+```{code-cell} ipython3
 hdulist.info()
 ```
 

tutorials/spherex/spherex_psf.md

@@ -135,18 +135,19 @@ print(spectral_image_url)
 ## 5. Read in a SPHEREx Cutout
 
 Next, we use standard astropy tools to open the fits image and to read the different headers and data.
+Transient read errors occur sometimes, so we'll catch those and retry a few times.
 
 ```{tip}
 As we do below, you can use `hdul.info()` to print the list of FITS layers of the downloaded cutout.
 ```
 
 ```{code-cell} ipython3
-Max number of times to retry transient read errors.
+# Max number of times to retry transient read errors.
 max_retries = 3
 for attempt in range(max_retries):
     try:
+        # Read the data.
         with fits.open(spectral_image_url) as hdul:
-            hdul.info()
             cutout_header = hdul['IMAGE'].header
             psf_header = hdul['PSF'].header
             cutout = hdul['IMAGE'].data
@@ -158,6 +159,12 @@ for attempt in range(max_retries):
         time.sleep(10 * (attempt + 1))
 ```
 
+Examine the header.
+
+```{code-cell} ipython3
+hdul.info()
+```
+
 The downloaded SPHEREx image cutout contains 5 FITS layers, which are described in the [SPHEREx Explanatory Supplement](https://irsa.ipac.caltech.edu/data/SPHEREx/docs/SPHEREx_Expsupp_QR.pdf).
 We focus in this example on the extensions `IMAGE` and `PSF`.
 We have already loaded their data as well as their header.
@@ -290,11 +297,11 @@ plt.show()
 
 ## 9. Using the SPHEREx PSF in Forward Modeling (e.g., Tractor)
 
-The PSF returned by this notebook is oversampled relative to the native SPHEREx detector pixel grid. 
+The PSF returned by this notebook is oversampled relative to the native SPHEREx detector pixel grid.
 This is intentional: the PSF is evaluated on a fine sub-pixel grid so that it can represent different intra-pixel source positions accurately.
 
-Tools such as Tractor do not expect an oversampled PSF directly. 
-Instead, they require a PSF that is pixel-integrated at the native detector resolution and evaluated at the correct sub-pixel phase of the source. 
+Tools such as Tractor do not expect an oversampled PSF directly.
+Instead, they require a PSF that is pixel-integrated at the native detector resolution and evaluated at the correct sub-pixel phase of the source.
 If you pass the oversampled PSF directly into Tractor without resampling, the effective PSF width and normalization will be incorrect, which can lead to systematic differences relative to the SPHEREx Spectrophotometry Tool.
 
 To use this PSF for forward modeling or fitting, you must: