Add more description to figures

notebooks/NIRCam/NIRCam_WFSS_simulating_spectra/Simulating_WFSS_spectra_CRDS.ipynb

@@ -537,6 +537,14 @@
     "segment_map = detect_sources(convolved_data, threshold, npixels=10)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "f853775b-a005-4eac-8152-c40efe4a57ef",
+   "metadata": {},
+   "source": [
+    "Below we see that the segmentation map shows a large number of sources spread across the detector."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -619,7 +627,7 @@
    "id": "f338ef1d-2602-4f26-aa07-a156372c4506",
    "metadata": {},
    "source": [
-    "Show the source, as well as its segmentation map, from the imaging data."
+    "Show the source, as well as its segmentation map, from the imaging data. On the left we see that the source appears to be a point source. The segmentation map shows a collection of roughly 6x6 pixels that have been identified as part of this source."
    ]
   },
   {
@@ -678,7 +686,7 @@
    "id": "e5a6fd6e-d7ca-4c44-ac3a-86c76652759b",
    "metadata": {},
    "source": [
-    "For reference, below we see the pixel coordinates in the imaging data. "
+    "For reference, below we see the pixel coordinates in the imaging data. The pixels corresponding to the source range between x values of 402 and 408, and y values of 1461 and 1468."
    ]
   },
   {
@@ -734,7 +742,7 @@
    "id": "9f489e69-237c-4aab-9d50-d817619918b7",
    "metadata": {},
    "source": [
-    "Show the pixel location of the **undispersed** source in the WFSS data. Note that the location is significantly different than that in the imaging data."
+    "Show the pixel location of the **undispersed** source in the WFSS data. Note that the location is significantly different than that in the imaging data. In this case, the source is located between x values of 117 to 123, and y values of 1740 and 1746."
    ]
   },
   {
@@ -782,7 +790,7 @@
    "id": "26dc8950-cc75-45c1-8427-9c2e5b40c3d9",
    "metadata": {},
    "source": [
-    "Show the inverse sentivity, which includes the wavelength range and shape of the sensitivity. This is defined in units of DN/s per $F_{\\lambda}$ ($erg/s/cm^2/A$)"
+    "Show the inverse sentivity, which includes the wavelength range and shape of the sensitivity. This is defined in units of DN/s per $F_{\\lambda}$ ($erg/s/cm^2/A$). The curve shows significant sensitivity between about 3.85 microns, and 5.05 microns."
    ]
   },
   {
@@ -1015,7 +1023,7 @@
    "source": [
     "Below we create a figure showing the resulting locations of dispersed pixels. We dispersed the single input pixel using an array of wavelengths that is oversampled by a factor of 2 relative to the native dispersion of the grism. That wavelength array is translated into an array of pixel positions which overlay the WFSS detector grid. \n",
     "\n",
-    "For clarity, we zoom in on a 40 pixel wide area in the dispersion direction. This shows that our single imaging mode pixel will be dispersed along a nearly horizontal line in this area. Zooming out on this plot, by changing the xlim values in the cell below, will show the entire set of pixels corresponding to the dispersed input pixel. For consistency, we show similar 40 pixel wide plots for the other figures in the next two sections."
+    "For clarity, we zoom in on a 40 pixel wide area in the dispersion direction. This shows that our single imaging mode pixel will be dispersed along a nearly horizontal line (seen as the rainbow colored boxes) in this area. Zooming out on this plot, by changing the xlim values in the cell below, will show the entire set of pixels corresponding to the dispersed input pixel. For consistency, we show similar 40 pixel wide plots for the other figures in the next two sections."
    ]
   },
   {
@@ -1194,7 +1202,7 @@
    "id": "8c99799e-2afe-4fff-9d0f-86ff7d0f9e7d",
    "metadata": {},
    "source": [
-    "The following plot shows the dispersed input pixels, using blue outlines, projected onto the final WFSS pixels, and shaded in black proportionally to their flux (in DN/s)."
+    "The following plot shows the dispersed input pixels, using blue outlines, projected onto the final WFSS pixels, which are shown as the gray grid. The dispersed pixels are shaded in black proportionally to their flux (in DN/s)."
    ]
   },
   {
@@ -1251,7 +1259,7 @@
    "id": "ed4dd1c1-4416-459b-86c2-1bca5cb45d15",
    "metadata": {},
    "source": [
-    "Show the resulting 2D simulated spectrum for this source"
+    "Show the resulting 2D simulated spectrum for this source. We see a nearly horizontal trace across the field of view. Increasing the x range of the plot to (0, 700) will reveal the full trace."
    ]
   },
   {
@@ -1270,7 +1278,7 @@
    "id": "3600044a-778a-459d-b748-ff93f269723c",
    "metadata": {},
    "source": [
-    "Compare to the real data:"
+    "Show the real data at the same scale. This trace also appears as a nearly horizontal line. The signal level in the real data is slightly higher than that of the simulated data."
    ]
   },
   {
@@ -1289,7 +1297,7 @@
    "id": "cd7d09ae-a8de-41e5-beab-f625eba05343",
    "metadata": {},
    "source": [
-    "A good way to check our simulated image is to subtract the simulation from our data"
+    "A good way to check our simulated image is to subtract the simulation from our data. The figure below shows the simulated minus real difference image. The difference in peak level of the trace is visible. The alignment of the simulated and real traces is also apparent as the width of the difference is constant from left to right."
    ]
   },
   {
@@ -1308,7 +1316,7 @@
    "id": "790e3fc8-db68-487a-a87c-26ed7cd65d5c",
    "metadata": {},
    "source": [
-    "Sum the simulated spectrum and also the real data in the dispersion direction to check if the trace profiles are well aligned. Plot the summed real data (orange) and simulation (blue line)."
+    "Sum the simulated spectrum and also the real data in the dispersion direction to check if the trace profiles are well aligned. The figure below shows the summed real data (orange) and simulation (blue line). The left/right alignment of the two peaks shows that the location of the simulated trace is very close to that of the real trace."
    ]
   },
   {
@@ -1376,7 +1384,7 @@
    "id": "2a930c02-dff4-46ee-9f8b-be3d10e4336a",
    "metadata": {},
    "source": [
-    "Now plot the collapsed simulated data (blue) and background-subtracted real data (orange)."
+    "Now plot the collapsed simulated data (blue) and background-subtracted real data (orange). The well-aligned peaks show more clearly that the simulated and real traces are well-aligned. The peak of the simulated data is lower than that of the real data, showing that the simulation slightly under-estimates the signal in the real trace."
    ]
   },
   {