From 93bb6d4cc0e7d97e6b1a81368786deb015cdb0e4 Mon Sep 17 00:00:00 2001
From: Kushal Bakshi <52367253+kushalbakshi@users.noreply.github.com>
Date: Wed, 17 Jan 2024 12:10:59 +0000
Subject: [PATCH] Minor fixes to tutorial notebook

---
 notebooks/tutorial.ipynb | 2120 +++++++++++++++++++++++++++++++++++---
 1 file changed, 1963 insertions(+), 157 deletions(-)

diff --git a/notebooks/tutorial.ipynb b/notebooks/tutorial.ipynb
index efd021a..6d3687a 100644
--- a/notebooks/tutorial.ipynb
+++ b/notebooks/tutorial.ipynb
@@ -54,10 +54,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import datajoint as dj\n",
-    "import datetime\n",
-    "import matplotlib.pyplot as plt\n",
-    "import numpy as np"
+    "import datajoint as dj"
    ]
   },
   {
@@ -71,15 +68,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [
     {
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "[2024-01-04 20:00:17,037][INFO]: Connecting root@fakeservices.datajoint.io:3306\n",
-      "[2024-01-04 20:00:17,044][INFO]: Connected root@fakeservices.datajoint.io:3306\n"
+      "[2024-01-17 12:07:52,612][INFO]: Connecting root@fakeservices.datajoint.io:3306\n",
+      "[2024-01-17 12:07:52,620][INFO]: Connected root@fakeservices.datajoint.io:3306\n"
      ]
     },
     {
@@ -88,7 +85,7 @@
        "DataJoint connection (connected) root@fakeservices.datajoint.io:3306"
       ]
      },
-     "execution_count": 2,
+     "execution_count": 3,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -110,14 +107,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [
     {
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "[2024-01-04 20:00:18,332][WARNING]: lab.Project and related tables will be removed in a future version of Element Lab. Please use the project schema.\n"
+      "[2024-01-17 12:07:58,189][WARNING]: lab.Project and related tables will be removed in a future version of Element Lab. Please use the project schema.\n"
      ]
     }
    ],
@@ -145,179 +142,179 @@
        "<g id=\"graph0\" class=\"graph\" transform=\"scale(1 1) rotate(0) translate(4 323)\">\n",
        "<title>%3</title>\n",
        "<polygon fill=\"white\" stroke=\"transparent\" points=\"-4,4 -4,-323 1075,-323 1075,4 -4,4\"/>\n",
-       "<!-- optogenetics.OptoWaveform.Square -->\n",
-       "<g id=\"node1\" class=\"node\">\n",
-       "<title>optogenetics.OptoWaveform.Square</title>\n",
-       "<g id=\"a_node1\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\ron_proportion        \roff_proportion       \r\">\n",
-       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"503.5,-169 329.5,-169 329.5,-150 503.5,-150 503.5,-169\"/>\n",
-       "<text text-anchor=\"middle\" x=\"416.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Square</text>\n",
-       "</a>\n",
-       "</g>\n",
-       "</g>\n",
        "<!-- Device -->\n",
-       "<g id=\"node2\" class=\"node\">\n",
+       "<g id=\"node1\" class=\"node\">\n",
        "<title>Device</title>\n",
-       "<g id=\"a_node2\"><a xlink:title=\"device               \r------------------------------\rmodality             \rdescription=&quot;&quot;       \r\">\n",
+       "<g id=\"a_node1\"><a xlink:title=\"device               \r------------------------------\rmodality             \rdescription=&quot;&quot;       \r\">\n",
        "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"47,-177 0,-177 0,-142 47,-142 47,-177\"/>\n",
        "<text text-anchor=\"start\" x=\"8\" y=\"-158\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">Device</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- optogenetics.OptoProtocol -->\n",
-       "<g id=\"node7\" class=\"node\">\n",
+       "<g id=\"node3\" class=\"node\">\n",
        "<title>optogenetics.OptoProtocol</title>\n",
-       "<g id=\"a_node7\"><a xlink:title=\"→ session.Session\rprotocol_id          \r------------------------------\r→ optogenetics.OptoStimParams\r→ surgery.Implantation\r→ [nullable] Device\rprotocol_description=&quot;&quot; \r\">\n",
-       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"272.5,-106 114.5,-106 114.5,-71 272.5,-71 272.5,-106\"/>\n",
-       "<text text-anchor=\"start\" x=\"122.5\" y=\"-86.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">optogenetics.OptoProtocol</text>\n",
+       "<g id=\"a_node3\"><a xlink:title=\"→ session.Session\rprotocol_id          \r------------------------------\r→ optogenetics.OptoStimParams\r→ surgery.Implantation\r→ [nullable] Device\rprotocol_description=&quot;&quot; \r\">\n",
+       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"262.5,-106 104.5,-106 104.5,-71 262.5,-71 262.5,-106\"/>\n",
+       "<text text-anchor=\"start\" x=\"112.5\" y=\"-86.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">optogenetics.OptoProtocol</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- Device&#45;&gt;optogenetics.OptoProtocol -->\n",
        "<g id=\"edge1\" class=\"edge\">\n",
        "<title>Device-&gt;optogenetics.OptoProtocol</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M47.16,-146.32C50.28,-144.82 53.45,-143.34 56.5,-142 86.22,-128.91 120.32,-115.84 147.06,-106.01\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M47.2,-146.4C50.31,-144.88 53.47,-143.38 56.5,-142 84.5,-129.23 116.53,-116 141.42,-106.01\"/>\n",
        "</g>\n",
