Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

External Sources

SynDB supports importing connectomics data from 20+ major connectome datasets. This page covers the supported imports grouped by organism. See the CLI Reference for the complete command reference.

Note

Dataset UUID

The <syndb-dataset-id> is the UUID of the SynDB dataset that will be associated with the imported data. You can copy and paste it from the dataset management page in the web UI.

What SynDB Needs From External Groups

When we say that we need the “full dataset” for SynDB ingestion, we do not mean the raw imaging volume. We mean the complete analysis-ready release needed to populate the SynDB tables for a dataset version.

For most connectomics imports, that means:

  • the complete neuron or object table for the release
  • the complete synapse table for the same release, or an aggregated connection table if that is the available downstream artifact
  • stable source identifiers such as root_id, pre_pt_root_id, and post_pt_root_id
  • coordinates and annotations needed to map the source schema into SynDB
  • optional morphology assets such as swc/ or meshes if they are part of the release

What this usually does not mean:

  • raw microscopy image stacks or volume tiles
  • Neuroglancer or CAVE precomputed segmentation volumes by themselves
  • ongoing operational access to the source group’s infrastructure after a static export has been produced

Preferred handoff

The preferred handoff is a static snapshot in an S3-compatible bucket, or an equivalent directory export with the same files. If the source data lives in CAVE, export the materialized tables first and hand off the files; SynDB imports the exported tables, not CAVE itself.

In practical terms, the source group’s involvement is usually limited to:

  • granting permission for SynDB to ingest and redistribute the agreed downstream artifacts
  • providing the exported snapshot in an agreed format
  • answering schema questions if a column needs clarification

For a typical neuron and synapse release, the handoff looks like:

dataset-name/
  neurons.csv.gz
  synapses.csv.gz
  connections.csv.gz   # optional aggregated fallback
  swc/                 # optional morphology assets
  meshes/              # optional geometry assets

Note

Organelle coverage is separate

Public SynDB support for a dataset’s neuron and synapse import path does not imply that vesicle or mitochondria tables are also available. For the current Hemibrain, MANC/Male CNS, MICrONS, and H01 production paths, SynDB imports neurons and synapses only. Any organelle-backed workflow such as manuscript CF08 needs a separate upstream snapshot or manual export path plus matching ETL wiring before production can populate those tables.


Drosophila melanogaster

FlyWire

Whole-brain Drosophila connectome reconstructed from a full adult female brain (FAFB). SynDB uses the credential-free release 783 proofread neuron IDs, aggregated connections (one row per neuron pair and neuropil) and per-neuron presynapse counts per neuropil (each neuron’s brain_structure is the neuropil holding most of its output synapses, hemispheres merged), plus the Codex 783 cell_stats.csv.gz (cable length, surface area, volume) and neurons.csv.gz (neuron-level neurotransmitter predictions) exports.

Source: Zenodo 10676866 (CC BY 4.0) | Publication: Dorkenwald et al., 2024. Nature

Download the immutable source artifacts:

syndb etl flywire download --output-dir external_datasets/FlyWire

Codex downloads require a FlyWire Google sign-in, so the two Codex exports are manual: download cell_stats.csv.gz and neurons.csv.gz for FAFB 783 from Codex in a signed-in browser into the same directory. Validation and hub staging pin both files by size and MD5; a re-export with a different checksum must be reviewed and the pin in crates/tools/etl/src/flywire/mod.rs updated. Codex reports nm, nm² and nm³; the ETL converts them to µm, µm² and µm³.

For the hub, the Zenodo files come from the FlyWire download job. Stage only the verified Codex exports beside them (copied, never mirrored, so the hub files and .ready sentinel are untouched):

SYNDB_ETL_ALLOW_LOCAL_RAW_STAGE=1 syndb ops k8s etl s3-upload flywire \
  --data-dir external_datasets/FlyWire

Validate your FlyWire data directory:

syndb etl flywire validate --data-dir external_datasets/FlyWire

Import into your dataset:

syndb etl flywire import \
  --data-dir external_datasets/FlyWire \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

The credential-free source contract intentionally excludes individual detailed synapses.

Hemibrain

Half-brain connectome of an adult Drosophila from the Janelia FlyEM project (v1.2.1). Contains ~25,000 neurons with traced morphology and synaptic connections.

Source: Janelia FlyEM Hemibrain | Publication: Scheffer et al., 2020. eLife

Download the dataset:

syndb etl hemibrain download --output-dir external_datasets/Hemibrain --extract

Validate and import:

