update notebook after review

Author: sgreenstreet

MPC/RFL_Solar_System_MPC_Retrieval.ipynb

@@ -25,9 +25,9 @@
    "id": "73d4a605-2ca9-4fc9-8315-972b1f36fa9f",
    "metadata": {},
    "source": [
-    "**Learning objective:** An overview of accessing the Solar System object discoveries released as part of Rubin First Look.\n",
+    "**Learning objective:** Use the Minor Planet Center (MPC) to access Solar System object discoveries released as part of Rubin First Look.\n",
     "\n",
-    "**LSST data products:** Small body observations made by Rubin, queried from the Minor Planet Center (MPC), and orbits computed by the MPC from those Rubin observations are used in the notebook. No direct LSST data products are used in this notebook.\n",
+    "**LSST data products:** Small body observations that were made by Rubin and submitted to the Minor Planet Center (MPC) were used by the MPC to compute orbits; the MPC-computed orbits and Rubin observations submitted to the MPC are retrieved from the MPC in this notebook.\n",
     "\n",
     "**Packages:** `get_orb` and `get_obs` <a href=\"https://www.minorplanetcenter.net/mpcops/documentation/\">APIs from the Minor Planet Center</a>.\n",
     "\n",
@@ -194,7 +194,7 @@
    "id": "dd380a4c-858b-42cf-bd2c-43fb9311c96a",
    "metadata": {},
    "source": [
-    "### 2.1 Query the Minor Planet Center\n",
+    "### 2.1. Query the Minor Planet Center\n",
     "\n",
     "Use the Minor Planet Center's `get_orb` API to retrieve the orbit information for all 2,098 objects in the Rubin First Look Solar System discoveries and store the list of retrieved dictionaries in a DataFrame called `discovery_orbits`. Return fields for the object's provisional designation, absolute magnitude, semimajor axis, eccentricity, inclination, argument of perihelion, longitude of ascending node, time of perihelion passage, the total number of observations used in the orbit fit, and the orbit classification information. The request may take roughly 10 minutes or more to complete.\n",
     "\n",
@@ -262,7 +262,7 @@
    "id": "b57066e8-f27d-4f1b-932f-529f4bb75cb7",
    "metadata": {},
    "source": [
-    "### 2.2 Plot orbit classifications"
+    "### 2.2. Plot orbit classifications"
    ]
   },
   {
@@ -383,7 +383,7 @@
    "id": "2edbdaba-551d-4b72-a346-16227a9c45fb",
    "metadata": {},
    "source": [
-    "### 3.1 Query the Minor Planet Center"
+    "### 3.1. Query the Minor Planet Center"
    ]
   },
   {
@@ -547,7 +547,7 @@
    "id": "2a885ec6-9861-435b-9025-998005fa6735",
    "metadata": {},
    "source": [
-    "### 3.2 Examine the magnitude variation for an example discovery"
+    "### 3.2. Examine the magnitude variation for an example discovery"
    ]
   },
   {
@@ -649,7 +649,7 @@
    "id": "06c3e61f-7658-46ed-a4ef-a1042ccd5060",
    "metadata": {},
    "source": [
-    "Show the distribution of all `rmsmag` values in this `target_subset` in order to approximate the boundary between the distribution of \"acceptable\" or \"normal\" measurements, and the tail of \"outlier\" measurements."
+    "Show the distribution of all `rmsmag` values in this `target_subset` of 10 Rubin discoveries in order to approximate the boundary between the distribution of \"acceptable\" or \"normal\" measurements, and the tail of any \"outlier\" measurements."
    ]
   },
   {
@@ -677,7 +677,7 @@
    "id": "84d20194-f7c9-4a15-9497-7021ee21adaf",
    "metadata": {},
    "source": [
-    "> **Figure 3:** The log of the number of photometric measurements with a given `rmsmag` value. The dashed grey line is drawn at $0.23$ mag, the approximate (by-eye) edge of the distribution of `rmsmag` values for this `target_subset`."
+    "> **Figure 3:** The log of the number of photometric measurements with a given `rmsmag` value for this `target_subset` of 10 Rubin discoveries. The dashed grey line is drawn at $0.23$ mag, the approximate (by-eye) edge of the distribution of `rmsmag` values for this 10 object `target_subset`."
    ]
   },
   {
@@ -713,15 +713,15 @@
    "id": "ab941acc-9876-4c6b-94ef-a81c121c6fbf",
    "metadata": {},
    "source": [
-    "> **Figure 4:** The `rmsmag` as a function of `mag` for the $g$-, $r$-, and $i$-band photometric measurements. The main locus of points in each plot represents \"normal\" photometric measurements, and the outliers are clearly visible. The horizontal lines drawn at `rmsmag` $=0.23$ mag represent about the upper bound on the distribution."
+    "> **Figure 4:** The `rmsmag` as a function of `mag` for the $g$-, $r$-, and $i$-band photometric measurements for this `target_subset` of 10 Rubin discoveries. The main locus of points in each plot represents \"normal\" photometric measurements, with no outliers clearly visible. The horizontal lines drawn at `rmsmag` $=0.23$ mag represent about the upper bound on the distribution for this `target_subset` of 10 Rubin discoveries."
    ]
   },
   {
    "cell_type": "markdown",
    "id": "24e2506c-dafa-4713-954b-704f9e837a35",
    "metadata": {},
    "source": [
-    "The above demonstrates a simple, by-eye evaluation that `rmsmag` $= 0.23$ mag indicates the edge of the photometric meaurement for this `target_subset` in the RFL data sent to the MPC.\n",
+    "The above demonstrates a simple, by-eye evaluation that `rmsmag` $= 0.23$ mag indicates the edge of the photometric meaurement for this `target_subset` of 10 Rubin discoveries in the RFL data sent to the MPC.\n",
     "\n",
     "Inclusion of any data points that were to have `rmsmag` values larger than this limit in any analysis should be done with caution."
    ]