-       "<!-- surgery.Implantation -->\n",
-       "<g id=\"node3\" class=\"node\">\n",
-       "<title>surgery.Implantation</title>\n",
-       "<g id=\"a_node3\"><a xlink:title=\"→ subject.Subject\rimplant_date         \r→ surgery.ImplantationType\r→ surgery.BrainRegion.proj(target_region=&quot;region_acronym&quot;)\r→ surgery.Hemisphere.proj(target_hemisphere=&quot;hemisphere&quot;)\r------------------------------\r→ lab.User.proj(surgeon=&quot;user&quot;)\rimplant_comment=&quot;&quot;   \r\">\n",
-       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"189.5,-177 65.5,-177 65.5,-142 189.5,-142 189.5,-177\"/>\n",
-       "<text text-anchor=\"start\" x=\"73.5\" y=\"-157.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">surgery.Implantation</text>\n",
+       "<!-- subject.Subject -->\n",
+       "<g id=\"node2\" class=\"node\">\n",
+       "<title>subject.Subject</title>\n",
+       "<g id=\"a_node2\"><a xlink:title=\"subject              \r------------------------------\rsubject_nickname=&quot;&quot;  \rsex                  \rsubject_birth_date   \rsubject_description=&quot;&quot; \r\">\n",
+       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"232.5,-248 134.5,-248 134.5,-213 232.5,-213 232.5,-248\"/>\n",
+       "<text text-anchor=\"start\" x=\"142.5\" y=\"-228.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">subject.Subject</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- surgery.Implantation&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- session.Session -->\n",
+       "<g id=\"node8\" class=\"node\">\n",
+       "<title>session.Session</title>\n",
+       "<g id=\"a_node8\"><a xlink:title=\"→ subject.Subject\rsession_id           \r------------------------------\rsession_datetime=null \r\">\n",
+       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"169.5,-177 65.5,-177 65.5,-142 169.5,-142 169.5,-177\"/>\n",
+       "<text text-anchor=\"start\" x=\"73.5\" y=\"-157.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">session.Session</text>\n",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- subject.Subject&#45;&gt;session.Session -->\n",
        "<g id=\"edge2\" class=\"edge\">\n",
-       "<title>surgery.Implantation-&gt;optogenetics.OptoProtocol</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M143.48,-141.8C153.85,-130.95 167.32,-116.87 177.67,-106.05\"/>\n",
+       "<title>subject.Subject-&gt;session.Session</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M167.52,-212.8C157.15,-201.95 143.68,-187.87 133.33,-177.05\"/>\n",
        "</g>\n",
-       "<!-- subject.Subject -->\n",
-       "<g id=\"node4\" class=\"node\">\n",
-       "<title>subject.Subject</title>\n",
-       "<g id=\"a_node4\"><a xlink:title=\"subject              \r------------------------------\rsubject_nickname=&quot;&quot;  \rsex                  \rsubject_birth_date   \rsubject_description=&quot;&quot; \r\">\n",
-       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"242.5,-248 144.5,-248 144.5,-213 242.5,-213 242.5,-248\"/>\n",
-       "<text text-anchor=\"start\" x=\"152.5\" y=\"-228.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">subject.Subject</text>\n",
+       "<!-- surgery.Implantation -->\n",
+       "<g id=\"node9\" class=\"node\">\n",
+       "<title>surgery.Implantation</title>\n",
+       "<g id=\"a_node9\"><a xlink:title=\"→ subject.Subject\rimplant_date         \r→ surgery.ImplantationType\r→ surgery.BrainRegion.proj(target_region=&quot;region_acronym&quot;)\r→ surgery.Hemisphere.proj(target_hemisphere=&quot;hemisphere&quot;)\r------------------------------\r→ lab.User.proj(surgeon=&quot;user&quot;)\rimplant_comment=&quot;&quot;   \r\">\n",
+       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"311.5,-177 187.5,-177 187.5,-142 311.5,-142 311.5,-177\"/>\n",
+       "<text text-anchor=\"start\" x=\"195.5\" y=\"-157.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">surgery.Implantation</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- subject.Subject&#45;&gt;surgery.Implantation -->\n",
        "<g id=\"edge3\" class=\"edge\">\n",
        "<title>subject.Subject-&gt;surgery.Implantation</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M177.52,-212.8C167.15,-201.95 153.68,-187.87 143.33,-177.05\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M199.48,-212.8C209.85,-201.95 223.32,-187.87 233.67,-177.05\"/>\n",
        "</g>\n",