syndb etl hemibrain validate --data-dir external_datasets/Hemibrain

syndb etl hemibrain import \
  --data-dir external_datasets/Hemibrain \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

MANC (Male Adult Nerve Cord)

Connectome of the male Drosophila ventral nerve cord (VNC). Data is distributed as Apache Arrow Feather files.

Source: Janelia FlyEM MANC | Publication: Takemura et al., 2024. Nature

Download the dataset:

syndb etl manc download --output-dir external_datasets/MANC

Validate and import:

syndb etl manc validate --data-dir external_datasets/MANC

syndb etl manc import \
  --data-dir external_datasets/MANC \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

Warning

Download size

The MANC dataset includes the connectome-weights Feather file (~1.1 GB). Ensure sufficient disk space before downloading.

Male CNS

Male Drosophila central nervous system connectome from Janelia FlyEM. Covers the brain and ventral nerve cord with neuron-level connectivity.

Source: Google Cloud Storage | Publication: Takemura et al., 2024. Nature

Download and import:

syndb etl male-cns download --output-dir external_datasets/MaleCNS

syndb etl male-cns validate --data-dir external_datasets/MaleCNS

syndb etl male-cns import \
  --data-dir external_datasets/MaleCNS \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

Warning

ETL download, prepare, validate, and import commands are hub-worker operations. Do not run public dataset downloads into a workstation directory. The only permitted alternatives are a configured hub-direct job or an explicitly enabled local raw-stage workflow.

FANC (Female Adult Nerve Cord)

Connectome of the female Drosophila ventral nerve cord, enabling sex-specific comparisons with MANC. SynDB imports a static export of the FANC neuron and synapse tables, not the live CAVE deployment itself.

Publication: Phelps et al., 2021. Cell

FANC is inactive. Its CAVE access and export path are not currently viable for the approved acquisition methods, so no download or import command is provided until the source policy is changed by its maintainer.

Optic Lobe

Drosophila optic lobe connectome from Janelia FlyEM. Maps the visual processing circuitry of the fly brain.

Source: Google Cloud Storage | Publication: Matsliah et al., 2024. Nature

syndb etl optic-lobe download --output-dir external_datasets/OpticLobe

syndb etl optic-lobe validate --data-dir external_datasets/OpticLobe

syndb etl optic-lobe import \
  --data-dir external_datasets/OpticLobe \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

BANC (Brain And Nerve Cord)

Whole-body Drosophila connectome covering the brain and ventral nerve cord in a single female specimen.

Publication: Jasper et al., 2024

syndb etl banc download --output-dir external_datasets/BANC

syndb etl banc validate --data-dir external_datasets/BANC

syndb etl banc import \
  --data-dir external_datasets/BANC \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

L1 Larval

Complete connectome of the first-instar Drosophila larval brain (~3,000 neurons), the first whole-brain connectome of any insect.

Source: GitHub | Publication: Winding et al., 2023. Science

syndb etl larval download --output-dir external_datasets/L1Larval

syndb etl larval validate --data-dir external_datasets/L1Larval

syndb etl larval import \
  --data-dir external_datasets/L1Larval \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

L1 and L3 Larval Nerve Cord (Gerhard 2017)

Reconstructed neurons of the Drosophila larval ventral nerve cord at two instars (18 neurons each), imported as two datasets. Synapses are connectors shared by reconstructed neurons of the same instar.

Source: GitHub (pinned commit, MIT) | Publication: Gerhard et al., 2017. eLife (CC BY 4.0)

syndb etl gerhard2017-l1 download --output-dir external_datasets/Gerhard2017_L1
syndb etl gerhard2017-l1 validate --data-dir external_datasets/Gerhard2017_L1
syndb etl gerhard2017-l3 download --output-dir external_datasets/Gerhard2017_L3
syndb etl gerhard2017-l3 validate --data-dir external_datasets/Gerhard2017_L3

Mouse

MICrONS (Minnie65)

Cubic millimeter of mouse visual cortex reconstructed at synaptic resolution by the MICrONS Consortium. Contains ~80,000 neurons and millions of synapses.

Source: MICrONS Explorer | Publication: MICrONS Consortium et al., 2021. bioRxiv

syndb etl microns download --output-dir external_datasets/MICrONS

syndb etl microns validate --data-dir external_datasets/MICrONS

syndb etl microns import \
  --data-dir external_datasets/MICrONS \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

Spine Morphometry

Dendritic spine morphological measurements from electron microscopy. Three sub-datasets are supported:

