Add a section to example notebook for testing the scheduler. (#1191)

notebooks/TestPOCS.ipynb

@@ -244,13 +244,49 @@
     "    cam.take_exposure(seconds=2, filename=f'/home/panoptes/images/{cam_name}-test-{now}.cr2', blocking=True)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "13816d0a",
+   "metadata": {},
+   "source": [
+    "# Scheduler testing commands\n",
+    "\n",
+    "To schedule an observation the `pocs.observatory` will look at all the potential targets in the fields file and try to determine the \"best\" observation. "
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "b9160eb9",
+   "id": "8eacb871",
    "metadata": {},
    "outputs": [],
-   "source": []
+   "source": [
+    "pocs.observatory.get_observation()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d552c57f",
+   "metadata": {},
+   "source": [
+    "It's possible that there will not be any valid observations available.\n",
+    "\n",
+    "If a valid observation is found, it will be assigned to `pocs.observatory.current_observation` and also tells the mount about the target. You can then do things like:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "508d4980",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Make sure the mount is unparked\n",
+    "pocs.observatory.mount.unpark()\n",
+    "\n",
+    "# Move to the target.\n",
+    "pocs.observatory.mount.slew_to_target()"
+   ]
   }
  ],
  "metadata": {