-       "<!-- session.Session -->\n",
-       "<g id=\"node12\" class=\"node\">\n",
-       "<title>session.Session</title>\n",
-       "<g id=\"a_node12\"><a xlink:title=\"→ subject.Subject\rsession_id           \r------------------------------\rsession_datetime=null \r\">\n",
-       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"311.5,-177 207.5,-177 207.5,-142 311.5,-142 311.5,-177\"/>\n",
-       "<text text-anchor=\"start\" x=\"215.5\" y=\"-157.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">session.Session</text>\n",
+       "<!-- optogenetics.OptoEvent -->\n",
+       "<g id=\"node11\" class=\"node\">\n",
+       "<title>optogenetics.OptoEvent</title>\n",
+       "<g id=\"a_node11\"><a xlink:title=\"→ optogenetics.OptoProtocol\rstim_start_time      \r------------------------------\rstim_end_time        \r\">\n",
+       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"255.5,-35 111.5,-35 111.5,0 255.5,0 255.5,-35\"/>\n",
+       "<text text-anchor=\"start\" x=\"119.5\" y=\"-15.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">optogenetics.OptoEvent</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- subject.Subject&#45;&gt;session.Session -->\n",
+       "<!-- optogenetics.OptoProtocol&#45;&gt;optogenetics.OptoEvent -->\n",
        "<g id=\"edge4\" class=\"edge\">\n",
-       "<title>subject.Subject-&gt;session.Session</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M209.48,-212.8C219.85,-201.95 233.32,-187.87 243.67,-177.05\"/>\n",
+       "<title>optogenetics.OptoProtocol-&gt;optogenetics.OptoEvent</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M183.5,-70.8C183.5,-59.95 183.5,-45.87 183.5,-35.05\"/>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveformType -->\n",
-       "<g id=\"node5\" class=\"node\">\n",
+       "<g id=\"node4\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveformType</title>\n",
-       "<g id=\"a_node5\"><a xlink:title=\"waveform_type        \r\">\n",
-       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"684,-319 523,-319 523,-284 684,-284 684,-319\"/>\n",
-       "<text text-anchor=\"start\" x=\"531\" y=\"-300\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">optogenetics.OptoWaveformType</text>\n",
+       "<g id=\"a_node4\"><a xlink:title=\"waveform_type        \r\">\n",
+       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"677,-319 516,-319 516,-284 677,-284 677,-319\"/>\n",
+       "<text text-anchor=\"start\" x=\"524\" y=\"-300\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">optogenetics.OptoWaveformType</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform -->\n",
-       "<g id=\"node10\" class=\"node\">\n",
+       "<g id=\"node7\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform</title>\n",
-       "<g id=\"a_node10\"><a xlink:title=\"waveform_name        \r------------------------------\r→ optogenetics.OptoWaveformType\rnormalized_waveform=null \rwaveform_description=&quot;&quot; \r\">\n",
-       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"673.5,-248 533.5,-248 533.5,-213 673.5,-213 673.5,-248\"/>\n",
-       "<text text-anchor=\"start\" x=\"541.5\" y=\"-229\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">optogenetics.OptoWaveform</text>\n",
+       "<g id=\"a_node7\"><a xlink:title=\"waveform_name        \r------------------------------\r→ optogenetics.OptoWaveformType\rnormalized_waveform=null \rwaveform_description=&quot;&quot; \r\">\n",
+       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"666.5,-248 526.5,-248 526.5,-213 666.5,-213 666.5,-248\"/>\n",
+       "<text text-anchor=\"start\" x=\"534.5\" y=\"-229\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">optogenetics.OptoWaveform</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveformType&#45;&gt;optogenetics.OptoWaveform -->\n",
        "<g id=\"edge5\" class=\"edge\">\n",
        "<title>optogenetics.OptoWaveformType-&gt;optogenetics.OptoWaveform</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M603.5,-283.8C603.5,-272.95 603.5,-258.87 603.5,-248.05\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M596.5,-283.8C596.5,-272.95 596.5,-258.87 596.5,-248.05\"/>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform.Sine -->\n",
-       "<g id=\"node6\" class=\"node\">\n",
+       "<g id=\"node5\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform.Sine</title>\n",
-       "<g id=\"a_node6\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\rnumber_of_cycles     \rstarting_phase=0.00  \r\">\n",
-       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"685,-169 522,-169 522,-150 685,-150 685,-169\"/>\n",
-       "<text text-anchor=\"middle\" x=\"603.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Sine</text>\n",
-       "</a>\n",
-       "</g>\n",
-       "</g>\n",
-       "<!-- optogenetics.OptoEvent -->\n",
-       "<g id=\"node9\" class=\"node\">\n",
-       "<title>optogenetics.OptoEvent</title>\n",
-       "<g id=\"a_node9\"><a xlink:title=\"→ optogenetics.OptoProtocol\rstim_start_time      \r------------------------------\rstim_end_time        \r\">\n",
-       "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"265.5,-35 121.5,-35 121.5,0 265.5,0 265.5,-35\"/>\n",
-       "<text text-anchor=\"start\" x=\"129.5\" y=\"-15.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">optogenetics.OptoEvent</text>\n",
+       "<g id=\"a_node5\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\rnumber_of_cycles     \rstarting_phase=0.00  \r\">\n",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"493,-169 330,-169 330,-150 493,-150 493,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"411.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Sine</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoProtocol&#45;&gt;optogenetics.OptoEvent -->\n",
-       "<g id=\"edge6\" class=\"edge\">\n",
-       "<title>optogenetics.OptoProtocol-&gt;optogenetics.OptoEvent</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M193.5,-70.8C193.5,-59.95 193.5,-45.87 193.5,-35.05\"/>\n",
-       "</g>\n",
        "<!-- optogenetics.OptoWaveform.Ramp -->\n",
