Analytics

Pre-computed analytics endpoints for dataset exploration. These query ClickHouse materialized views and return results quickly (cached for 5 minutes).

Requires Academic verification.

Dataset Summary

Row counts per compartment type:

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.syndb.xyz/v1/analytics/summary?dataset_ids=uuid1,uuid2"

Returns per-dataset table counts plus total_rows.

Neuron Morphometrics

Morphological statistics for neurons in a dataset:

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.syndb.xyz/v1/analytics/morphometrics?dataset_ids=uuid1,uuid2"

Returns per-dataset means and standard deviations for metrics such as cable length, surface area, volume, mesh volume, mesh sphericity, and branch counts.

Z-Score Comparison

Standardized comparison of a metric across multiple datasets:

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.syndb.xyz/v1/analytics/comparison?dataset_ids=uuid1,uuid2,uuid3&metric=mesh_volume"

Omit metric to return the current six-metric neuron morphometrics comparison; include metric to request a single z-score series.

Graph Summary

Network-level statistics for connectome datasets:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/analytics/graph/{dataset_id}/summary

Returns neuron_count, edge_count, density, and avg_strength.

Reciprocity

Fraction of bidirectional synaptic connections:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/analytics/graph/{dataset_id}/reciprocity

Degree Distribution

Top neurons by connectivity:

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.syndb.xyz/v1/analytics/graph/{dataset_id}/degree-distribution?top_k=50"

Returns the top top_k neurons with in-degree, out-degree, and average inbound and outbound strength.