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

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:

TableRowsEach row is
Neuron309a 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