-       "<g id=\"node8\" class=\"node\">\n",
+       "<g id=\"node6\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform.Ramp</title>\n",
-       "<g id=\"a_node8\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\rramp_up_proportion   \rramp_down_proportion \r\">\n",
-       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"873.5,-169 703.5,-169 703.5,-150 873.5,-150 873.5,-169\"/>\n",
-       "<text text-anchor=\"middle\" x=\"788.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Ramp</text>\n",
+       "<g id=\"a_node6\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\rramp_up_proportion   \rramp_down_proportion \r\">\n",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"681.5,-169 511.5,-169 511.5,-150 681.5,-150 681.5,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"596.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Ramp</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Square -->\n",
-       "<g id=\"edge7\" class=\"edge\">\n",
-       "<title>optogenetics.OptoWaveform-&gt;optogenetics.OptoWaveform.Square</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M558.71,-212.97C521.22,-199.14 469.22,-179.95 439.61,-169.03\"/>\n",
-       "</g>\n",
        "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Sine -->\n",
-       "<g id=\"edge8\" class=\"edge\">\n",
+       "<g id=\"edge6\" class=\"edge\">\n",
        "<title>optogenetics.OptoWaveform-&gt;optogenetics.OptoWaveform.Sine</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M603.5,-212.8C603.5,-199.08 603.5,-180.19 603.5,-169.27\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M552.19,-212.97C515.1,-199.14 463.66,-179.95 434.36,-169.03\"/>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Ramp -->\n",
-       "<g id=\"edge9\" class=\"edge\">\n",
+       "<g id=\"edge7\" class=\"edge\">\n",
        "<title>optogenetics.OptoWaveform-&gt;optogenetics.OptoWaveform.Ramp</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M647.81,-212.97C684.9,-199.14 736.34,-179.95 765.64,-169.03\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M596.5,-212.8C596.5,-199.08 596.5,-180.19 596.5,-169.27\"/>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform.Square -->\n",
+       "<g id=\"node10\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveform.Square</title>\n",
+       "<g id=\"a_node10\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\ron_proportion        \roff_proportion       \r\">\n",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"873.5,-169 699.5,-169 699.5,-150 873.5,-150 873.5,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"786.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Square</text>\n",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Square -->\n",
+       "<g id=\"edge8\" class=\"edge\">\n",
+       "<title>optogenetics.OptoWaveform-&gt;optogenetics.OptoWaveform.Square</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M642.01,-212.97C680.11,-199.14 732.93,-179.95 763.02,-169.03\"/>\n",
        "</g>\n",
        "<!-- optogenetics.OptoStimParams -->\n",
-       "<g id=\"node11\" class=\"node\">\n",
+       "<g id=\"node12\" class=\"node\">\n",
        "<title>optogenetics.OptoStimParams</title>\n",
-       "<g id=\"a_node11\"><a xlink:title=\"opto_params_id       \r------------------------------\r→ optogenetics.OptoWaveform\rwavelength           \rpower=null           \rlight_intensity=null \rfrequency            \rduration             \r\">\n",
+       "<g id=\"a_node12\"><a xlink:title=\"opto_params_id       \r------------------------------\r→ optogenetics.OptoWaveform\rwavelength           \rpower=null           \rlight_intensity=null \rfrequency            \rduration             \r\">\n",
        "<polygon fill=\"#00ff00\" fill-opacity=\"0.188235\" stroke=\"#00ff00\" stroke-opacity=\"0.188235\" points=\"1071,-177 892,-177 892,-142 1071,-142 1071,-177\"/>\n",
        "<text text-anchor=\"start\" x=\"900\" y=\"-157.4\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"12.00\" fill=\"darkgreen\">optogenetics.OptoStimParams</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoStimParams -->\n",
-       "<g id=\"edge10\" class=\"edge\">\n",
+       "<g id=\"edge9\" class=\"edge\">\n",
        "<title>optogenetics.OptoWaveform-&gt;optogenetics.OptoStimParams</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M673.71,-216.68C735.31,-205.44 825.21,-189.03 891.97,-176.84\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M666.67,-216.92C729.89,-205.59 823.17,-188.88 891.8,-176.58\"/>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoStimParams&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- session.Session&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<g id=\"edge10\" class=\"edge\">\n",
+       "<title>session.Session-&gt;optogenetics.OptoProtocol</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M133.48,-141.8C143.85,-130.95 157.32,-116.87 167.67,-106.05\"/>\n",
+       "</g>\n",
+       "<!-- surgery.Implantation&#45;&gt;optogenetics.OptoProtocol -->\n",
        "<g id=\"edge11\" class=\"edge\">\n",
-       "<title>optogenetics.OptoStimParams-&gt;optogenetics.OptoProtocol</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M891.97,-143.21C888.78,-142.78 885.61,-142.38 882.5,-142 662.33,-115.32 400.83,-99.79 272.51,-93.23\"/>\n",
+       "<title>surgery.Implantation-&gt;optogenetics.OptoProtocol</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M233.52,-141.8C223.15,-130.95 209.68,-116.87 199.33,-106.05\"/>\n",
        "</g>\n",
-       "<!-- session.Session&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- optogenetics.OptoStimParams&#45;&gt;optogenetics.OptoProtocol -->\n",
        "<g id=\"edge12\" class=\"edge\">\n",
