Worked example: read a dataset page
Six steps, all in the browser, nothing to install. You will open one dataset and read how many neurons its table holds — then check that number against the manuscript, and see why it is not the textbook count.
We use C. elegans Whole Worm (White 1986), because its numbers are small enough to remember and the manuscript prints both the imported count and the anatomical one.
Step 1 — Open the app
Go to app.syndb.xyz. Signing in is optional for this path: dataset pages are public. You only need an account later, to run a query.
Step 2 — Open the dataset
The app opens on the Datasets tab, which lists the datasets in the corpus. Find C. elegans Whole Worm (White 1986) and open it, or go straight to its dataset page. Do not stop at C. elegans (Cook 2019) higher up the list: that is a different dataset, and its Neuron table has 302 rows.
Step 3 — Read the table row counts
The dataset page has a Tables and row counts panel. Each row is one table, the number of rows in it, and what one row represents. For this dataset:
| Table | Rows | Each row is |
|---|---|---|
| Neuron | 309 | a neuron |
A second row lists the Synapse table. Write down 309 for the Neuron table.
Step 4 — Compare with the manuscript
Supplementary Table S6 of the manuscript (Annotation and morphometry completeness per dataset; draft v1.1.1, shared with pilots, not yet public) lists, from the same 2026-11-13 snapshot:
- White whole worm: 309 (neuron rows)
- C. elegans (herm.): 302
The first row is this dataset; the second is the curated hermaphrodite connectome imported from a different source. Both are correct for what they count, and they do not agree.
Step 5 — Do not equate 309 with the anatomical count
309 is the number of rows in the imported neurons table, not the anatomical
neuron count of the animal. The canonical adult hermaphrodite has 302
neurons. The White 1986 import keeps the source’s node list unfiltered, so its
table carries the extra entries the source lists as well.
Never write “309 neurons” as a biological statement about C. elegans. When you report a table row count, say that it is a row count and name the dataset. When you need the anatomical count, use the curated dataset (302) or the original publication.
Step 6 — Keep the receipt
Record the dataset label, the dataset ID shown on the page, the table name and the row count. If you use the number in a paper, this is what a reader needs to check it; Citing SynDB has the citation entries.
Next: run a query (optional)
Running a query needs the academic account from Authentication. Press Query on the dataset page and replace the prefilled statement with the count:
SELECT COUNT(*) AS neurons
FROM neurons
WHERE dataset_id = '80eb5d36-5700-5914-a8dc-3a16109fc2b1'
Press Explain query, then Execute query. The job page shows the job
status; when it finishes it offers Download result, which is an Arrow IPC
file named after the job. The server writes the Arrow IPC stream format, so
open it with read_ipc_stream:
import polars as pl
rows = pl.read_ipc_stream("result.arrow")
Where to go next
- Tables, columns and units — the other columns, and the unit each one is in.
- SyQL reference — filters, grouping, materialised views.
- Citing SynDB — cite the dataset you just read.