From 55299e23680b35078d49c7c88038bde022c8e4ec Mon Sep 17 00:00:00 2001
From: Rob Falck <rfalck@nasa.gov>
Date: Tue, 25 Jul 2023 16:11:01 -0400
Subject: [PATCH] Added various phase options dictionaries to the API
 documentation.

---
 docs/dymos_book/api/phase_api.ipynb | 92 +++++++++++++++++++++++++++--
 1 file changed, 87 insertions(+), 5 deletions(-)

diff --git a/docs/dymos_book/api/phase_api.ipynb b/docs/dymos_book/api/phase_api.ipynb
index 89c25b6ca..5eeaf233f 100644
--- a/docs/dymos_book/api/phase_api.ipynb
+++ b/docs/dymos_book/api/phase_api.ipynb
@@ -47,14 +47,15 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# The Phase API"
+    "# Phase Options"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Options"
+    "## Phase.options\n",
+    "General options available to all dymos Phases."
    ]
   },
   {
@@ -67,14 +68,95 @@
    },
    "outputs": [],
    "source": [
-    "om.show_options_table('dymos.phase.Phase')"
+    "import dymos\n",
+    "phase = dymos.Phase()\n",
+    "\n",
+    "om.show_options_table(phase)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The transcription is an instance of one of the [transcriptions](./transcriptions_api) available in Dymos.\n",
+    "\n",
+    "\n",
+    "Other options listed below control the behavior of various aspects of Phases.\n",
+    "While most have corresponding phase methods for setting these values, users may now use the `set` method of OpenMDAO's OptionsDictionary to set the values of these options."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase.timeseries_options\n",
+    "\n",
+    "These options control the behavior of timeseries within a Phase."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "scrolled": true,
+    "tags": [
+     "remove-input"
+    ]
+   },
+   "outputs": [],
+   "source": [
+    "om.show_options_table(phase.timeseries_options)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase.refine_options\n",
+    "These options control grid refinement within each Phase."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "scrolled": true,
+    "tags": [
+     "remove-input"
+    ]
+   },
+   "outputs": [],
+   "source": [
+    "om.show_options_table(phase.refine_options)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase.simulate_options\n",
+    "These options control the behavior of phase explicit simulation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "scrolled": true,
+    "tags": [
+     "remove-input"
+    ]
+   },
+   "outputs": [],
+   "source": [
+    "om.show_options_table(phase.simulate_options)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The transcription is an instance of one of the [transcriptions](./transcriptions_api) available in Dymos.\n"
+    "# Phase Methods"
    ]
   },
   {
@@ -205,7 +287,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.5"
+   "version": "3.11.4"
   }
  },
  "nbformat": 4,