-       "<title>session.Session-&gt;optogenetics.OptoProtocol</title>\n",
-       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-opacity=\"0.250980\" d=\"M243.52,-141.8C233.15,-130.95 219.68,-116.87 209.33,-106.05\"/>\n",
+       "<title>optogenetics.OptoStimParams-&gt;optogenetics.OptoProtocol</title>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"0.75\" stroke-dasharray=\"5,2\" stroke-opacity=\"0.250980\" d=\"M891.97,-143.21C888.78,-142.78 885.61,-142.38 882.5,-142 658.53,-114.98 392.4,-99.56 262.61,-93.11\"/>\n",
        "</g>\n",
        "</g>\n",
        "</svg>"
       ],
       "text/plain": [
-       "<datajoint.diagram.Diagram at 0x7f1d2f4863a0>"
+       "<datajoint.diagram.Diagram at 0x7fc8b71be100>"
       ]
      },
      "execution_count": 5,
@@ -354,27 +351,150 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 6,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_nickname</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">sex</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_birth_date</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_description</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr>  </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 0</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject    subject_nickna sex     subject_birth_ subject_descri\n",
+       "+---------+ +------------+ +-----+ +------------+ +------------+\n",
+       "\n",
+       " (Total: 0)"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "subject.Subject()"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 7,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "subject              : varchar(8)                   \n",
+      "---\n",
+      "subject_nickname=\"\"  : varchar(64)                  \n",
+      "sex                  : enum('M','F','U')            \n",
+      "subject_birth_date   : date                         \n",
+      "subject_description=\"\" : varchar(1024)                \n",
+      "\n"
+     ]
+    }
+   ],
    "source": [
     "print(subject.Subject.describe())"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 8,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "# \n",
+       "subject              : varchar(8)                   # \n",
+       "---\n",
+       "subject_nickname=\"\"  : varchar(64)                  # \n",
+       "sex                  : enum('M','F','U')            # \n",
+       "subject_birth_date   : date                         # \n",
+       "subject_description=\"\" : varchar(1024)                # "
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "subject.Subject.heading"
    ]
@@ -391,9 +511,105 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 9,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_nickname</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">sex</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_birth_date</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">subject_description</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td></td>\n",
+       "<td>F</td>\n",
+       "<td>2020-01-01</td>\n",
+       "<td>Optogenetic pilot subject</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     subject_nickna sex     subject_birth_ subject_descri\n",
+       "+----------+ +------------+ +-----+ +------------+ +------------+\n",
+       "subject1                    F       2020-01-01     Optogenetic pi\n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "subject.Subject.insert1(\n",
     "    dict(\n",
@@ -416,18 +632,45 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 10,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "-> subject.Subject\n",
+      "session_id           : int                          \n",
+      "---\n",
+      "session_datetime=null : datetime                     \n",
+      "\n"
+     ]
+    }
+   ],
    "source": [
     "print(session.Session.describe())"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 11,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "# \n",
+       "subject              : varchar(8)                   # \n",
+       "session_id           : int                          # \n",
+       "---\n",
+       "session_datetime=null : datetime                     # "
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "session.Session.heading"
    ]
@@ -450,18 +693,106 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 16,
    "metadata": {},
    "outputs": [],
    "source": [
-    "session_key = dict(subject=\"subject5\", session_datetime=\"2023-01-01 00:00:00\")"
+    "session_key = dict(subject=\"subject1\", session_id=0, session_datetime=\"2023-01-01 00:00:00\")"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 17,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">session_datetime</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>2023-01-01 00:00:00</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    session_dateti\n",
+       "+----------+ +------------+ +------------+\n",
+       "subject1     0              2023-01-01 00:\n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "session.Session.insert1(session_key)\n",
     "session.Session()"
@@ -478,9 +809,100 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 18,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">device</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">modality</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">description</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>OPTG_4</td>\n",
+       "<td>Optogenetics</td>\n",
+       "<td>Doric Pulse Sequence Generator</td></tr><tr><td>OPTG_8</td>\n",
+       "<td>Optogenetics</td>\n",
+       "<td>8 channel pulse sequence device</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 2</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*device    modality       description   \n",
+       "+--------+ +------------+ +------------+\n",
+       "OPTG_4     Optogenetics   Doric Pulse Se\n",
+       "OPTG_8     Optogenetics   8 channel puls\n",
+       " (Total: 2)"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "Device.insert1(\n",
     "    dict(\n",
@@ -494,9 +916,25 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 19,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "-> subject.Subject\n",
+      "implant_date         : datetime                     # surgery date\n",
+      "-> surgery.ImplantationType\n",
+      "-> surgery.BrainRegion.proj(target_region=\"region_acronym\")\n",
+      "-> surgery.Hemisphere.proj(target_hemisphere=\"hemisphere\")\n",
+      "---\n",
+      "-> lab.User.proj(surgeon=\"user\")\n",
+      "implant_comment=\"\"   : varchar(1024)                # Comments about the implant\n",
+      "\n"
+     ]
+    }
+   ],
    "source": [
     "print(surgery.Implantation.describe())"
    ]
