DataJoint Documentation

Official documentation for DataJoint 2.0 — an open-source framework for building scientific data pipelines.

📖 Live site: https://docs.datajoint.com

Upgrading from pre-2.0? See the Migration Guide

About DataJoint

DataJoint is a Python framework for scientific data pipelines built on the Relational Workflow Model. For installation, tutorials, and complete documentation, visit docs.datajoint.com.

Documentation Structure

This repository contains the source for the DataJoint documentation, organized using the Diátaxis framework:

• Tutorials — Learn by building real pipelines
• How-To Guides — Practical task-oriented guides
• Explanation — Understanding concepts and design
• Reference — Specifications and API documentation

Local Development

Docker (Recommended)

# Clone repositories
git clone https://github.com/datajoint/datajoint-docs.git
cd datajoint-docs
cd ..
git clone -b pre/v2.0 https://github.com/datajoint/datajoint-python.git
cd datajoint-docs

# Start live preview at http://localhost:8000
MODE="LIVE" docker compose up --build

# Build static site (optional)
# MODE="BUILD" docker compose up --build

The Docker environment includes MySQL, MinIO, and all dependencies.

Native Python

Prerequisites: Python 3.10+, MySQL 8.0+

# Setup
git clone https://github.com/datajoint/datajoint-docs.git
cd datajoint-docs
python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r pip_requirements.txt

# Configure credentials
mkdir -p .secrets
echo "your_username" > .secrets/database.user
echo "your_password" > .secrets/database.password
chmod 600 .secrets/*

# Start live preview at http://localhost:8000
mkdocs serve

Contributing

Contributions welcome! See contribution guidelines.

Quick fixes: Fork, edit markdown in src/, submit PR.

Tutorial notebooks: Re-execute after changes:

docker compose exec docs jupyter nbconvert --to notebook --execute --inplace \
    /main/src/tutorials/YOUR_NOTEBOOK.ipynb

Related

• datajoint-python — Core library
• DataJoint Elements — Neuroscience pipeline modules
• datajoint.com — Commercial support

Citation

Yatsenko D, Walker EY, Tolias AS. DataJoint: A Simpler Relational Data Model. arXiv:2303.00102. 2023. doi: 10.48550/arXiv.2303.00102

Full citation information: docs.datajoint.com/about/citation/

License

• Documentation: CC BY 4.0
• DataJoint software: Apache 2.0 (LGPLv2.1 prior to v2.0)