VariantKeySourcePublication
KasthurikasthuriColumbia Academic CommonsKasthuri et al., 2015. Cell
Oferofer-confocalZenodoOfer et al., 2022
MICrONSmicronsZenodoDerived from MICrONS cortical data
syndb etl spine-morphometry download --source kasthuri --output-dir external_datasets/SpineKasthuri

syndb etl spine-morphometry validate \
  --source kasthuri \
  --data-dir external_datasets/SpineKasthuri

syndb etl spine-morphometry import \
  --data-dir external_datasets/SpineKasthuri \
  --dataset-id <syndb-dataset-id> \
  --source kasthuri

Human

H01

One cubic millimeter of human temporal cortex at nanometer resolution. Contains reconstructed neurons, synapses, and glia from a neurosurgical tissue sample. The neurons table holds the 16,087 neurons reported in the paper: the release annotates 49,379 somata, and its 20,139 oligodendrocytes, 6,536 microglia/OPC, 5,474 astrocytes, 166 c-shaped (parasitic) glia, 285 blood-vessel cells and 692 unclassified cells are not imported. The synapses table holds the 160,259,769 synapses SynDB imports from the release’s June 2021 export; the paper reports 149,871,669 synapses. Cell-level connectivity is not published. Export ids are segments of the automated, unproofread c3 agglomeration, in which axons are mostly not attached to cell bodies. SynDB therefore holds a soma-segment graph that is neither the H01 connectome nor a bound on it: it is unproofread and, unlike the paper’s synapse set, not restricted to axonal pre-synaptic sites. A node is a c3 segment containing exactly one annotated soma, that soma a neuron (15,325 of the 16,087 neurons; left out are 268 with no c3 segment, 99 in 49 segments shared by two or three neurons, and 395 whose segment also holds a non-neuronal soma; these keep graph_key: none and the reason in metadata). Over all 160,259,769 synapses, 110,653 (0.069%) have both endpoints on a node, 524,831 only the pre-synaptic one, 26,443,505 only the post-synaptic one and 133,180,780 neither; the graph has 73,292 directed neuron pairs. Graph precompute runs on that projection and marks its status declared_partial_annotated_projection.

Source: Google Cloud Storage | Publication: Shapson-Coe et al., 2024. Science

syndb etl h01 download --output-dir external_datasets/H01

syndb etl h01 validate --data-dir external_datasets/H01

syndb etl h01 import \
  --data-dir external_datasets/H01 \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

C. elegans

C. elegans Hermaphrodite

Complete connectome of the adult hermaphrodite C. elegans (~300 neurons), the first organism with a fully mapped nervous system. Data sourced from the OpenWorm ConnectomeToolbox.

Source: OpenWorm ConnectomeToolbox | Publication: Cook et al., 2019. Nature

syndb etl celegans download --output-dir external_datasets/CElegansHerm

syndb etl celegans validate --data-dir external_datasets/CElegansHerm

syndb etl celegans import \
  --data-dir external_datasets/CElegansHerm \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

C. elegans Male

Complete connectome of the adult male C. elegans, enabling sex-specific neural circuit comparisons.

Source: OpenWorm ConnectomeToolbox | Publication: Cook et al., 2019. Nature

syndb etl celegans-male download --output-dir external_datasets/CElegansMale

syndb etl celegans-male validate --data-dir external_datasets/CElegansMale

syndb etl celegans-male import \
  --data-dir external_datasets/CElegansMale \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

C. elegans Developmental

Connectomes across eight developmental stages of C. elegans, tracking how neural circuits are assembled during growth.

Source: GitHub | Publication: Witvliet et al., 2021. Nature

syndb etl witvliet download --output-dir external_datasets/CElegansDev

syndb etl witvliet validate --data-dir external_datasets/CElegansDev

syndb etl witvliet import \
  --data-dir external_datasets/CElegansDev \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

Other Organisms

Pristionchus pacificus Amphid (Hong 2019)

Class-level amphid sensory connectivity of Pristionchus pacificus (18 left/right-pooled cell classes, 187 chemical and electrical edge rows including self-loops) from serial-section TEM of two young adult hermaphrodites. Cook et al. 2025 report that ASE and AWC identities were later revised; labels follow the 2019 source file.

Source: eLife CDN (Figure 9 source data 2) | Publication: Hong et al., 2019. eLife (CC BY 4.0)

syndb etl ppacificus-amphid download --output-dir external_datasets/PPacificus_Amphid
syndb etl ppacificus-amphid validate --data-dir external_datasets/PPacificus_Amphid

Zebrafish Larval Olfactory Bulb (Wanner 2016)