@@ -511,9 +949,101 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 20,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b>Table for storing user information.</b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">user</p>\n",
+       "                            <span class=\"djtooltiptext\">username, short identifier</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">user_email</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">user_cellphone</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">user_fullname</p>\n",
+       "                            <span class=\"djtooltiptext\">Full name used to uniquely identify an individual</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>User1</td>\n",
+       "<td></td>\n",
+       "<td></td>\n",
+       "<td></td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*user     user_email     user_cellphone user_fullname \n",
+       "+-------+ +------------+ +------------+ +------------+\n",
+       "User1                                                 \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "lab.User.insert1(dict(user=\"User1\"))\n",
     "lab.User()"
@@ -529,18 +1059,185 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 21,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">reference</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>bregma</td></tr><tr><td>dura</td></tr><tr><td>lambda</td></tr><tr><td>sagittal_suture</td></tr><tr><td>sinus</td></tr><tr><td>skull_surface</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 6</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*reference    \n",
+       "+------------+\n",
+       "bregma        \n",
+       "dura          \n",
+       "lambda        \n",
+       "sagittal_sutur\n",
+       "sinus         \n",
+       "skull_surface \n",
+       " (Total: 6)"
+      ]
+     },
+     "execution_count": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "surgery.CoordinateReference()"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 22,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">hemisphere</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region hemisphere</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>left</td></tr><tr><td>middle</td></tr><tr><td>right</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 3</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*hemisphere   \n",
+       "+------------+\n",
+       "left          \n",
+       "middle        \n",
+       "right         \n",
+       " (Total: 3)"
+      ]
+     },
+     "execution_count": 22,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "surgery.Hemisphere()"
    ]
@@ -554,9 +1251,93 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 23,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">region_acronym</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region shorthand</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">region_name</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region full name</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>dHP</td>\n",
+       "<td>Dorsal Hippocampus</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*region_acrony region_name   \n",
+       "+------------+ +------------+\n",
+       "dHP            Dorsal Hippoca\n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 23,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "surgery.BrainRegion.insert1(\n",
     "    dict(region_acronym=\"dHP\", region_name=\"Dorsal Hippocampus\")\n",
@@ -566,7 +1347,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 24,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -609,18 +1390,254 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 25,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">implant_date</p>\n",
+       "                            <span class=\"djtooltiptext\">surgery date</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">implant_type</p>\n",
+       "                            <span class=\"djtooltiptext\">Short name for type of implanted device</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">target_region</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region shorthand</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">target_hemisphere</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region hemisphere</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">surgeon</p>\n",
+       "                            <span class=\"djtooltiptext\">username, short identifier</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">implant_comment</p>\n",
+       "                            <span class=\"djtooltiptext\">Comments about the implant</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>2022-04-01 12:13:14</td>\n",
+       "<td>opto</td>\n",
+       "<td>dHP</td>\n",
+       "<td>left</td>\n",
+       "<td>User1</td>\n",
+       "<td></td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *implant_date  *implant_type  *target_region *target_hemisp surgeon     implant_commen\n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+ +---------+ +------------+\n",
+       "subject1     2022-04-01 12: opto           dHP            left           User1                     \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 25,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "surgery.Implantation()"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 26,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">implant_date</p>\n",
+       "                            <span class=\"djtooltiptext\">surgery date</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">implant_type</p>\n",
+       "                            <span class=\"djtooltiptext\">Short name for type of implanted device</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">target_region</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region shorthand</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">target_hemisphere</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region hemisphere</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">ap</p>\n",
+       "                            <span class=\"djtooltiptext\">(mm) anterior-posterior; ref is 0</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">ap_ref</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">ml</p>\n",
+       "                            <span class=\"djtooltiptext\">(mm) medial axis; ref is 0</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">ml_ref</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">dv</p>\n",
+       "                            <span class=\"djtooltiptext\">(mm) dorso-ventral axis; ventral negative</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">dv_ref</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">theta</p>\n",
+       "                            <span class=\"djtooltiptext\">(deg) rot about ml-axis [0, 180] wrt z</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">phi</p>\n",
+       "                            <span class=\"djtooltiptext\">(deg) rot about dv-axis [0, 360] wrt x</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">beta</p>\n",
+       "                            <span class=\"djtooltiptext\">(deg) rot about shank [-180, 180] wrt anterior</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>2022-04-01 12:13:14</td>\n",
+       "<td>opto</td>\n",
+       "<td>dHP</td>\n",
+       "<td>left</td>\n",
+       "<td>-7.9</td>\n",
+       "<td>bregma</td>\n",
+       "<td>-1.8</td>\n",
+       "<td>bregma</td>\n",
+       "<td>5.0</td>\n",
+       "<td>skull_surface</td>\n",
+       "<td>11.5</td>\n",
+       "<td>0.0</td>\n",
+       "<td>nan</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *implant_date  *implant_type  *target_region *target_hemisp ap       ap_ref     ml       ml_ref     dv      dv_ref         theta     phi     beta    \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+ +------+ +--------+ +------+ +--------+ +-----+ +------------+ +-------+ +-----+ +------+\n",
+       "subject1     2022-04-01 12: opto           dHP            left           -7.9     bregma     -1.8     bregma     5.0     skull_surface  11.5      0.0     nan     \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 26,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "surgery.Implantation.Coordinate()"
    ]
