NAVis is a Python 3 library for Neuron Analysis and Visualization.
NAVis is on ReadTheDocs.
- polyglot: work and convert between neuron skeletons, meshes, dotprops and images
- visualize: 2D (matplotlib) and 3D (vispy, plotly or k3d)
- process: skeletonization, meshing, smoothing, repair, downsampling, etc.
- morphometrics: Strahler analysis, cable length, volume, tortuosity and more
- similarity: compare & cluster by morphology (e.g. NBLAST, persistence or form factor) or connectivity metrics
- transform: move data between template brains (built-in support for HDF5, CMTK, Elastix and landmark-based transforms)
- interface: load neurons directly from neuPrint, neuromorpho.org and other data sources
- model neurons and networks using the NEURON simulator
- render: use Blender 3D for high quality visualizations
- R neuron libraries: interfaces with nat, rcatmaid, elmr and more
- import-export: read/write SWCs, neuroglancer's "precomputed" format, NMX/NML, NRRD, mesh-files and more
- fast: uses functions compiled in Rust under-the-hood (see fastcore)
- scalable: out-of-the-box support for multiprocessing
- extensible: build your own package on top of navis - see pymaid for example
See the documentation for detailed installation instructions, tutorials and examples. For the impatient:
pip3 install 'navis[all]'
which includes all optional extras providing features and/or performance improvements.
Currently, this is
igraph
,
navis-fastcore
,
pathos
,
shapely
,
kdtree
,
hash
,
flybrains
,
cloudvolume
,
meshes
,
and vispy-default
.
3D plotting from a python REPL is provided by vispy
, which has a choice of backends.
Different backends work best on different combinations of hardware, OS, python distribution, and REPL, so there may be some trial and error involved.
vispy
's backends are listed here, and each can be installed as a navis extra, e.g. pip3 install 'navis[vispy-pyqt6]'
.
Questions on how to use navis
are best placed in discussions. Same goes for cool projects or analyses you made using navis
-
we'd love to hear from you!
A summary of changes can be found here.
NAVis comes with batteries included but is also highly extensible. Some libraries built on top of NAVis:
- flybrains provides templates and transforms for Drosophila brains to use with navis
- pymaid pulls and pushes data from/to CATMAID servers
- fafbseg contains tools to work with auto-segmented data for the FAFB EM dataset including FlyWire
NAVis has been used in a range of neurobiological publications. See here for a list.
We have implemented various published algorithms and methods:
- NBLAST: Comparison of neurons based on morphology (Costa et al., 2016)
- Vertex Similarity: Comparison of neurons based on connectivity (Jarrell et al., 2012)
- Comparison of neurons based on synapse distribution (Schlegel et al., 2016)
- Synapse flow centrality for axon-dendrite splits (Schneider-Mizell et al., 2016)
Working on your own cool new method? Consider adding it to NAVis!
We'd love to know if you found NAVis useful for your research! You can help us
spread the word by citing the DOI provided by Zenodo
This code is under GNU GPL V3.
NAVis is inspired by and inherits much of its design from the excellent natverse R packages by Greg Jefferis, Alex Bates, James Manton and others.
Want to contribute? Great, here is how!
Open an issue. For bug reports please make sure to include some code/data with a minimum example for us to reproduce the bug.
We're always happy for people to contribute code - be it a small bug fix, a new feature or improved documentation.
Here's how you'd do it in a nutshell:
- Fork this repository
git clone
it to your local machine- Install the full development dependencies with
pip install -r requirements.txt
- Install the package in editable mode with
pip install -e ".[all]"
- Create,
git add
,git commit
,git push
, and pull request your changes.
Run the tests locally with pytest -v
.
Docstrings should use the numpydoc format,
and make sure you include any relevant links and citations.
Unit tests should be doctests
and/or use pytest in the ./tests
directory.
Doctests have access to the tmp_dir: pathlib.Path
variable,
which should be used if any files need to be written.
Feel free to get in touch either through an issue or discussion if you need pointers or input on how to implement an idea.