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

---
 notebooks/tutorial.ipynb | 337 ++++++++++++++++++++-------------------
 1 file changed, 169 insertions(+), 168 deletions(-)

diff --git a/notebooks/tutorial.ipynb b/notebooks/tutorial.ipynb
index 6d3687a..118f42b 100644
--- a/notebooks/tutorial.ipynb
+++ b/notebooks/tutorial.ipynb
@@ -68,15 +68,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 2,
    "metadata": {},
    "outputs": [
     {
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "[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"
+      "[2024-01-17 12:35:14,558][INFO]: Connecting root@fakeservices.datajoint.io:3306\n",
+      "[2024-01-17 12:35:14,571][INFO]: Connected root@fakeservices.datajoint.io:3306\n"
      ]
     },
     {
@@ -85,7 +85,7 @@
        "DataJoint connection (connected) root@fakeservices.datajoint.io:3306"
       ]
      },
-     "execution_count": 3,
+     "execution_count": 2,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -107,14 +107,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [
     {
      "name": "stderr",
      "output_type": "stream",
      "text": [
-      "[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"
+      "[2024-01-17 12:35:14,756][WARNING]: lab.Project and related tables will be removed in a future version of Element Lab. Please use the project schema.\n"
      ]
     }
    ],
@@ -132,192 +132,192 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 4,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "image/svg+xml": [
-       "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"1079pt\" height=\"327pt\" viewBox=\"0.00 0.00 1079.00 327.00\">\n",
+       "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"1079pt\" height=\"327pt\" viewBox=\"0.00 0.00 1078.50 327.00\">\n",
        "<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",
-       "<!-- Device -->\n",
+       "<polygon fill=\"white\" stroke=\"transparent\" points=\"-4,4 -4,-323 1074.5,-323 1074.5,4 -4,4\"/>\n",
+       "<!-- optogenetics.OptoStimParams -->\n",
        "<g id=\"node1\" class=\"node\">\n",
-       "<title>Device</title>\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",
+       "<title>optogenetics.OptoStimParams</title>\n",
+       "<g id=\"a_node1\"><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=\"509,-177 330,-177 330,-142 509,-142 509,-177\"/>\n",
+       "<text text-anchor=\"start\" x=\"338\" 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.OptoProtocol -->\n",
-       "<g id=\"node3\" class=\"node\">\n",
+       "<g id=\"node12\" class=\"node\">\n",
        "<title>optogenetics.OptoProtocol</title>\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",
+       "<g id=\"a_node12\"><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",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- Device&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- optogenetics.OptoStimParams&#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.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",
+       "<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=\"M365.37,-141.97C329.72,-131.09 283.22,-116.89 247.58,-106.01\"/>\n",
        "</g>\n",
-       "<!-- subject.Subject -->\n",
+       "<!-- Device -->\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",
-       "<!-- 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",
+       "<title>Device</title>\n",
+       "<g id=\"a_node2\"><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",
-       "<!-- subject.Subject&#45;&gt;session.Session -->\n",
+       "<!-- Device&#45;&gt;optogenetics.OptoProtocol -->\n",
        "<g id=\"edge2\" 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=\"M167.52,-212.8C157.15,-201.95 143.68,-187.87 133.33,-177.05\"/>\n",
-       "</g>\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=\"M199.48,-212.8C209.85,-201.95 223.32,-187.87 233.67,-177.05\"/>\n",
-       "</g>\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",
-       "<!-- optogenetics.OptoProtocol&#45;&gt;optogenetics.OptoEvent -->\n",
-       "<g id=\"edge4\" 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=\"M183.5,-70.8C183.5,-59.95 183.5,-45.87 183.5,-35.05\"/>\n",
-       "</g>\n",
-       "<!-- optogenetics.OptoWaveformType -->\n",
-       "<g id=\"node4\" class=\"node\">\n",
-       "<title>optogenetics.OptoWaveformType</title>\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",
+       "<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",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform -->\n",
-       "<g id=\"node7\" class=\"node\">\n",
+       "<g id=\"node3\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform</title>\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",
+       "<g id=\"a_node3\"><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=\"863.5,-248 723.5,-248 723.5,-213 863.5,-213 863.5,-248\"/>\n",
+       "<text text-anchor=\"start\" x=\"731.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=\"M596.5,-283.8C596.5,-272.95 596.5,-258.87 596.5,-248.05\"/>\n",
+       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoStimParams -->\n",
+       "<g id=\"edge3\" 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=\"M723.15,-216.52C662.53,-205.34 574.67,-189.13 509.04,-177.02\"/>\n",
        "</g>\n",
        "<!-- optogenetics.OptoWaveform.Sine -->\n",
        "<g id=\"node5\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform.Sine</title>\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",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"690,-169 527,-169 527,-150 690,-150 690,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"608.5\" y=\"-157\" font-family=\"arial\" font-size=\"10.00\">optogenetics.OptoWaveform.Sine</text>\n",
        "</a>\n",
        "</g>\n",
        "</g>\n",
+       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Sine -->\n",
+       "<g id=\"edge4\" 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=\"M749.19,-212.97C712.1,-199.14 660.66,-179.95 631.36,-169.03\"/>\n",
+       "</g>\n",
        "<!-- optogenetics.OptoWaveform.Ramp -->\n",
-       "<g id=\"node6\" class=\"node\">\n",
+       "<g id=\"node9\" class=\"node\">\n",
        "<title>optogenetics.OptoWaveform.Ramp</title>\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",
+       "<g id=\"a_node9\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\rramp_up_proportion   \rramp_down_proportion \r\">\n",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"878.5,-169 708.5,-169 708.5,-150 878.5,-150 878.5,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"793.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.Sine -->\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=\"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=\"edge7\" class=\"edge\">\n",
+       "<g id=\"edge5\" 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=\"M596.5,-212.8C596.5,-199.08 596.5,-180.19 596.5,-169.27\"/>\n",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M793.5,-212.8C793.5,-199.08 793.5,-180.19 793.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",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"1070.5,-169 896.5,-169 896.5,-150 1070.5,-150 1070.5,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"983.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",
+       "<g id=\"edge6\" 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",
+       "<path fill=\"none\" stroke=\"#000000\" stroke-width=\"2\" stroke-opacity=\"0.250980\" d=\"M839.01,-212.97C877.11,-199.14 929.93,-179.95 960.02,-169.03\"/>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoStimParams -->\n",
-       "<g id=\"node12\" class=\"node\">\n",
-       "<title>optogenetics.OptoStimParams</title>\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",
+       "<!-- optogenetics.OptoEvent -->\n",
+       "<g id=\"node4\" class=\"node\">\n",
+       "<title>optogenetics.OptoEvent</title>\n",
+       "<g id=\"a_node4\"><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",
        "</a>\n",
        "</g>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoStimParams -->\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=\"M666.67,-216.92C729.89,-205.59 823.17,-188.88 891.8,-176.58\"/>\n",
+       "<!-- surgery.Implantation -->\n",
+       "<g id=\"node6\" class=\"node\">\n",
+       "<title>surgery.Implantation</title>\n",
+       "<g id=\"a_node6\"><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",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- surgery.Implantation&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<g id=\"edge7\" 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",
+       "</g>\n",
+       "<!-- session.Session -->\n",
+       "<g id=\"node7\" class=\"node\">\n",
+       "<title>session.Session</title>\n",
+       "<g id=\"a_node7\"><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",
+       "</a>\n",
+       "</g>\n",
        "</g>\n",
        "<!-- session.Session&#45;&gt;optogenetics.OptoProtocol -->\n",
-       "<g id=\"edge10\" class=\"edge\">\n",
+       "<g id=\"edge8\" 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",
+       "<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",
        "</g>\n",
-       "<!-- surgery.Implantation&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- optogenetics.OptoWaveformType -->\n",
+       "<g id=\"node8\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveformType</title>\n",
+       "<g id=\"a_node8\"><a xlink:title=\"waveform_type        \r\">\n",
+       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"874,-319 713,-319 713,-284 874,-284 874,-319\"/>\n",
+       "<text text-anchor=\"start\" x=\"721\" y=\"-300\" font-family=\"arial\" text-decoration=\"underline\" font-size=\"10.00\">optogenetics.OptoWaveformType</text>\n",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveformType&#45;&gt;optogenetics.OptoWaveform -->\n",
+       "<g id=\"edge9\" 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=\"M793.5,-283.8C793.5,-272.95 793.5,-258.87 793.5,-248.05\"/>\n",
+       "</g>\n",
+       "<!-- subject.Subject -->\n",
+       "<g id=\"node11\" class=\"node\">\n",
+       "<title>subject.Subject</title>\n",
+       "<g id=\"a_node11\"><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",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- subject.Subject&#45;&gt;surgery.Implantation -->\n",
+       "<g id=\"edge10\" 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",
+       "</g>\n",
+       "<!-- subject.Subject&#45;&gt;session.Session -->\n",
        "<g id=\"edge11\" 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=\"M233.52,-141.8C223.15,-130.95 209.68,-116.87 199.33,-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=\"M209.48,-212.8C219.85,-201.95 233.32,-187.87 243.67,-177.05\"/>\n",
        "</g>\n",
-       "<!-- optogenetics.OptoStimParams&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<!-- optogenetics.OptoProtocol&#45;&gt;optogenetics.OptoEvent -->\n",
        "<g id=\"edge12\" 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 658.53,-114.98 392.4,-99.56 262.61,-93.11\"/>\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",
        "</g>\n",
        "</svg>"
       ],
       "text/plain": [
-       "<datajoint.diagram.Diagram at 0x7fc8b71be100>"
+       "<datajoint.diagram.Diagram at 0x7fdb71c3e190>"
       ]
      },