@@ -634,7 +1651,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 27,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -655,9 +1672,113 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 28,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b>Defines a single optical stimulus that repeats.</b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">opto_params_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">waveform_name</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">wavelength</p>\n",
+       "                            <span class=\"djtooltiptext\">(nm) wavelength of optical stimulation light</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">power</p>\n",
+       "                            <span class=\"djtooltiptext\">(mW) total power from light source</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">light_intensity</p>\n",
+       "                            <span class=\"djtooltiptext\">(mW/mm2) power for given area</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">frequency</p>\n",
+       "                            <span class=\"djtooltiptext\">(Hz) frequency of the waveform</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">duration</p>\n",
+       "                            <span class=\"djtooltiptext\">(ms) duration of each optical stimulus</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>1</td>\n",
+       "<td>square_10</td>\n",
+       "<td>470</td>\n",
+       "<td>None</td>\n",
+       "<td>10.20</td>\n",
+       "<td>1.0</td>\n",
+       "<td>241.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*opto_params_i waveform_name  wavelength     power     light_intensit frequency     duration    \n",
+       "+------------+ +------------+ +------------+ +-------+ +------------+ +-----------+ +----------+\n",
+       "1              square_10      470            None      10.20          1.0           241.0       \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 28,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoStimParams.insert1(\n",
     "    dict(\n",
@@ -681,14 +1802,130 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 30,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">opto_params_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">implant_date</p>\n",
+       "                            <span class=\"djtooltiptext\">surgery date</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">implant_type</p>\n",
+       "                            <span class=\"djtooltiptext\">Short name for type of implanted device</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">target_region</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region shorthand</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">target_hemisphere</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region hemisphere</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">device</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">protocol_description</p>\n",
+       "                            <span class=\"djtooltiptext\">description of optogenetics protocol</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>1</td>\n",
+       "<td>2022-04-01 12:13:14</td>\n",
+       "<td>opto</td>\n",
+       "<td>dHP</td>\n",
+       "<td>left</td>\n",
+       "<td>OPTG_4</td>\n",
+       "<td></td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   opto_params_id implant_date   implant_type   target_region  target_hemisph device     protocol_descr\n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+ +------------+ +------------+ +------------+ +--------+ +------------+\n",
+       "subject1     0              1              1              2022-04-01 12: opto           dHP            left           OPTG_4                   \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 30,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoProtocol.insert1(\n",
     "    dict(\n",
     "        subject=\"subject1\",\n",
-    "        session_id=\"1\",\n",
+    "        session_id=\"0\",\n",
     "        protocol_id=\"1\",\n",
     "        opto_params_id=\"1\",\n",
     "        implant_date=\"2022-04-01 12:13:14\",\n",
@@ -710,14 +1947,110 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 32,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">stim_start_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus start time relative to session start</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">stim_end_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus end time relative session start</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>241.0</td>\n",
+       "<td>482.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   *stim_start_ti stim_end_time \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+\n",
+       "subject1     0              1              241.0          482.0         \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 32,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoEvent.insert1(\n",
     "    dict(\n",
     "        subject=\"subject1\",\n",
-    "        session_id=1,\n",
+    "        session_id=0,\n",
     "        protocol_id=1,\n",
     "        stim_start_time=241,\n",
     "        stim_end_time=482,\n",
@@ -736,14 +2069,115 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 34,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">stim_start_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus start time relative to session start</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">stim_end_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus end time relative session start</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>241.0</td>\n",
+       "<td>482.0</td></tr><tr><td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>543.0</td>\n",
+       "<td>797.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 2</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   *stim_start_ti stim_end_time \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+\n",
+       "subject1     0              1              241.0          482.0         \n",
+       "subject1     0              1              543.0          797.0         \n",
+       " (Total: 2)"
+      ]
+     },
+     "execution_count": 34,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoEvent.insert1(\n",
     "    dict(\n",
     "        subject=\"subject1\",\n",
-    "        session_id=1,\n",
+    "        session_id=0,\n",
     "        protocol_id=1,\n",
     "        stim_start_time=543,\n",
     "        stim_end_time=797,\n",
@@ -764,9 +2198,110 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 35,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">stim_start_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus start time relative to session start</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">stim_end_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus end time relative session start</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>241.0</td>\n",
+       "<td>482.0</td></tr><tr><td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>543.0</td>\n",
+       "<td>797.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 2</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   *stim_start_ti stim_end_time \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+\n",
+       "subject1     0              1              241.0          482.0         \n",
+       "subject1     0              1              543.0          797.0         \n",
+       " (Total: 2)"
+      ]
+     },
+     "execution_count": 35,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoEvent()"
    ]
@@ -780,9 +2315,105 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 36,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    <b></b>\n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">stim_start_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus start time relative to session start</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">stim_end_time</p>\n",
+       "                            <span class=\"djtooltiptext\">(s) stimulus end time relative session start</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>543.0</td>\n",
+       "<td>797.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   *stim_start_ti stim_end_time \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+\n",
+       "subject1     0              1              543.0          797.0         \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 36,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoEvent & \"stim_start_time=543\""
    ]
