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

Citing SynDB

Cite the platform and every dataset you used. Datasets must be cited individually: SynDB is the host, not the author of the measurements.

Citing the platform

The SynDB manuscript is in preparation and has no DOI yet. Until it is published, cite the software, whose metadata lives in CITATION.cff:

@software{syndb,
  title        = {SynDB: A Cloud-Native Decentralized Platform for Connectomics Data},
  author       = {Tartanoglu, Can Hicabi and Ellisman, Mark H. and Boassa, Daniela
                  and Viana da Silva, Silvia and Haberl, Matthias},
  version      = {0.11.0},
  year         = {2026},
  url          = {https://github.com/memorycircuits/SynDB},
  license      = {Apache-2.0},
  note         = {Manuscript in preparation; DOI pending}
}

Once the article appears, cite the article instead of the software entry, and keep the software entry only if you need to pin the version you ran. Record the version or image tag in your methods section either way, because table schemas and query results change between releases.

Authors, version and release date in that entry come from CITATION.cff at the time of writing. Check the file before submitting; it is the source of truth.

Citing a dataset

Each dataset page has a citation panel with its DOI and licence. The API generates the full reference formats a manager wants:

curl "https://api.syndb.xyz/v1/neurodata/datasets/676f5945-b47e-5ed9-9279-401342059449/citation?format=bibtex"
curl "https://api.syndb.xyz/v1/neurodata/datasets/676f5945-b47e-5ed9-9279-401342059449/citation?format=ris"

Formats: bibtex, ris, csl-json, cff. Without format, the endpoint returns an APA-style string. Output for Hemibrain v1.2.1:

@misc{syndb_676f5945b47e5ed99279401342059449,
  title = {Hemibrain v1.2.1},
  publisher = {SynDB},
  year = {2026},
  url = {https://api.syndb.xyz/v1/neurodata/datasets/676f5945-b47e-5ed9-9279-401342059449},
  license = {CC-BY-4.0},
  species = {Drosophila melanogaster}
}

That entry credits the dataset as hosted. It does not replace the original publication. Where the dataset metadata records a source DOI, cite that paper too; the data-use page lists which datasets have one recorded. A method statement that only cites SynDB cannot be checked by a reader, and some licences require the original attribution.

What to write in the methods

For reproducibility, state:

  1. the SynDB release or image tag,
  2. the dataset IDs you queried,
  3. the full query text,
  4. the date you ran it,
  5. the exported result file.

Do not cite a saved-query ID or a job ID as the record. Both belong to the account that created them: other users cannot open them, and rerunning either reads whatever the tables hold that day. The query text and the exported file are the reproducible artefacts. Saved queries and their runs are still useful for your own history; see Saved queries and Jobs.

Licence of the platform itself

The SynDB source code is Apache-2.0. That licence covers the software, not the data it serves. Data licences are per dataset; see Data-use terms.