A reference of abbreviations, acronyms, and domain-specific language used throughout this project.
Term Definition
Collection A curated grouping of datasets for organizational or meta-analysis purposes. See Collections & Tags .
Compartment A structural subdivision of a neuron that maps to a SynDB table.
Dataset A collection of neuroanatomical measurements sharing species, brain region, microscopy, and other metadata.
ETL Extract, Transform, Load: imports external datasets into SynDB’s schema. See External sources .
Provenance The audit trail tracking who created, modified, or derived from a dataset. See Provenance & Citations .
SyQL SynDB Query Language: a declarative SQL-like language resolving dataset metadata into optimized ClickHouse queries. See SyQL .
Table A typed schema corresponding to a neuronal compartment, with its own column definitions.
Term Definition
Connectome A comprehensive map of neural connections in a nervous system. Background .
Neuron An electrically excitable cell that communicates via synapses; identified by neuron_id. CL:0000540 .
Synapse A junction between neurons where signals are transmitted chemically or electrically. GO:0045202 .
Axon Projection conducting electrical impulses away from the cell body. GO:0030424 .
Dendrite Branched projection receiving signals. GO:0030425 .
Soma Cell body of a neuron
Bouton Terminal bulb of an axon (pre-synaptic ending)
Pre-synaptic terminal Output side of a synapse; releases neurotransmitters. GO:0098793 .
Post-synaptic terminal Input side of a synapse; receives neurotransmitters
Dendritic spine Small dendritic protrusion forming the postsynaptic side of most excitatory synapses. GO:0043197 .
Synaptic cleft Gap between pre- and post-synaptic terminals
Vesicle Membrane-bound compartment containing neurotransmitters in the pre-synaptic terminal. GO:0099503 .
Active zone (AZ) Specialized region of the pre-synaptic terminal where vesicles fuse and release neurotransmitter
Mitochondria Organelles responsible for ATP production. GO:0005739 .
Endoplasmic reticulum (ER) Intracellular membrane system involved in protein synthesis
Nucleus Cell nucleus containing DNA
Neuropil Dense neural tissue composed of intertwined axons, dendrites, and synapses
Connection strength Synaptic weight or efficacy between two neurons
Cleft score Predicted confidence of a synaptic cleft detection
Term Definition
Cell type Classification by morphology, connectivity, molecular markers, or electrophysiology (e.g., Pyramidal, Purkinje, Basket).
Cell class Higher-level grouping of neuron types
Cell subclass Subdivision within a cell class
Polarity Morphological arrangement of neuronal processes: Unipolar, Bipolar, Multipolar, Pseudounipolar, Anaxonic
A neurotransmitter is a chemical substance released at a synapse to transmit signals.
Abbreviation Full Name
GABA Gamma-aminobutyric acid (primary inhibitory neurotransmitter)
Glutamate Primary excitatory neurotransmitter
ACh Acetylcholine
5-HT Serotonin (5-hydroxytryptamine)
Dopamine Monoamine neurotransmitter
Norepinephrine Noradrenaline; monoamine neurotransmitter
Octopamine Invertebrate monoamine neurotransmitter
An anatomical or functional subdivision of the brain. SynDB uses terms from
the UBERON multi-species anatomy ontology.
Term Definition
CA1, CA3 Sub-regions of the hippocampus (Cornu Ammonis)
DG Dentate gyrus (hippocampal region)
V1 Primary visual cortex
M1 Primary motor cortex
S1 Primary somatosensory cortex
PFC Prefrontal cortex
Mushroom body Learning/memory center in insect brains (Drosophila)
Antennal lobe Olfactory processing center in insect brains
Term Meaning
Anterior / Posterior Front / back
Dorsal / Ventral Top / bottom
Lateral / Medial Side / center
Rostral / Caudal Toward the nose / toward the tail
Proximal / Distal Close to / far from the soma
Term Definition
Cable length Total length of a neuronal skeletal reconstruction (axon or dendrite). Stored in the source’s unit — micrometres for FlyWire and mesh-connectomics; see Tables, columns and units .
Mesh volume Volume of a 3D-reconstructed neuronal mesh
Sphericity / Mesh sphericity How sphere-like a shape or mesh is (0–1; 1 is a perfect sphere).
N_branches Number of branching points in a neuronal arbor
Centroid Spatial center point (X, Y, Z) of a structure
Abbreviation Full Name
EM Electron microscopy
SEM Scanning electron microscopy
TEM Transmission electron microscopy
SBEM Serial block-face electron microscopy
FIB-SEM Focused ion beam scanning electron microscopy
STED Stimulated emission depletion microscopy
PALM Photo-activated localization microscopy
STORM Stochastic optical reconstruction microscopy
CLEM Correlative light and electron microscopy
SIM Structured illumination microscopy
Confocal Confocal laser scanning microscopy
Two-photon Two-photon excitation microscopy
Term Definition
Knock-out (KO) Complete deletion of a gene
Knock-in (KI) Insertion of a transgene
Knock-down (KD) Reduction of gene expression
Overexpression Artificially increased gene expression
Scientific Name Common Name
Drosophila melanogaster Fruit fly
Mus musculus Mouse
Rattus norvegicus Rat
Caenorhabditis elegans Nematode worm
Danio rerio Zebrafish
Name Description
FlyWire Google’s full Drosophila brain connectome
Hemibrain Janelia’s Drosophila brain hemisphere connectome (via neuPrint)
MANC Male Adult Nervous System Connectome (Drosophila )
neuPrint FlyEM’s connectome query and database system
Term Definition
NWB Neurodata Without Borders — standardized neuroscience data format
BIDS Brain Imaging Data Structure — standardized neuroimaging format
HDF5 Hierarchical Data Format 5 — container format used by NWB
Apache Arrow In-memory columnar data format for efficient analytics and transfer
Arrow IPC Arrow inter-process communication serialization format
Arrow Flight Apache Arrow’s gRPC protocol for streaming columnar data (default port 50051).
Parquet Columnar on-disk storage format
Feather Lightweight Arrow-native file format
DOI Digital Object Identifier (e.g., 10.1038/...); uniquely identifies publications
SWB Spatial Web Bundle — volumetric data format for neuroscience
Abbreviation Full Name
CC0 Creative Commons Zero (public domain)
CC-BY Creative Commons Attribution
CC-BY-SA Creative Commons Attribution-ShareAlike
CC-BY-NC Creative Commons Attribution-NonCommercial
CC-BY-NC-SA Creative Commons Attribution-NonCommercial-ShareAlike
PDDL Public Domain Dedication and License
ODC-BY Open Data Commons Attribution
ODC-ODbL Open Data Commons Open Database License
Term Definition
DiGraph Directed graph (via the petgraph library)
In-degree Number of incoming connections to a node
Out-degree Number of outgoing connections from a node
Reciprocity Proportion of bidirectional edges in the graph
Density Ratio of actual edges to maximum possible edges
SCC Strongly connected component — maximal subgraph where every node is reachable from every other
Hub neuron Highly connected central node in the connectome
Triadic census Count of all 16 possible directed 3-node subgraph (motif) types.
Feed-forward motif A → B → C with A → C
Convergent motif A → C, B → C (shared target)
Divergent motif A → B, A → C (shared source)
Cyclic motif A → B → C → A loop
Reciprocal motif Bidirectional pair A ↔ B
Reachability Set of nodes reachable within N hops (BFS)
Shortest path Minimum-weight path between two nodes (Dijkstra)
Term Definition
Meta-analysis Statistical method combining results across multiple datasets
Effect size Standardized measure of the magnitude of an observed effect
Heterogeneity Variation in results across studies
Z-score Number of standard deviations a value is from the mean
Forest plot Visualization showing effect sizes and confidence intervals across studies
GroupSummaryStats Per-group statistics: count (n), mean, standard deviation, variance, quantiles
Metric Measurable quantity — Volume, SurfaceArea, CableLength, MeshVolume, MeshSphericity, NBranches, Strength, SynapseCount
GroupingDimension Aggregation level — Species, BrainStructure, CellType, Cluster, Dataset
Term Definition
ClickHouse Columnar OLAP database optimized for real-time analytics
MergeTree ClickHouse table engine with automatic background merging of data parts
ReplicatedMergeTree MergeTree with replication support
AggregatingMergeTree MergeTree engine that stores pre-aggregated states
Materialized view (MV) Pre-aggregated data maintained on insert; eligible SyQL queries can be rewritten to use it.
Trigger view Inserts that populate a materialized view’s target table
-Merge combinatorsClickHouse functions that finalize aggregate states (countMerge(), avgMerge(), stddevPopMerge())
Low cardinality ClickHouse column encoding for categorical/enum-like data
DateTime64(3) Millisecond-precision timestamp type
Enum8 / Enum16 ClickHouse enumeration types (8-bit / 16-bit)
OPTIMIZE TABLE FINAL Forces consolidation of all data parts in a MergeTree table
Pre-Merge / Post-Merge Query timing relative to an OPTIMIZE TABLE FINAL operation
JSONEachRow ClickHouse format: one JSON object per line
RowBinary ClickHouse compact binary row format
Shard Horizontal partition of a ClickHouse cluster
Replica Redundant copy of a shard for fault tolerance
remoteSecure()ClickHouse function for querying remote clusters over TLS
Keeper ClickHouse Keeper — ZooKeeper-compatible coordination service built into ClickHouse
ID Table
1 Neuron
2 NeuronRelation
3 Dendrite
4 Axon
5 PreSynapticTerminal
6 Synapse
7 DendriticSpine
8 EndoplasmicReticulum
9 Nucleus
10 Vesicle
11 Mitochondria
Term Definition
PASETO Platform-Agnostic Security Tokens — used instead of JWT for session tokens (v4.local)
OAuth / OAuth2 Open Authorization protocol for delegated access
ORCID Open Researcher and Contributor ID — persistent digital identifier for researchers
CILogon Federated identity provider for academic/research institutions
Academic verification Identity verification via CILogon institutional login, required for compute-intensive operations.
Fernet Symmetric encryption scheme (used for encrypting federation passwords)
Argon2 Memory-hard password hashing function
SOPS Secrets OPerationS — tool for encrypting YAML/JSON secrets files
Term Definition
Federation Distributed queries across institutions while each retains control of its data. See Federation overview .
Hub Central SynDB node that coordinates federation
Cluster Named remote ClickHouse instance registered with the hub
Node Individual federation member running ClickHouse and syndb-node; data stays on its infrastructure.
Delegation Routing a query to the remote cluster that owns the requested dataset
Locality index Mapping from dataset IDs to the cluster where they reside
libp2p Peer-to-peer networking library used for federation communication
Swarm libp2p network of connected peers
DHT Distributed Hash Table — used for peer discovery and actor registration
mDNS Multicast DNS — local network service discovery
multiaddr libp2p multi-address format encoding transport + address
piying Rust actor framework for async message-passing (a Kameo fork)
Actor Autonomous async agent in the piying system
ActorRef / RemoteActorRef Handle to a local or remote actor
papaya Lock-free concurrent hash map library
Cluster health Status enum: Healthy, Degraded, Unreachable, Unknown
Schema sync Protocol for distributing ClickHouse DDL across federation clusters
Term Definition
S3 Amazon Simple Storage Service, or an S3-compatible service such as Ceph RGW
Presigned URL Temporary, time-limited URL granting direct S3 access
Rook Ceph Kubernetes-native distributed storage (backs S3 in production)
Bucket Contents
syndb-mesh3D neuronal mesh/geometry files
syndb-swbSpatial Web Bundle data
syndb-searchSearch index data
syndb-jobsJob queue results and state
Validated string wrappers used throughout the codebase:
Type Validation Rule
Email Must contain @
Doi Must start with 10.
CountryCode ISO 3166-1 alpha-2 (two uppercase letters)
ClusterName Non-empty string
GroupName Non-empty string
ScientistTag Format prefix#NNNN (e.g., alice#0042)
DatabaseName Non-empty string
DatasetLabel Non-empty human-readable dataset name
CollectionName Non-empty dataset collection name
Term Definition
Axum Rust async web framework (HTTP API on port 8080)
tonic Rust gRPC framework (Arrow Flight on port 50051)
gRPC Google Remote Procedure Call framework over HTTP/2
REST Representational State Transfer
CORS Cross-Origin Resource Sharing
OpenAPI API specification standard (generated via utoipa)
utoipa Rust library for generating OpenAPI/Swagger documentation
Operation Purpose
DoGet Download data (streaming RecordBatches)
DoPut Upload data
DoAction Execute a named action (e.g., HEALTH, DELETE_DATASET, JOB_STATUS)
DoExchange Bidirectional streaming
FlightDescriptor Request metadata identifying the resource
Ticket Opaque token the client presents to retrieve data
RecordBatch Arrow columnar data chunk
Term Definition
Job Asynchronous query or graph-analysis task. See Jobs system .
Job status Lifecycle: Pending → Running → Completed / Failed / Cancelled
Job kind Query (SQL) or GraphAnalysis
Query scope Local (hub only), Remote (single cluster), or Federation (multi-cluster)
Saved query User-persisted SQL template with name and description
Term Definition
Nix Declarative, reproducible package manager and build system
Flake Nix flake — reproducible project environment definition
Helm Kubernetes package manager for deploying charts
OpenTofu (tofu) Infrastructure-as-code tool (open-source Terraform fork)
Nautilus National Research Platform (NRP) Kubernetes cluster used for production
CHI ClickHouseInstallation — Altinity operator custom resource for ClickHouse on K8s
Spilo Zalando’s PostgreSQL high-availability container (runs with patroni + etcd)
cert-manager Kubernetes add-on for automated TLS certificate provisioning
Term Definition
Cargo Rust package manager and build tool
Workspace Cargo workspace — monorepo containing multiple crates
Crate A Rust compilation unit / package
Clippy Rust linter
nextest Parallel Rust test runner (replaces cargo test)
taplo TOML formatter and linter
SeaORM Async Rust ORM for relational databases
Figment Configuration merging library (env + files + defaults)
Serde Rust serialization/deserialization framework
Strum Derive macros for enum ↔ string conversions
Secrecy Zero-copy wrapper for secret values (prevents accidental logging)
petgraph Graph data structure and algorithm library
tokio Async runtime for Rust
Dioxus Rust web framework used for the SynDB server-rendered UI
LTO Link-Time Optimization — compiler optimization across crate boundaries
Term Definition
FastAPI Python async web framework
Pydantic Python data validation via type annotations
Polars High-performance DataFrame library (alternative to pandas)
PyArrow Python bindings for Apache Arrow
httpx Async Python HTTP client
WebDriver Browser protocol used by the Rust end-to-end contract tests
Term Definition
Scale tier Dataset size for benchmarks: 100k, 1M, 10M, 100M rows
Query mode Execution context: PreMerge, PostMerge, MaterializedView
Lab profile Simulated research lab with specific measurement biases and annotation completeness
Volume bias Multiplicative factor simulating measurement accuracy
Annotation completeness Fraction (0.0–1.0) of objects detected in a dataset
Criterion Rust micro-benchmarking harness
Format Description
JSON JavaScript Object Notation
YAML YAML Ain’t Markup Language (config files)
TOML Tom’s Obvious Minimal Language (Cargo.toml, settings)
MessagePack Compact binary serialization
LZ4 Fast compression algorithm
zstd Zstandard compression (used by ClickHouse)
Variable Purpose
DEV_MODEEnables development-mode defaults
TESTINGActivates test-mode configuration
REQUIRE_AUTHENTICATIONEnforces OAuth login
PASSLIB_SECRETPASETO token signing key
FERNET_KEYSFederation password encryption keys
FEDERATION_CLUSTER_NAMEThis node’s federation identity
FLIGHT_PORTArrow Flight gRPC port (default 50051)
S3_ENDPOINT_URLS3-compatible endpoint
S3_PUBLIC_ENDPOINT_URLPublicly accessible S3 endpoint
OA_{GITHUB,GOOGLE,ORCID,CILOGON}_ID/SECRETOAuth provider credentials