@@ -797,9 +2428,149 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 37,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "\n",
+       "    \n",
+       "    <style type=\"text/css\">\n",
+       "        .Table{\n",
+       "            border-collapse:collapse;\n",
+       "        }\n",
+       "        .Table th{\n",
+       "            background: #A0A0A0; color: #ffffff; padding:4px; border:#f0e0e0 1px solid;\n",
+       "            font-weight: normal; font-family: monospace; font-size: 100%;\n",
+       "        }\n",
+       "        .Table td{\n",
+       "            padding:4px; border:#f0e0e0 1px solid; font-size:100%;\n",
+       "        }\n",
+       "        .Table tr:nth-child(odd){\n",
+       "            background: #ffffff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\n",
+       "            color: #000000;\n",
+       "        }\n",
+       "        /* Tooltip container */\n",
+       "        .djtooltip {\n",
+       "        }\n",
+       "        /* Tooltip text */\n",
+       "        .djtooltip .djtooltiptext {\n",
+       "            visibility: hidden;\n",
+       "            width: 120px;\n",
+       "            background-color: black;\n",
+       "            color: #fff;\n",
+       "            text-align: center;\n",
+       "            padding: 5px 0;\n",
+       "            border-radius: 6px;\n",
+       "            /* Position the tooltip text - see examples below! */\n",
+       "            position: absolute;\n",
+       "            z-index: 1;\n",
+       "        }\n",
+       "        #primary {\n",
+       "            font-weight: bold;\n",
+       "            color: black;\n",
+       "        }\n",
+       "        #nonprimary {\n",
+       "            font-weight: normal;\n",
+       "            color: white;\n",
+       "        }\n",
+       "\n",
+       "        /* Show the tooltip text when you mouse over the tooltip container */\n",
+       "        .djtooltip:hover .djtooltiptext {\n",
+       "            visibility: visible;\n",
+       "        }\n",
+       "    </style>\n",
+       "    \n",
+       "    \n",
+       "        <div style=\"max-height:1000px;max-width:1500px;overflow:auto;\">\n",
+       "        <table border=\"1\" class=\"Table\">\n",
+       "            <thead> <tr style=\"text-align: right;\"> <th> <div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">subject</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">session_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">protocol_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"primary\">opto_params_id</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">implant_date</p>\n",
+       "                            <span class=\"djtooltiptext\">surgery date</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">implant_type</p>\n",
+       "                            <span class=\"djtooltiptext\">Short name for type of implanted device</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">target_region</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region shorthand</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">target_hemisphere</p>\n",
+       "                            <span class=\"djtooltiptext\">Brain region hemisphere</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">device</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">protocol_description</p>\n",
+       "                            <span class=\"djtooltiptext\">description of optogenetics protocol</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">waveform_name</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">wavelength</p>\n",
+       "                            <span class=\"djtooltiptext\">(nm) wavelength of optical stimulation light</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">power</p>\n",
+       "                            <span class=\"djtooltiptext\">(mW) total power from light source</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">light_intensity</p>\n",
+       "                            <span class=\"djtooltiptext\">(mW/mm2) power for given area</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">frequency</p>\n",
+       "                            <span class=\"djtooltiptext\">(Hz) frequency of the waveform</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">duration</p>\n",
+       "                            <span class=\"djtooltiptext\">(ms) duration of each optical stimulus</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>subject1</td>\n",
+       "<td>0</td>\n",
+       "<td>1</td>\n",
+       "<td>1</td>\n",
+       "<td>2022-04-01 12:13:14</td>\n",
+       "<td>opto</td>\n",
+       "<td>dHP</td>\n",
+       "<td>left</td>\n",
+       "<td>OPTG_4</td>\n",
+       "<td></td>\n",
+       "<td>square_10</td>\n",
+       "<td>470</td>\n",
+       "<td>None</td>\n",
+       "<td>10.20</td>\n",
+       "<td>1.0</td>\n",
+       "<td>241.0</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    *protocol_id   *opto_params_i implant_date   implant_type   target_region  target_hemisph device     protocol_descr waveform_name  wavelength     power     light_intensit frequency     duration    \n",
+       "+----------+ +------------+ +------------+ +------------+ +------------+ +------------+ +------------+ +------------+ +--------+ +------------+ +------------+ +------------+ +-------+ +------------+ +-----------+ +----------+\n",
+       "subject1     0              1              1              2022-04-01 12: opto           dHP            left           OPTG_4                    square_10      470            None      10.20          1.0           241.0       \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 37,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoProtocol * optogenetics.OptoStimParams"
    ]
@@ -816,9 +2587,29 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 38,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'subject': 'subject1',\n",
+       "  'session_id': 0,\n",
+       "  'protocol_id': 1,\n",
+       "  'stim_start_time': 241.0,\n",
+       "  'stim_end_time': 482.0},\n",
+       " {'subject': 'subject1',\n",
+       "  'session_id': 0,\n",
+       "  'protocol_id': 1,\n",
+       "  'stim_start_time': 543.0,\n",
+       "  'stim_end_time': 797.0}]"
+      ]
+     },
+     "execution_count": 38,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "optogenetics.OptoEvent.fetch(as_dict=True)"
    ]
@@ -832,9 +2623,24 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 39,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'subject': 'subject1',\n",
+       " 'session_id': 0,\n",
+       " 'protocol_id': 1,\n",
+       " 'stim_start_time': 543.0,\n",
+       " 'stim_end_time': 797.0}"
+      ]
+     },
+     "execution_count": 39,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "(optogenetics.OptoEvent & \"stim_start_time=543\").fetch1()"
    ]