-     "execution_count": 5,
+     "execution_count": 4,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -351,7 +351,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
@@ -441,7 +441,7 @@
        " (Total: 0)"
       ]
      },
-     "execution_count": 6,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -452,7 +452,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 6,
    "metadata": {},
    "outputs": [
     {
@@ -475,7 +475,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
@@ -490,7 +490,7 @@
        "subject_description=\"\" : varchar(1024)                # "
       ]
      },
-     "execution_count": 8,
+     "execution_count": 7,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -511,7 +511,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 8,
    "metadata": {},
    "outputs": [
     {
@@ -605,7 +605,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 9,
+     "execution_count": 8,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -632,7 +632,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 9,
    "metadata": {},
    "outputs": [
     {
@@ -653,7 +653,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": 10,
    "metadata": {},
    "outputs": [
     {
@@ -666,7 +666,7 @@
        "session_datetime=null : datetime                     # "
       ]
      },
-     "execution_count": 11,
+     "execution_count": 10,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -693,7 +693,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 16,
+   "execution_count": 11,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -702,7 +702,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 17,
+   "execution_count": 12,
    "metadata": {},
    "outputs": [
     {
@@ -788,7 +788,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 17,
+     "execution_count": 12,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -809,7 +809,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 18,
+   "execution_count": 13,
    "metadata": {},
    "outputs": [
     {
@@ -898,7 +898,7 @@
        " (Total: 2)"
       ]
      },
-     "execution_count": 18,
+     "execution_count": 13,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -916,7 +916,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 19,
+   "execution_count": 14,
    "metadata": {},
    "outputs": [
     {
@@ -949,7 +949,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 20,
+   "execution_count": 15,
    "metadata": {},
    "outputs": [
     {
@@ -1039,7 +1039,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 20,
+     "execution_count": 15,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1059,7 +1059,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 21,
+   "execution_count": 16,
    "metadata": {},
    "outputs": [
     {
@@ -1142,7 +1142,7 @@
        " (Total: 6)"
       ]
      },
-     "execution_count": 21,
+     "execution_count": 16,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1153,7 +1153,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 22,
+   "execution_count": 17,
    "metadata": {},
    "outputs": [
     {
@@ -1233,7 +1233,7 @@
        " (Total: 3)"
       ]
      },
-     "execution_count": 22,
+     "execution_count": 17,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1251,7 +1251,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 23,
+   "execution_count": 18,
    "metadata": {},
    "outputs": [
     {
@@ -1333,7 +1333,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 23,
+     "execution_count": 18,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1347,7 +1347,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 24,
+   "execution_count": 19,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1390,7 +1390,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 25,
+   "execution_count": 20,
    "metadata": {},
    "outputs": [
     {
@@ -1492,7 +1492,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 25,
+     "execution_count": 20,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1503,7 +1503,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 26,
+   "execution_count": 21,
    "metadata": {},
    "outputs": [
     {
@@ -1633,7 +1633,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 26,
+     "execution_count": 21,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1651,7 +1651,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 27,
+   "execution_count": 22,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1672,7 +1672,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 28,
+   "execution_count": 23,
    "metadata": {},
    "outputs": [
     {
@@ -1774,7 +1774,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 28,
+     "execution_count": 23,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1797,12 +1797,13 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "### **Insert optogenetics recording data**\n",
     "Next, we'll describe the session in which these parameters are used in `OptoProtocol`."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 30,
+   "execution_count": 24,
    "metadata": {},
    "outputs": [
     {
@@ -1916,7 +1917,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 30,
+     "execution_count": 24,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1947,7 +1948,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 32,
+   "execution_count": 25,
    "metadata": {},
    "outputs": [
     {
@@ -2041,7 +2042,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 32,
+     "execution_count": 25,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2069,7 +2070,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 34,
+   "execution_count": 26,
    "metadata": {},
    "outputs": [
     {
@@ -2168,7 +2169,7 @@
        " (Total: 2)"
       ]
      },
-     "execution_count": 34,
+     "execution_count": 26,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2198,7 +2199,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 35,
+   "execution_count": 27,
    "metadata": {},
    "outputs": [
     {
@@ -2297,7 +2298,7 @@
        " (Total: 2)"
       ]
      },
-     "execution_count": 35,
+     "execution_count": 27,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2315,7 +2316,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 36,
+   "execution_count": 28,
    "metadata": {},
    "outputs": [
     {
@@ -2409,7 +2410,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 36,
+     "execution_count": 28,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2428,7 +2429,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 37,
+   "execution_count": 29,
    "metadata": {},
    "outputs": [
     {
@@ -2566,7 +2567,7 @@
        " (Total: 1)"
       ]
      },
-     "execution_count": 37,
+     "execution_count": 29,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2587,7 +2588,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 38,
+   "execution_count": 30,
    "metadata": {},
    "outputs": [
     {
@@ -2605,7 +2606,7 @@
        "  'stim_end_time': 797.0}]"
       ]
      },
-     "execution_count": 38,
+     "execution_count": 30,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2623,7 +2624,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 39,
+   "execution_count": 31,
    "metadata": {},
    "outputs": [
     {
@@ -2636,7 +2637,7 @@
        " 'stim_end_time': 797.0}"
       ]
      },
-     "execution_count": 39,
+     "execution_count": 31,
      "metadata": {},
      "output_type": "execute_result"
     }