How to cite¶

zarr-vectors-py¶

If you use zarr-vectors-py in research that leads to a publication, please cite the software repository:

@software{zarr_vectors_py,
  author       = {{BRIDGE Neuroscience}},
  title        = {{zarr-vectors-py: Python tools for the Zarr Vector Format}},
  year         = {2024},
  publisher    = {GitHub},
  url          = {https://github.com/BRIDGE-Neuroscience/zarr-vectors-py},
  note         = {Aligned to the Zarr Vectors specification by Forest Collman,
                  Allen Institute for Brain Sciences.
                  \url{https://github.com/AllenInstitute/zarr_vectors}}
}

The Zarr Vector Format specification¶

The ZVF format was originally specified by Forest Collman at the Allen Institute for Brain Sciences. Please also cite the upstream specification:

@misc{collman_zarr_vectors,
  author       = {Collman, Forest},
  title        = {{Zarr Vectors: a cloud-native format for spatial vector data}},
  year         = {2023},
  publisher    = {GitHub},
  url          = {https://github.com/AllenInstitute/zarr_vectors}
}

zv-ngtools¶

If you use the Neuroglancer integration (zv-ngtools) in your work:

@software{zv_ngtools,
  author       = {{BRIDGE Neuroscience}},
  title        = {{zv-ngtools: Neuroglancer integration for zarr-vectors}},
  year         = {2024},
  publisher    = {GitHub},
  url          = {https://github.com/BRIDGE-Neuroscience/zv-ngtools},
  note         = {Fork of ngtools by Yael Balbastre (neuroscales/ngtools).
                  \url{https://github.com/neuroscales/ngtools}}
}

Dependency citations¶

If your work uses specific functionality provided by upstream dependencies, please also cite:

Functionality	Cite
Zarr v3 storage	Zarr development team
OME-Zarr multiscale metadata	Moore et al., 2021
Draco mesh compression	Google Draco
TRX format ingest	TRX format
Neuroglancer viewer	Google Neuroglancer

Acknowledgement text¶

A suggested acknowledgement sentence for methods sections:

“Vector geometry data (streamlines / point clouds / skeletons) were stored and served using the Zarr Vector Format [Collman, 2023] as implemented in zarr-vectors-py [BRIDGE Neuroscience, 2024] and visualised using Neuroglancer [Google] via zv-ngtools [BRIDGE Neuroscience, 2024].”