Data-driven burst shape analysis for functional phenotyping of neuronal cultures

corresponding to Schäfer et al., 2025, bioRxiv: Data-driven burst shape analysis for functional phenotyping of neuronal cultures

@article{schaefer2025data-driven,
	author = {Sch{\"a}fer, Tim J. and Giannakakis, Emmanouil and Schmidt-Barbo, Paul and Levina, Anna and Vinogradov, Oleg},
	title = {Data-driven burst shape analysis for functional phenotyping of neuronal cultures},
	year = {2025},
	doi = {10.1101/2025.09.29.679256},
	journal = {bioRxiv},
}

Tutorial

notebooks/tutorial.ipynb walks you through the basic pipeline step-by-step.

Online tools

You can also try out the analysis pipeline without installing anything using the following online tools.

Burst visualization

Try burst visualization (10s loading time)! This is used to visualize all recordings and for adjusting burst detection hyperparameters.

Embedding visualization

Try embedding visualization (10s loading time)! This is used for visualizing the spectral embedding (of individual burst shapes) and exploring this burst shape space.

Links for other datasets

• Blocked inhibition --- Bicuculline (data: Vinogradov et al., 2024)
• Burst visualization
• Embedding visualization
• Kleefstra syndrom (hPSC) (data: Mossink et al., 2021)
  • Burst visualization
  • Embedding visualization
• CACNA1A mutation (data: Hommersom et al., 2024)
• Burst visualization (data not public yet)
• Embedding visualization (data not public yet)
• Developing cultures (data: Wagenaar et al., 2006)
• Burst visualization (dataset too large)
• Embedding visualization (dataset too large)

Setup

Installation

The project uses uv for dependency management. Install uv with

curl -LsSf https://astral.sh/uv/install.sh | sh

or via Homebrew (brew install uv).

Then, from the repo root, run

uv sync

This creates a .venv/ with Python 3.13, installs burst_shape editable, and pulls in every PEP 735 dependency group declared in pyproject.toml (web, analysis, dev). Activate the venv with source .venv/bin/activate, or prepend uv run to any command (e.g. uv run pytest, uv run python scripts/...).

Deployment

See DEPLOY.md for how to build the Docker images and push the online tools to Google Cloud Run.