Metadata-Version: 2.4
Name: octarine-navis-plugin
Version: 0.1.6
Summary: Octarine plugin to visualize NAVis data in 3D.
Home-page: https://github.com/navis-org/octarine-navis-plugin
Author: Philipp Schlegel
Author-email: pms70@cam.ac.uk
License: GPLv3
Project-URL: Documentation, https://github.com/navis-org/octarine-navis-plugin
Project-URL: Source, https://github.com/navis-org/octarine-navis-plugin
Project-URL: Changelog, https://github.com/navis-org/octarine-navis-plugin/releases
Keywords: octarine navis 3D visualization
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Octarine NAVis Plugin
This plugin enables [Octarine](https://github.com/schlegelp/octarine)
to visualize [NAVis](https://github.com/navis-org/navis) data such as skeletons, meshes,
volumes, etc.

## Installation

```bash
pip install octarine-navis-plugin -U
```

Note that you will have to install `Octarine` and `NAVis` separately!
This is intentional so that you can choose the install options
(e.g. the Window manager) yourself.

## Usage

The plugin will automatically be loaded alongside `Octarine` and extends the functionality by:

1. Allowing to pass `navis.Neuron/Lists`, `navis.Volumes` and `skeletor.Skeletons` to the generic `Viewer.add()` method.
2. Adding a dedicated `Viewer.add_neurons` method with various specialized parameters that shadow the options in `navis.plot3d`.

```python
import navis
import octarine as oc

# Initialize the viewer
v = oc.Viewer()

# Grab some neurons
n = navis.example_neurons(5, kind='mesh')

# Add them to the viewer
v.add(n)

# Alternatively use the specialized method with additional options
navis.strahler_index(n)
v.clear()
v.add_neurons(n, color_by='strahler_index', palette='viridis')
```

![example](_static/example_screenshot.png)
