diff --git a/.cspell.json b/.cspell.json
new file mode 100644
index 0000000..5b4e814
--- /dev/null
+++ b/.cspell.json
@@ -0,0 +1,37 @@
+// cSpell Settings
+//https://github.com/streetsidesoftware/vscode-spell-checker
+{
+    "version": "0.2", // Version of the setting file.  Always 0.2
+    "language": "en", // language - current active spelling language
+    "enabledLanguageIds": [
+        "markdown",
+        "yaml",
+        "python"
+    ],
+    // flagWords - list of words to be always considered incorrect
+    // This is useful for offensive words and common spelling errors.
+    // For example "hte" should be "the"
+    "flagWords": [],
+    "allowCompoundWords": true,
+    "ignorePaths": [
+        "./*.egg-info/*",
+        "./images/*"
+    ],
+    "words": [
+        "dorso",
+        "FUCNTION",
+        "ipykernel",
+        "jupytext",
+        "neuro",
+        "OPTG",
+        "opto",
+        "Opto",
+        "optogenetic",
+        "Optogenetic",
+        "optogenetics",
+        "Optogenetics",
+        "pytest",
+        "stim",
+        "Stim"
+    ]
+}
diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
new file mode 100644
index 0000000..a65d696
--- /dev/null
+++ b/.devcontainer/Dockerfile
@@ -0,0 +1,43 @@
+FROM python:3.9-slim
+
+RUN \
+    adduser --system --disabled-password --shell /bin/bash vscode && \
+    # install docker
+    apt-get update && \
+    apt-get install ca-certificates curl gnupg lsb-release -y && \
+    mkdir -m 0755 -p /etc/apt/keyrings && \
+    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg && \
+    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null && \
+    apt-get update && \
+    apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y && \
+    usermod -aG docker vscode && \
+    apt-get clean
+
+RUN \
+    # dev setup
+    apt update && \
+    apt-get install sudo git bash-completion graphviz default-mysql-client s3fs procps -y && \
+    usermod -aG sudo vscode && \
+    echo '%sudo ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers && \
+    pip install --no-cache-dir --upgrade black pip && \
+    echo '. /etc/bash_completion' >> /home/vscode/.bashrc && \
+    echo 'export PS1="\[\e[32;1m\]\u\[\e[m\]@\[\e[34;1m\]\H\[\e[m\]:\[\e[33;1m\]\w\[\e[m\]$ "' >> /home/vscode/.bashrc && \
+    # dircolors -b >> /home/vscode/.bashrc && \  # somehow fix colors
+    apt-get clean
+COPY ./requirements.txt /tmp/
+RUN \
+    # workflow dependencies
+    apt-get install gcc ffmpeg libsm6 libxext6 -y && \
+    pip install --no-cache-dir -r /tmp/requirements.txt && \
+    # clean up
+    rm /tmp/requirements.txt && \
+    apt-get clean
+
+ENV DJ_HOST fakeservices.datajoint.io
+ENV DJ_USER root
+ENV DJ_PASS simple
+
+ENV DATABASE_PREFIX neuro_
+
+USER vscode
+CMD bash -c "sudo rm /var/run/docker.pid; sudo dockerd"
\ No newline at end of file
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..d18e1d2
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,30 @@
+{
+	"name": "Tutorial",
+	"dockerComposeFile": "docker-compose.yaml",
+	"service": "app",
+	"workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+	"remoteEnv": {
+		"LOCAL_WORKSPACE_FOLDER": "${localWorkspaceFolder}"
+	},
+	"onCreateCommand": "pip install -e . && MYSQL_VER=8.0 docker compose down && MYSQL_VER=8.0 docker compose up --build --wait",
+	"postStartCommand": "docker volume prune -f",
+	"hostRequirements": {
+		"cpus": 8,
+		"memory": "16gb",
+		"storage": "32gb"
+	},
+	"forwardPorts": [
+		3306
+	],
+	"customizations": {	
+		"settings": {
+			"python.pythonPath": "/usr/local/bin/python"
+	 	},
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-toolsai.jupyter"
+			]
+		}
+	}
+}
\ No newline at end of file
diff --git a/.devcontainer/docker-compose.yaml b/.devcontainer/docker-compose.yaml
new file mode 100644
index 0000000..28db3c5
--- /dev/null
+++ b/.devcontainer/docker-compose.yaml
@@ -0,0 +1,12 @@
+version: "3"
+services:
+  app:
+    extends:
+      file: ./local-test/docker-compose.yaml
+      service: app
+    devices:
+      - /dev/fuse
+    cap_add:
+      - SYS_ADMIN
+    security_opt:
+      - apparmor:unconfined
\ No newline at end of file
diff --git a/.devcontainer/local-test/devcontainer.json b/.devcontainer/local-test/devcontainer.json
new file mode 100644
index 0000000..ace83ee
--- /dev/null
+++ b/.devcontainer/local-test/devcontainer.json
@@ -0,0 +1,30 @@
+{
+	"name": "Local Test",
+	"dockerComposeFile": "docker-compose.yaml",
+	"service": "app",
+	"workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+	"remoteEnv": {
+		"LOCAL_WORKSPACE_FOLDER": "${localWorkspaceFolder}"
+	},
+	"onCreateCommand": "pip install -r ./requirements_dev.txt && pip install -e . && pip install -e ../element-optogenetics && MYSQL_VER=8.0 docker compose down && MYSQL_VER=8.0 docker compose up --build --wait",
+	"postStartCommand": "docker volume prune -f",
+	"hostRequirements": {
+		"cpus": 8,
+		"memory": "16gb",
+		"storage": "32gb"
+	},
+	"forwardPorts": [
+		3306
+	],
+	"customizations": {
+		"settings": {
+			"python.pythonPath": "/usr/local/bin/python"
+	 	},
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-toolsai.jupyter"
+			]
+		}
+	}
+}
\ No newline at end of file
diff --git a/.devcontainer/local-test/docker-compose.yaml b/.devcontainer/local-test/docker-compose.yaml
new file mode 100644
index 0000000..0dd6db4
--- /dev/null
+++ b/.devcontainer/local-test/docker-compose.yaml
@@ -0,0 +1,13 @@
+version: "3"
+services:
+  app:
+    cpus: 4
+    mem_limit: 8g
+    build:
+      context: ../..
+      dockerfile: ./.devcontainer/Dockerfile
+    extra_hosts:
+      - fakeservices.datajoint.io:127.0.0.1
+    volumes:
+      - ../../..:/workspaces
+    privileged: true # only because of dind
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..31fe9fc
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,39 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: 'bug'
+assignees: ''
+
+---
+
+## Bug Report
+
+### Description
+
+A clear and concise description of what is the overall operation that is intended to be
+performed that resulted in an error.
+
+### Reproducibility
+Include:
+- OS (WIN | MACOS | Linux)
+- DataJoint Element Version
+- MySQL Version
+- MySQL Deployment Strategy (local-native | local-docker | remote)
+- Minimum number of steps to reliably reproduce the issue
+- Complete error stack as a result of evaluating the above steps
+
+### Expected Behavior
+A clear and concise description of what you expected to happen.
+
+### Screenshots
+If applicable, add screenshots to help explain your problem.
+
+### Additional Research and Context
+Add any additional research or context that was conducted in creating this report.
+
+For example:
+- Related GitHub issues and PR's either within this repository or in other relevant
+  repositories.
+- Specific links to specific lines or a focus within source code.
+- Relevant summary of Maintainers development meetings, milestones, projects, etc.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..b3d197d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: DataJoint Contribution Guideline
+    url: https://datajoint.com/docs/community/contribute/
+    about: Please make sure to review the DataJoint Contribution Guidelines
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..1f2b784
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,57 @@
+---
+name: Feature request
+about: Suggest an idea for a new feature
+title: ''
+labels: 'enhancement'
+assignees: ''
+
+---
+
+## Feature Request
+
+### Problem
+
+A clear and concise description how this idea has manifested and the context. Elaborate
+on the need for this feature and/or what could be improved. Ex. I'm always frustrated
+when [...]
+
+### Requirements
+
+A clear and concise description of the requirements to satisfy the new feature. Detail
+what you expect from a successful implementation of the feature. Ex. When using this
+feature, it should [...]
+
+### Justification
+
+Provide the key benefits in making this a supported feature. Ex. Adding support for this
+feature would ensure [...]
+
+### Alternative Considerations
+
+Do you currently have a work-around for this? Provide any alternative solutions or
+features you've considered.
+
+### Related Errors
+Add any errors as a direct result of not exposing this feature.
+
+Please include steps to reproduce provided errors as follows:
+- OS (WIN | MACOS | Linux)
+- DataJoint Element Version
+- MySQL Version
+- MySQL Deployment Strategy (local-native | local-docker | remote)
+- Minimum number of steps to reliably reproduce the issue
+- Complete error stack as a result of evaluating the above steps
+
+### Screenshots
+If applicable, add screenshots to help explain your feature.
+
+### Additional Research and Context
+Add any additional research or context that was conducted in creating this feature request.
+
+For example:
+- Related GitHub issues and PR's either within this repository or in other relevant
+  repositories.
+- Specific links to specific lines or a focus within source code.
+- Relevant summary of Maintainers development meetings, milestones, projects, etc.
+- Any additional supplemental web references or links that would further justify this
+  feature request.
diff --git a/.github/workflows/u24_workflow_before_release.yaml b/.github/workflows/u24_workflow_before_release.yaml
new file mode 100644
index 0000000..28a5ff5
--- /dev/null
+++ b/.github/workflows/u24_workflow_before_release.yaml
@@ -0,0 +1,18 @@
+name: u24_workflow_before_release_0.0.1
+on:
+  pull_request:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
+  workflow_dispatch:
+jobs:
+  call_context_check:
+    uses: dj-sciops/djsciops-cicd/.github/workflows/context_check.yaml@main
+  call_u24_workflow_build_debian:
+    uses: dj-sciops/djsciops-cicd/.github/workflows/u24_workflow_build.yaml@main
+    with:
+      jhub_ver: 1.4.2
+      py_ver: 3.9
+      dist: debian
diff --git a/.github/workflows/u24_workflow_release_call.yaml b/.github/workflows/u24_workflow_release_call.yaml
new file mode 100644
index 0000000..8196673
--- /dev/null
+++ b/.github/workflows/u24_workflow_release_call.yaml
@@ -0,0 +1,20 @@
+name: u24_workflow_release_call_0.0.1
+on:
+  workflow_run:
+    workflows: ["u24_workflow_tag_to_release_0.0.1"]
+    types:
+      - completed
+jobs:
+  call_context_check:
+    uses: dj-sciops/djsciops-cicd/.github/workflows/context_check.yaml@main
+  call_u24_workflow_release_debian:
+    if: >-
+      github.event.workflow_run.conclusion == 'success' && github.repository_owner == 'datajoint'
+    uses: dj-sciops/djsciops-cicd/.github/workflows/u24_workflow_release.yaml@main
+    with:
+      jhub_ver: 1.4.2
+      py_ver: 3.9
+      dist: debian
+    secrets:
+      REGISTRY_USERNAME: ${{secrets.DOCKER_USERNAME}}
+      REGISTRY_PASSWORD: ${{secrets.DOCKER_PASSWORD}}
diff --git a/.github/workflows/u24_workflow_tag_to_release.yaml b/.github/workflows/u24_workflow_tag_to_release.yaml
new file mode 100644
index 0000000..3a6ce58
--- /dev/null
+++ b/.github/workflows/u24_workflow_tag_to_release.yaml
@@ -0,0 +1,15 @@
+name: u24_workflow_tag_to_release_0.0.1
+on:
+  push:
+    tags:
+      - '*.*.*'
+      - 'test*.*.*'
+jobs:
+  call_context_check:
+    uses: dj-sciops/djsciops-cicd/.github/workflows/context_check.yaml@main
+  call_u24_workflow_build_debian:
+    uses: dj-sciops/djsciops-cicd/.github/workflows/u24_workflow_build.yaml@main
+    with:
+      jhub_ver: 1.4.2
+      py_ver: 3.9
+      dist: debian
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..18fcc2f
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,128 @@
+# User data
+.DS_Store
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.idea/
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+scratchpaper.*
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+./.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# datajoint
+dj_local_conf*.json
+temp*
+
+# emacs
+**/*~
+**/#*#
+**/.#*
+docker-compose.yml
+Diagram.ipynb
+*swp
+
+# docker
+.env
+tests/user_dat*
+
+# pytest
+.pytest_cache/
+
+# vscode
+*.code-workspace
\ No newline at end of file
diff --git a/.markdownlint.yaml b/.markdownlint.yaml
new file mode 100644
index 0000000..7420359
--- /dev/null
+++ b/.markdownlint.yaml
@@ -0,0 +1,16 @@
+# Markdown Linter configuration for docs
+# https://github.com/DavidAnson/markdownlint
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+MD009: false # permit trailing spaces
+MD007: false # List indenting - permit 4 spaces
+MD013:
+    line_length: "88" # Line length limits
+    tables: false # disable for tables
+    headings: false # disable for headings
+MD030: false # Number of spaces after a list
+MD033: # HTML elements allowed
+    allowed_elements:
+        - "br"
+MD034: false # Permit bare URLs
+MD031: false # Spacing w/code blocks. Conflicts with `??? Note` and code tab styling
+MD046: false # Spacing w/code blocks. Conflicts with `??? Note` and code tab styling
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 0000000..29eab3b
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,58 @@
+default_stages: [commit, push]
+exclude: (^.github/|^docs/|^images/|^notebooks/py_scripts/)
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files # prevent giant files from being committed
+      - id: requirements-txt-fixer
+      - id: mixed-line-ending
+        args: ["--fix=lf"]
+        description: Forces to replace line ending by the UNIX 'lf' character.
+
+  # black
+  - repo: https://github.com/psf/black
+    rev: 22.12.0
+    hooks:
+      - id: black
+      - id: black-jupyter
+        args:
+          - --line-length=88
+
+  # isort
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+        description: Sorts imports in an alphabetical order
+
+  # flake8
+  - repo: https://github.com/pycqa/flake8
+    rev: 4.0.1
+    hooks:
+      - id: flake8
+        args: # arguments to configure flake8
+          # making isort line length compatible with black
+          - "--max-line-length=88"
+          - "--max-complexity=18"
+          - "--select=B,C,E,F,W,T4,B9"
+
+          # these are errors that will be ignored by flake8
+          # https://www.flake8rules.com/rules/{code}.html
+          - "--ignore=E203,E501,W503,W605,E402"
+          # E203 - Colons should not have any space before them.
+          #        Needed for list indexing
+          # E501 - Line lengths are recommended to be no greater than 79 characters.
+          #        Needed as we conform to 88
+          # W503 - Line breaks should occur after the binary operator.
+          #        Needed because not compatible with black
+          # W605 - a backslash-character pair that is not a valid escape sequence now
+          #        generates a DeprecationWarning. This will eventually become a SyntaxError.
+          #        Needed because we use \d as an escape sequence
+          # E402 - Place module level import at the top.
+          #        Needed to prevent circular import error
diff --git a/.vscode/launch.json b/.vscode/launch.json
new file mode 100644
index 0000000..2b2502c
--- /dev/null
+++ b/.vscode/launch.json
@@ -0,0 +1,16 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Current File",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": false
+        }
+    ]
+}
\ No newline at end of file
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000..e1160fa
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,15 @@
+{
+    "editor.formatOnPaste": false,
+    "editor.formatOnSave": true,
+    "editor.rulers": [
+        88
+    ],
+    "python.formatting.provider": "black",
+    "[python]": {
+        "editor.defaultFormatter": null
+    },
+    "[markdown]": {
+        "editor.defaultFormatter": "disable"
+    },
+    "files.autoSave": "off"
+}
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..9690f16
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,10 @@
+# Changelog
+
+Observes [Semantic Versioning](https://semver.org/spec/v2.0.0.html) standard and
+[Keep a Changelog](https://keepachangelog.com/en/1.0.0/) convention.
+
+## [0.1.0] - 2023-05-04
+
++ Add - First release
+
+[0.1.0]: https://github.com/datajoint/workflow-optogenetics/releases/tag/0.1.0
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..0502528
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[Support@DataJoint.com](mailto:support@datajoint.com).
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..e04d170
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,5 @@
+# Contribution Guidelines
+
+This project follows the
+[DataJoint Contribution Guidelines](https://datajoint.com/docs/community/contribute/).
+Please reference the link for more full details.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5090f5f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+# DataJoint Workflow for Optogenetics
+
+The DataJoint Workflow for Optogenetics combines four DataJoint Elements for
+optogenetics research - Elements Lab, Animal, Session, and Optogenetics.  DataJoint 
+Elements collectively standardize and automate data collection and analysis for 
+neuroscience experiments.  Each Element is a modular pipeline for data storage and 
+processing with corresponding database tables that can be combined with other Elements 
+to assemble a fully functional pipeline.  This repository also provides a tutorial 
+environment and notebook to learn the pipeline.
+
+## Experiment Flowchart
+
+![flowchart](https://raw.githubusercontent.com/datajoint/element-optogenetics/main/images/flowchart.svg)
+
+## Data Pipeline Diagram
+
+![pipeline](https://raw.githubusercontent.com/datajoint/element-optogenetics/main/images/pipeline.svg)
+
+## Getting Started
+
++ [Interactive tutorial on GitHub Codespaces](#interactive-tutorial)
+
++ Install Element Optogenetics from PyPI
+
+     ```bash
+     pip install element-optogenetics
+     ```
+
++ [Documentation](https://datajoint.com/docs/elements/element-optogenetics)
+
+## Support
+
++ If you need help getting started or run into any errors, please contact our team by email at support@datajoint.com.
+
+## Interactive Tutorial
+
++ The easiest way to learn about DataJoint Elements is to use the tutorial notebook within the included interactive environment configured using [Dev Container](https://containers.dev/).
+
+### Launch Environment
+
+Here are some options that provide a great experience:
+
+- Cloud-based Environment (*recommended*)
+  - Launch using [GitHub Codespaces](https://github.com/features/codespaces) using the `+` option which will `Create codespace on main` in the codebase repository on your fork with default options. For more control, see the `...` where you may create `New with options...`.
+  - Build time for a codespace is several minutes. This is done infrequently and cached for convenience.
+  - Start time for a codespace is less than 1 minute. This will pull the built codespace from cache when you need it.
+  - *Tip*: Each month, GitHub renews a [free-tier](https://docs.github.com/en/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#monthly-included-storage-and-core-hours-for-personal-accounts) quota of compute and storage. Typically we run into the storage limits before anything else since codespaces consume storage while stopped. It is best to delete Codespaces when not actively in use and recreate when needed. We'll soon be creating prebuilds to avoid larger build times. Once any portion of your quota is reached, you will need to wait for it to be reset at the end of your cycle or add billing info to your GitHub account to handle overages.
+  - *Tip*: GitHub auto names the codespace but you can rename the codespace so that it is easier to identify later.
+
+- Local Environment
+  - Install [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+  - Install [Docker](https://docs.docker.com/get-docker/)
+  - Install [VSCode](https://code.visualstudio.com/)
+  - Install the VSCode [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+  - `git clone` the codebase repository and open it in VSCode
+  - Use the `Dev Containers extension` to `Reopen in Container` (More info is in the `Getting started` included with the extension.)
+
+You will know your environment has finished loading once you either see a terminal open related to `Running postStartCommand` with a final message of `Done` or the `README.md` is opened in `Preview`.
+
+### Instructions
+
+1. We recommend you start by navigating to the `notebooks` directory on the left panel and go through the `tutorial.ipynb` Jupyter notebook. Execute the cells in the notebook to begin your walk through of the tutorial.
+
+1. Once you are done, see the options available to you in the menu in the bottom-left corner. For example, in codespace you will have an option to `Stop Current Codespace` but when running Dev Container on your own machine the equivalent option is `Reopen folder locally`. By default, GitHub will also automatically stop the Codespace after 30 minutes of inactivity.  Once the codespace is no longer being used, we recommend deleting the codespace.
diff --git a/docker-compose.yaml b/docker-compose.yaml
new file mode 100644
index 0000000..0a2c1fc
--- /dev/null
+++ b/docker-compose.yaml
@@ -0,0 +1,15 @@
+# MYSQL_VER=8.0 docker compose up --build
+version: "2.4"
+services:
+  db:
+    restart: always
+    image: datajoint/mysql:${MYSQL_VER}
+    environment:
+      - MYSQL_ROOT_PASSWORD=${DJ_PASS}
+    ports:
+      - "3306:3306"
+    healthcheck:
+      test: [ "CMD", "mysqladmin", "ping", "-h", "localhost" ]
+      timeout: 15s
+      retries: 10
+      interval: 15s
\ No newline at end of file
diff --git a/notebooks/tutorial.ipynb b/notebooks/tutorial.ipynb
new file mode 100644
index 0000000..5a73025
--- /dev/null
+++ b/notebooks/tutorial.ipynb
@@ -0,0 +1,2622 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Manage optogenetics experiments with DataJoint Elements\n",
+    "\n",
+    "In this tutorial, we will walk through storing optogenetic stimulus data with the DataJoint Workflow for Optogenetics.\n",
+    "\n",
+    "We will explain the following concepts as they relate to this workflow:\n",
+    "- What is an Element versus a Workflow?\n",
+    "- Plot the workflow with `dj.Diagram`\n",
+    "- Insert data into tables\n",
+    "- Query table contents\n",
+    "- Fetch table contents\n",
+    "- Run the workflow for your experiments\n",
+    "\n",
+    "For detailed documentation and tutorials on general DataJoint principles that support collaboration, automation, reproducibility, and visualizations:\n",
+    "\n",
+    "- [DataJoint Interactive Tutorials](https://github.com/datajoint/datajoint-tutorials) - Fundamentals including table tiers, query operations, fetch operations, automated computations with the `make` function, etc.\n",
+    "\n",
+    "- [DataJoint Core - Documentation](https://datajoint.com/docs/core/) - Relational data model principles\n",
+    "\n",
+    "- [DataJoint API for Python - Documentation](https://datajoint.com/docs/core/datajoint-python/)\n",
+    "\n",
+    "- [DataJoint Element for Optogenetics - Documentation](https://datajoint.com/docs/elements/element-optogenetics/)\n",
+    "\n",
+    "Let's start by importing the packages necessary to run this workflow. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import datajoint as dj"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The DataJoint Workflow for Optogenetics is assembled from 4 DataJoint Elements\n",
+    "\n",
+    "| Element | Source Code | Documentation | Description |\n",
+    "| -- | -- | -- | -- |\n",
+    "| Element Lab | [Link](https://github.com/datajoint/element-lab) | [Link](https://datajoint.com/docs/elements/element-lab) | Lab management related information, such as Lab, User, Project, Protocol, Source. |\n",
+    "| Element Animal | [Link](https://github.com/datajoint/element-animal) | [Link](https://datajoint.com/docs/elements/element-animal) | General animal metadata and surgery information. |\n",
+    "| Element Session | [Link](https://github.com/datajoint/element-session) | [Link](https://datajoint.com/docs/elements/element-session) | General information of experimental sessions. |\n",
+    "| Element Optogenetics | [Link](https://github.com/datajoint/element-optogenetics) | [Link](https://datajoint.com/docs/elements/element-optogenetics) |  Optogenetics stimulus and timing data. |\n",
+    "\n",
+    "Each workflow is composed of multiple Elements. Each Element contains 1 or more modules, and each module declares its own schema in the database.\n",
+    "\n",
+    "The Elements are imported within the `workflow_optogenetics.pipeline` script.\n",
+    "\n",
+    "By importing the modules for the first time, the schemas and tables will be created in the database.  Once created, importing modules will not create schemas and tables again, but the existing schemas/tables can be accessed.\n",
+    "\n",
+    "The schema diagram (shown below) is a good reference for understanding the order of the tables within the workflow.\n",
+    "\n",
+    "Let's activate the Elements."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "[2023-05-05 03:13:02,092][WARNING]: lab.Project and related tables will be removed in a future version of Element Lab. Please use the project schema.\n",
+      "[2023-05-05 03:13:02,117][INFO]: Connecting root@fakeservices.datajoint.io:3306\n",
+      "[2023-05-05 03:13:02,146][INFO]: Connected root@fakeservices.datajoint.io:3306\n"
+     ]
+    }
+   ],
+   "source": [
+    "from workflow_optogenetics.pipeline import lab, subject, surgery, session, optogenetics, Device"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Diagram\n",
+    "\n",
+    "We can plot the diagram of tables within multiple schemas and their dependencies using `dj.Diagram()`.  For details, see the [documentation](https://datajoint.com/docs/core/concepts/getting-started/diagrams/)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "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",
+       "<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",
+       "<!-- surgery.Implantation -->\n",
+       "<g id=\"node1\" class=\"node\">\n",
+       "<title>surgery.Implantation</title>\n",
+       "<g id=\"a_node1\"><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",
+       "<!-- optogenetics.OptoProtocol -->\n",
+       "<g id=\"node7\" 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",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- surgery.Implantation&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<g id=\"edge1\" 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",
+       "<!-- optogenetics.OptoEvent -->\n",
+       "<g id=\"node2\" class=\"node\">\n",
+       "<title>optogenetics.OptoEvent</title>\n",
+       "<g id=\"a_node2\"><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.OptoWaveformType -->\n",
+       "<g id=\"node3\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveformType</title>\n",
+       "<g id=\"a_node3\"><a xlink:title=\"waveform_type        \r\">\n",
+       "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" stroke=\"transparent\" points=\"679,-319 518,-319 518,-284 679,-284 679,-319\"/>\n",
+       "<text text-anchor=\"start\" x=\"526\" 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=\"node5\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveform</title>\n",
+       "<g id=\"a_node5\"><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=\"668.5,-248 528.5,-248 528.5,-213 668.5,-213 668.5,-248\"/>\n",
+       "<text text-anchor=\"start\" x=\"536.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=\"edge2\" 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=\"M598.5,-283.8C598.5,-272.95 598.5,-258.87 598.5,-248.05\"/>\n",
+       "</g>\n",
+       "<!-- Device -->\n",
+       "<g id=\"node4\" class=\"node\">\n",
+       "<title>Device</title>\n",
+       "<g id=\"a_node4\"><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",
+       "<!-- Device&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<g id=\"edge3\" 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",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform.Sine -->\n",
+       "<g id=\"node6\" 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=\"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.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=\"M553.71,-212.97C516.22,-199.14 464.22,-179.95 434.61,-169.03\"/>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform.Square -->\n",
+       "<g id=\"node8\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveform.Square</title>\n",
+       "<g id=\"a_node8\"><a xlink:title=\"→ optogenetics.OptoWaveform\r------------------------------\ron_proportion        \roff_proportion       \r\">\n",
+       "<polygon fill=\"transparent\" stroke=\"transparent\" points=\"685.5,-169 511.5,-169 511.5,-150 685.5,-150 685.5,-169\"/>\n",
+       "<text text-anchor=\"middle\" x=\"598.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=\"edge5\" 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=\"M598.5,-212.8C598.5,-199.08 598.5,-180.19 598.5,-169.27\"/>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform.Ramp -->\n",
+       "<g id=\"node10\" class=\"node\">\n",
+       "<title>optogenetics.OptoWaveform.Ramp</title>\n",
+       "<g id=\"a_node10\"><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",
+       "</a>\n",
+       "</g>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoWaveform&#45;&gt;optogenetics.OptoWaveform.Ramp -->\n",
+       "<g id=\"edge6\" 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=\"M644.01,-212.97C682.11,-199.14 734.93,-179.95 765.02,-169.03\"/>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoStimParams -->\n",
+       "<g id=\"node11\" 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",
+       "<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=\"edge7\" 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=\"M668.75,-216.84C731.48,-205.54 823.71,-188.93 891.77,-176.67\"/>\n",
+       "</g>\n",
+       "<!-- optogenetics.OptoProtocol&#45;&gt;optogenetics.OptoEvent -->\n",
+       "<g id=\"edge8\" 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",
+       "<!-- session.Session -->\n",
+       "<g id=\"node9\" class=\"node\">\n",
+       "<title>session.Session</title>\n",
+       "<g id=\"a_node9\"><a xlink:title=\"→ subject.Subject\rsession_id           \r------------------------------\rsession_datetime     \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=\"edge9\" 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",
+       "</g>\n",
+       "<!-- optogenetics.OptoStimParams&#45;&gt;optogenetics.OptoProtocol -->\n",
+       "<g id=\"edge10\" 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",
+       "</g>\n",
+       "<!-- subject.Subject -->\n",
+       "<g id=\"node12\" class=\"node\">\n",
+       "<title>subject.Subject</title>\n",
+       "<g id=\"a_node12\"><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=\"edge11\" 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=\"edge12\" 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",
+       "</g>\n",
+       "</g>\n",
+       "</svg>"
+      ],
+      "text/plain": [
+       "<datajoint.diagram.Diagram at 0x7fa0feb67850>"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "(\n",
+    "    dj.Diagram(subject.Subject)\n",
+    "    + dj.Diagram(surgery.Implantation)\n",
+    "    + dj.Diagram(session.Session)\n",
+    "    + dj.Diagram(Device)\n",
+    "    + dj.Diagram(optogenetics)\n",
+    ")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "While the diagram above seems complex at first, it becomes more clear when it's approached as a hierarchy of tables that define the order in which the workflow expects to receive data in each of its tables.\n",
+    "\n",
+    "The tables higher up in the diagram such as `subject.Subject()` should be the first to receive data.\n",
+    "\n",
+    "Data is manually entered into the green, rectangular tables with the `insert1()` method.\n",
+    "\n",
+    "Tables connected by a solid line depend on entries from the table above it.\n",
+    "\n",
+    "There are 5 table tiers in DataJoint. Some of these tables appear in the diagram above.\n",
+    "\n",
+    "| Table tier | Color and shape | Description |\n",
+    "| -- | -- | -- |\n",
+    "| Manual table | Green box | Data entered from outside the pipeline, either by hand or with external helper scripts. |\n",
+    "| Lookup table | Gray box | Small tables containing general facts and settings of the data pipeline; not specific to any experiment or dataset. |  \n",
+    "| Imported table | Blue oval | Data ingested automatically inside the pipeline but requiring access to data outside the pipeline. |\n",
+    "| Computed table | Red circle | Data computed automatically entirely inside the pipeline. |\n",
+    "| Part table | Plain text | Part tables share the same tier as their master table. |"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Insert entries into manual tables\n",
+    "\n",
+    "In this section, we will insert metadata about an animal subject, experiment session, and optogenetic stimulation parameters.\n",
+    "\n",
+    "Let's start with the first schema and table in the schema diagram (i.e. `subject.Subject` table).\n",
+    "\n",
+    "Each module (e.g. `subject`) contains a schema object that enables interaction with the schema in the database."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Schema `neuro_subject`"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "subject.schema"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The table classes in the module correspond to a table in the database."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "subject.Subject()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can view the table dependencies and the attributes we need to insert by using the functions `.describe()` and `.heading`.  The `describe()` function displays the table definition with foreign key references and the `heading` function displays the attributes of the table definition.  These are particularly useful functions if you are new to DataJoint Elements and are unsure of the attributes required for each table."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'subject              : varchar(8)                   \\n---\\nsubject_nickname=\"\"  : varchar(64)                  \\nsex                  : enum(\\'M\\',\\'F\\',\\'U\\')            \\nsubject_birth_date   : date                         \\nsubject_description=\"\" : varchar(1024)                \\n'"
+      ]
+     },
+     "execution_count": 6,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "print(subject.Subject.describe())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "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": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "subject.Subject.heading"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We will insert data into the `subject.Subject` table. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "subject.Subject.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        sex=\"F\",\n",
+    "        subject_birth_date=\"2020-01-01\",\n",
+    "        subject_description=\"Optogenetic pilot subject\",\n",
+    "    )\n",
+    ")\n",
+    "subject.Subject()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's continue inserting in the other manual tables.  The `Session` table is next."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'-> subject.Subject\\nsession_id           : int                          \\n---\\nsession_datetime     : datetime                     \\n'"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "print(session.Session.describe())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "# \n",
+       "subject              : varchar(8)                   # \n",
+       "session_id           : int                          # \n",
+       "---\n",
+       "session_datetime     : datetime                     # "
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "session.Session.heading"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The cells above show the dependencies and attributes for the `session.Session` table.\n",
+    "\n",
+    "Notice that `describe` shows the dependencies of the table on upstream tables (i.e. foreign key references). The `Session` table depends on the upstream `Subject` table. \n",
+    "\n",
+    "Whereas `heading` lists all the attributes of the `Session` table, regardless of\n",
+    "whether they are declared in an upstream table."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</td>\n",
+       "<td>2022-04-04 12:22:15</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*subject     *session_id    session_dateti\n",
+       "+----------+ +------------+ +------------+\n",
+       "subject1     1              2022-04-04 12:\n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "session.Session.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\", \n",
+    "        session_id=\"1\", \n",
+    "        session_datetime=\"2022-04-04 12:22:15.032\"\n",
+    "     )\n",
+    ")\n",
+    "session.Session()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `OptoProtocol` table's attributes include the `Session` and `Device` tables.  Let's insert into the `Device` table."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "Device.insert1(\n",
+    "    dict(\n",
+    "        device=\"OPTG_8\",\n",
+    "        modality=\"Optogenetics\",\n",
+    "        description=\"8 channel pulse sequence device\",\n",
+    "    )\n",
+    ")\n",
+    "Device()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `surgery.Implantation` table's attribute includes the `User` table.  Let's insert into the `User` table. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 13,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "lab.User.insert1(\n",
+    "    dict(user=\"User1\")\n",
+    ")\n",
+    "lab.User()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `Implantation` table's attributes includes the `CoordinateReference` and `Hemisphere` tables.  Let's view the contents of these lookup tables, which have default contents."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 14,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "surgery.CoordinateReference()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "surgery.Hemisphere()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Insert a new entry for the location of the optogenetics probe."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 16,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "surgery.BrainRegion.insert1(\n",
+    "    dict(\n",
+    "        region_acronym=\"dHP\", \n",
+    "        region_name=\"Dorsal Hippocampus\")\n",
+    ")\n",
+    "surgery.BrainRegion()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "surgery.Implantation.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        implant_date=\"2022-04-01 12:13:14\",\n",
+    "        implant_type=\"opto\",\n",
+    "        target_region=\"dHP\",\n",
+    "        target_hemisphere=\"left\",\n",
+    "        surgeon=\"User1\",\n",
+    "    )\n",
+    ")\n",
+    "surgery.Implantation.Coordinate.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        implant_date=\"2022-04-01 12:13:14\",\n",
+    "        implant_type=\"opto\",\n",
+    "        target_region=\"dHP\",\n",
+    "        target_hemisphere=\"left\",\n",
+    "        ap=\"-7.9\",      # [mm] anterior-posterior distance\n",
+    "        ap_ref=\"bregma\",\n",
+    "        ml=\"-1.8\",      # [mm] medial axis distance\n",
+    "        ml_ref=\"bregma\",\n",
+    "        dv=\"5\",         # [mm] dorso-ventral axis distance\n",
+    "        dv_ref=\"skull_surface\",\n",
+    "        theta=\"11.5\",   # [0, 180] degree rotation about ml-axis relative to z\n",
+    "        phi=\"0\",        # [0, 360] degree rotation about dv-axis relative to x\n",
+    "        beta=None,      # [-180, 180] degree rotation about shank relative to anterior\n",
+    "    )\n",
+    ")\n",
+    "surgery.Implantation.Coordinate()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We'll add information to describe the stimulus, including waveform shape and stimulation parameters."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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\">waveform_name</p>\n",
+       "                            <span class=\"djtooltiptext\"></span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">on_proportion</p>\n",
+       "                            <span class=\"djtooltiptext\">Proportion of stimulus on time within a cycle</span>\n",
+       "                        </div></th><th><div class=\"djtooltip\">\n",
+       "                            <p id=\"nonprimary\">off_proportion</p>\n",
+       "                            <span class=\"djtooltiptext\">Proportion of stimulus off time within a cycle</span>\n",
+       "                        </div> </th> </tr> </thead>\n",
+       "            <tbody> <tr> <td>square_10</td>\n",
+       "<td>0.10</td>\n",
+       "<td>0.90</td> </tr> </tbody>\n",
+       "        </table>\n",
+       "        \n",
+       "        <p>Total: 1</p></div>\n",
+       "        "
+      ],
+      "text/plain": [
+       "*waveform_name on_proportion  off_proportion\n",
+       "+------------+ +------------+ +------------+\n",
+       "square_10      0.10           0.90          \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoWaveform.insert1(\n",
+    "    dict(\n",
+    "        waveform_name=\"square_10\",\n",
+    "        waveform_type=\"square\",\n",
+    "        waveform_description=\"Square waveform: 10%/90% on/off cycle\",\n",
+    "    )\n",
+    ")\n",
+    "\n",
+    "# Square is one part table of OptoWaveform.\n",
+    "# For sine and ramp waveforms, see the corresponding tables.\n",
+    "optogenetics.OptoWaveform.Square.insert1(\n",
+    "    dict(\n",
+    "        waveform_name=\"square_10\", \n",
+    "        on_proportion=0.10, \n",
+    "        off_proportion=0.90)\n",
+    ")\n",
+    "optogenetics.OptoWaveform.Square()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoStimParams.insert1(\n",
+    "    dict(\n",
+    "        opto_params_id=1,\n",
+    "        waveform_name=\"square_10\",\n",
+    "        wavelength=470,\n",
+    "        light_intensity=10.2,\n",
+    "        frequency=1,\n",
+    "        duration=241,\n",
+    "    )\n",
+    ")\n",
+    "optogenetics.OptoStimParams()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, we'll describe the session in which these parameters are used in `OptoProtocol`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</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     1              1              1              2022-04-01 12: opto           dHP            left           OPTG_4                   \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoProtocol.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        session_id=\"1\",\n",
+    "        protocol_id=\"1\",\n",
+    "        opto_params_id=\"1\",\n",
+    "        implant_date=\"2022-04-01 12:13:14\",\n",
+    "        implant_type=\"opto\",\n",
+    "        target_region=\"dHP\",\n",
+    "        target_hemisphere=\"left\",\n",
+    "        device=\"OPTG_4\",\n",
+    "    )\n",
+    ")\n",
+    "optogenetics.OptoProtocol()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can describe the timing of these stimulations in `OptoEvent`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</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     1              1              241.0          482.0         \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 21,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoEvent.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        session_id=1,\n",
+    "        protocol_id=1,\n",
+    "        stim_start_time=241,\n",
+    "        stim_end_time=482,\n",
+    "    )\n",
+    ")\n",
+    "optogenetics.OptoEvent()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can insert a  second set of timing information for the stimulation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</td>\n",
+       "<td>1</td>\n",
+       "<td>241.0</td>\n",
+       "<td>482.0</td></tr><tr><td>subject1</td>\n",
+       "<td>1</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     1              1              241.0          482.0         \n",
+       "subject1     1              1              543.0          797.0         \n",
+       " (Total: 2)"
+      ]
+     },
+     "execution_count": 22,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoEvent.insert1(\n",
+    "    dict(\n",
+    "        subject=\"subject1\",\n",
+    "        session_id=1,\n",
+    "        protocol_id=1,\n",
+    "        stim_start_time=543,\n",
+    "        stim_end_time=797,\n",
+    "    )\n",
+    ")\n",
+    "optogenetics.OptoEvent()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Query\n",
+    "\n",
+    "Queries allow you to view the contents of the database.  The simplest query is the instance of the table class."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</td>\n",
+       "<td>1</td>\n",
+       "<td>241.0</td>\n",
+       "<td>482.0</td></tr><tr><td>subject1</td>\n",
+       "<td>1</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     1              1              241.0          482.0         \n",
+       "subject1     1              1              543.0          797.0         \n",
+       " (Total: 2)"
+      ]
+     },
+     "execution_count": 23,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoEvent()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "With the `&` operator, we will restrict the contents of the `OptoEvent` table to those entries with a `stim_start_time` of 543."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</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     1              1              543.0          797.0         \n",
+       " (Total: 1)"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoEvent & \"stim_start_time=543\""
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "DataJoint queries can be a highly flexible tool with several [operators](https://datajoint.com/docs/core/concepts/query-lang/operators/).  The next operator we will explore is `join` which combines matching information from tables."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "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",
+       "        }\n",
+       "        .Table tr:nth-child(even){\n",
+       "            background: #f3f1ff;\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>1</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     1              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": 25,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoProtocol * optogenetics.OptoStimParams"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Fetch\n",
+    "\n",
+    "The `fetch` and `fetch1` methods download the data from the query object into the workspace.\n",
+    "\n",
+    "Below we will run `fetch()` without any arguments to return all attributes of all entries in the table."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[{'subject': 'subject1',\n",
+       "  'session_id': 1,\n",
+       "  'protocol_id': 1,\n",
+       "  'stim_start_time': 241.0,\n",
+       "  'stim_end_time': 482.0},\n",
+       " {'subject': 'subject1',\n",
+       "  'session_id': 1,\n",
+       "  'protocol_id': 1,\n",
+       "  'stim_start_time': 543.0,\n",
+       "  'stim_end_time': 797.0}]"
+      ]
+     },
+     "execution_count": 26,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "optogenetics.OptoEvent.fetch(as_dict=True)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, we will fetch the entry with a `stim_start_time` of 543 with the `fetch1` method, which returns a dictionary containing all attributes of one entry in the table."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'subject': 'subject1',\n",
+       " 'session_id': 1,\n",
+       " 'protocol_id': 1,\n",
+       " 'stim_start_time': 543.0,\n",
+       " 'stim_end_time': 797.0}"
+      ]
+     },
+     "execution_count": 27,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "(optogenetics.OptoEvent & \"stim_start_time=543\").fetch1()"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Next steps\n",
+    "\n",
+    "Follow the steps below to run this workflow for your experiments:\n",
+    "\n",
+    "- Create a fork of this repository to your GitHub account.\n",
+    "- Clone the repository to your local machine and configure for use with the instructions in the [User Guide](https://datajoint.com/docs/elements/user-guide/).\n",
+    "- The DataJoint team offers free [Office Hours](https://datajoint.com/docs/community/support/) to help you setup this workflow.\n",
+    "- If you have any questions, please reach out at support@datajoint.com."
+   ]
+  }
+ ],
+ "metadata": {
+  "jupytext": {
+   "encoding": "# -*- coding: utf-8 -*-"
+  },
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.16"
+  },
+  "metadata": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "949777d72b0d2535278d3dc13498b2535136f6dfe0678499012e853ee9abcab1"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..dc4f6cd
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,8 @@
+datajoint>=0.13.0
+element-animal>=0.1.2
+element-event>=0.1.2
+element-interface>=0.5.1
+element-lab>=0.1.1
+element-optogenetics>=0.1.1
+element-session>=0.1.2
+ipykernel>=6.0.1
\ No newline at end of file
diff --git a/requirements_dev.txt b/requirements_dev.txt
new file mode 100644
index 0000000..9955dec
--- /dev/null
+++ b/requirements_dev.txt
@@ -0,0 +1,2 @@
+pytest
+pytest-cov
diff --git a/setup.py b/setup.py
new file mode 100644
index 0000000..d62ffb3
--- /dev/null
+++ b/setup.py
@@ -0,0 +1,38 @@
+#!/usr/bin/env python
+from os import path
+
+from setuptools import find_packages, setup
+
+pkg_name = "workflow_optogenetics"
+here = path.abspath(path.dirname(__file__))
+
+long_description = """"
+# Workflow for optogenetics research.
+
+Build a complete optogenetics workflow using the DataJoint Elements
++ [element-lab](https://github.com/datajoint/element-lab)
++ [element-animal](https://github.com/datajoint/element-animal)
++ [element-session](https://github.com/datajoint/element-session)
++ [element-optogenetics](https://github.com/datajoint/element-optogenetics)
+"""
+
+with open(path.join(here, "requirements.txt")) as f:
+    requirements = f.read().splitlines()
+
+with open(path.join(here, pkg_name, "version.py")) as f:
+    exec(f.read())
+
+setup(
+    name="workflow-optogenetics",
+    version=__version__,  # noqa: F821
+    description="Optogenetics workflow using DataJoint Elements",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="DataJoint",
+    author_email="info@datajoint.com",
+    license="MIT",
+    url="https://github.com/datajoint/workflow-optogenetics",
+    keywords="neuroscience datajoint optogenetics",
+    packages=find_packages(exclude=["contrib", "docs", "tests*"]),
+    install_requires=requirements,
+)
diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 0000000..316a845
--- /dev/null
+++ b/tests/__init__.py
@@ -0,0 +1,63 @@
+"""
+run all: python -m pytest tests/
+run one: python -m pytest --pdb tests/module_name.py -k function_name
+"""
+
+import logging
+import os
+import sys
+from contextlib import nullcontext
+from pathlib import Path
+
+import datajoint as dj
+import pytest
+
+# Constants ----------------------------------------------------------------------------
+
+logger = logging.getLogger("datajoint")
+
+_tear_down = True
+verbose = True
+
+# Functions ----------------------------------------------------------------------------
+
+
+class QuietStdOut:
+    """If verbose set to false, used to quiet table deletion print statements"""
+
+    def __enter__(self):
+        logger.setLevel("WARNING")
+        self._original_stdout = sys.stdout
+        sys.stdout = open(os.devnull, "w")
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        logger.setLevel("INFO")
+        sys.stdout.close()
+        sys.stdout = self._original_stdout
+
+verbose_context = nullcontext() if verbose else QuietStdOut()
+
+# Fixtures -----------------------------------------------------------------------------
+
+
+@pytest.fixture(scope="session")
+def pipeline():
+    """Loads lab, subject, session, optogenetics, Device"""
+    with verbose_context:
+        from workflow_optogenetics import pipeline
+
+    yield {
+        "lab": pipeline.lab,
+        "subject": pipeline.subject,
+        "surgery": pipeline.surgery,
+        "session": pipeline.session,
+        "optogenetics": pipeline.optogenetics,
+        "Device": pipeline.Device,
+    }
+    if _tear_down:
+        with verbose_context:
+            pipeline.optogenetics.OptoWaveform.delete()
+            pipeline.surgery.BrainRegion.delete()
+            pipeline.subject.Subject.delete()
+            pipeline.session.Session.delete()
+            pipeline.lab.User.delete()
diff --git a/tests/test_pipeline_generation.py b/tests/test_pipeline_generation.py
new file mode 100644
index 0000000..6f177e4
--- /dev/null
+++ b/tests/test_pipeline_generation.py
@@ -0,0 +1,29 @@
+from . import pipeline
+
+
+def test_upstream_pipeline(pipeline):
+    session = pipeline["session"]
+    surgery = pipeline["surgery"]
+    subject = pipeline["subject"]
+
+    # Test connection from Subject to downstream tables
+    assert subject.Subject.full_table_name in session.Session.parents()
+    assert subject.Subject.full_table_name in surgery.Implantation.parents()
+
+
+def test_optogenetics_pipeline(pipeline):
+    session = pipeline["session"]
+    surgery = pipeline["surgery"]
+    optogenetics = pipeline["optogenetics"]
+    Device = pipeline["Device"]
+
+    # Test connection from optogenetics.OptoProtocol to parent tables
+    assert session.Session.full_table_name in optogenetics.OptoProtocol.parents()
+    assert (
+        optogenetics.OptoStimParams.full_table_name
+        in optogenetics.OptoProtocol.parents()
+    )
+    assert surgery.Implantation.full_table_name in optogenetics.OptoProtocol.parents()
+    assert Device.full_table_name in optogenetics.OptoProtocol.parents()
+
+    assert "stim_start_time" in optogenetics.OptoEvent.heading.attributes
diff --git a/workflow_optogenetics/__init__.py b/workflow_optogenetics/__init__.py
new file mode 100644
index 0000000..93b1d40
--- /dev/null
+++ b/workflow_optogenetics/__init__.py
@@ -0,0 +1,12 @@
+import os
+import datajoint as dj
+
+
+if 'custom' not in dj.config:
+    dj.config['custom'] = {}
+
+dj.config['custom']['database.prefix'] = os.getenv(
+    'DATABASE_PREFIX',
+    dj.config['custom'].get('database.prefix', ''))
+
+db_prefix = dj.config["custom"].get("database.prefix", "")
diff --git a/workflow_optogenetics/pipeline.py b/workflow_optogenetics/pipeline.py
new file mode 100644
index 0000000..1ee99cf
--- /dev/null
+++ b/workflow_optogenetics/pipeline.py
@@ -0,0 +1,42 @@
+from element_animal import subject, surgery
+from element_animal.subject import Subject  # Dependency for session schema
+from element_animal.surgery import Implantation  # Dependency for optogenetics schema
+from element_lab import lab
+from element_lab.lab import Lab, Project, Protocol, Source, User
+from element_optogenetics import optogenetics
+from element_session import session_with_id as session
+from element_session.session_with_id import Session
+
+from . import db_prefix
+from .reference import Device
+
+__all__ = [
+    "lab",
+    "optogenetics",
+    "session",
+    "subject",
+    "surgery",
+    "Device",
+    "Implantation",
+    "Lab",
+    "Project",
+    "Protocol",
+    "Session",
+    "Source",
+    "Subject",
+    "User",
+]
+
+
+# Activate "lab", "subject", "surgery", "session" schemas -------
+
+lab.activate(db_prefix + "lab")
+subject.activate(db_prefix + "subject", linking_module=__name__)
+surgery.activate(db_prefix + "surgery", linking_module=__name__)
+
+Experimenter = User
+session.activate(db_prefix + "session", linking_module=__name__)
+
+# Activate "optogenetics" schema -------------
+
+optogenetics.activate(db_prefix + "optogenetics", linking_module=__name__)
diff --git a/workflow_optogenetics/reference.py b/workflow_optogenetics/reference.py
new file mode 100644
index 0000000..0a64e8d
--- /dev/null
+++ b/workflow_optogenetics/reference.py
@@ -0,0 +1,26 @@
+import datajoint as dj
+
+from . import db_prefix
+
+schema = dj.Schema(db_prefix + "reference")
+
+
+@schema
+class Device(dj.Lookup):
+    """Table for managing lab devices.
+
+    Attributes:
+        device ( varchar(32) ): Device short name.
+        modality ( varchar(64) ): Modality for which this device is used.
+        description ( varchar(256), optional ): Description of device.
+    """
+
+    definition = """
+    device             : varchar(32)
+    ---
+    modality           : varchar(64)
+    description=''     : varchar(256)
+    """
+    contents = [
+        ["OPTG_4", "Optogenetics", "Doric Pulse Sequence Generator"],
+    ]
diff --git a/workflow_optogenetics/version.py b/workflow_optogenetics/version.py
new file mode 100644
index 0000000..652faa3
--- /dev/null
+++ b/workflow_optogenetics/version.py
@@ -0,0 +1,4 @@
+"""
+Package metadata
+"""
+__version__ = "0.1.0"