Skeleton reconstructions of 1,022 neurons of the olfactory bulb of one 4.5 dpf Danio rerio larva (serial block-face EM, 4,746 sections at 25 nm). Neurons carry a cell type (mitral cell, interneuron class 1 to 3, unusual projection neuron, large olfactory bulb cell, unclassified), the soma centroid in nm (mean of the soma annotation points), the skeleton node count and path length, and the neurite length per glomerulus in µm (non-zero glomeruli only). The release holds skeletons only, so there is no synapse table. The archive is read in place and never extracted; the import fails unless the CSV neuron IDs and the neuron .nmx files match one-to-one.

Licence: CC BY-NC 4.0 (Zenodo 58985). SynDB serves this dataset restricted behind a data-use agreement, for non-commercial use only.

Source: Zenodo 58985 (WannerAA201605_SkeletonsGlomeruli.zip, 101,187,739 bytes) | Publications: Wanner et al., 2016. Nat Neurosci 19:816-825; Sci Data 3:160100

syndb etl wanner2016 download --output-dir external_datasets/Wanner2016
syndb etl wanner2016 validate --data-dir external_datasets/Wanner2016

Platynereis dumerilii

Whole-body connectome of the marine annelid Platynereis dumerilii, a three-day-old larva with ~5,000 neurons.

Source: GitHub | Publication: Verasztó et al., 2024. bioRxiv

syndb etl platynereis download --output-dir external_datasets/Platynereis

syndb etl platynereis validate --data-dir external_datasets/Platynereis

syndb etl platynereis import \
  --data-dir external_datasets/Platynereis \
  --dataset-id <syndb-dataset-id> \
  --table neurons \
  --table synapses

Fish1 (Larval Zebrafish)

Larval zebrafish (Danio rerio) brain connectome. Data is accessed through CAVE and is currently classified as an explicitly configured local raw-stage source.

Note

Manual export

Fish1 raw staging requires CAVE API access with Google credentials in an approved staging deployment. The provider uploads the raw artifact; the hub worker performs validation, aggregation, and import.

Show the expected export layout (this does not download data):

syndb etl fish1 cave-instructions

Fish1 is currently classified as local raw-stage. In the explicitly configured raw-stage deployment, run syndb etl export fish1 with SYNDB_ETL_ALLOW_LOCAL_RAW_STAGE=1; the command must upload its artifact and cannot use --no-upload. Validation and import run only in the hub worker after the raw artifact is present there.


Multi-species Databases

L2/3 Cortex Dendrites (Loomba 2022)

Sampled layer 2/3 dendrites from volume EM of human, macaque and mouse cortex, imported as three datasets (loomba2022-human, loomba2022-macaque, loomba2022-mouse) that share one downloaded archive. Each dendrite row carries path length and spine count; the per-target synapse counts, synapse density and spine density are kept in row metadata. Dendrite owners with an annotated cell body become neurons (typed pyramidal or interneuron); fragments without a cell body are flagged unidentified. This is not a connectome: presynaptic partners are not identified and no synapse rows are imported.

Source: Edmond v1.0 (thesis_data.zip, 1.4 GB, CC0 1.0) | Publication: Loomba et al., 2022. Science 377:eabo0924

syndb etl loomba2022-human download --output-dir external_datasets/Loomba2022
syndb etl loomba2022-human validate --data-dir external_datasets/Loomba2022

Allen Cell Types

Reference electrophysiology and morphology data from the Allen Institute for Brain Science. Covers mouse and human cortical neuron types with standardized measurements.

Source: Allen Cell Types Database | API: Allen Brain Map API

syndb etl allen-cell-types download --output-dir external_datasets/AllenCellTypes

syndb etl allen-cell-types validate --data-dir external_datasets/AllenCellTypes

syndb etl allen-cell-types import \
  --data-dir external_datasets/AllenCellTypes \
  --dataset-id <syndb-dataset-id> \
  --table neurons

NeuroMorpho

Curated archive of digitally reconstructed neuron morphologies from NeuroMorpho.org. Contains 200,000+ reconstructions across 100+ species.

Source: NeuroMorpho.org | Publication: Ascoli et al., 2007. Journal of Neuroscience

syndb etl neuromorpho download --output-dir external_datasets/NeuroMorpho

syndb etl neuromorpho validate --data-dir external_datasets/NeuroMorpho

syndb etl neuromorpho import \
  --data-dir external_datasets/NeuroMorpho \
  --dataset-id <syndb-dataset-id> \
  --table neurons