napari-swc-editor 0.0.3

Use point and shape layer to edit swc format in napari

napari-swc-editor

Use point and shape layer to edit swc format in napari.

---

This napari plugin was generated with copier using the napari-plugin-template.

Features

https://github.com/user-attachments/assets/cba1820f-d0b5-436c-a981-62bae0e1a6ba

IO

READER

• Your .swc should follow the following specs: http://www.neuronland.org/NLMorphologyConverter/MorphologyFormats/SWC/Spec.html
• the reader will create 2 napari layer: point_layer and shape_layer. Only point_layer is interactive, shape_layer is used to render path between swc points.
• The raw swc can be accessed in the point layer metadata. Such as point_layer.metadata["raw_swc"]
• A pd.DataFrame object is also saved in the metadata: point_layer.metadata["swc_data"]

WRITER

• With the point_layer selected, you can use napari interface to save with .swc extension name.
• You can also do it in command line: napari.save_layers('test.swc', [point_layer])

Napari Interface

Structure ID and point symbol

In swc, structure id allow to label the type of neuron structure the point belongs to. In this plugin by default, the points will follow this symbol mapping:

SWC_SYMBOL = {
    0: "clobber",  # undefined
    1: "star",  # soma
    2: "disc",  # axon
    3: "triangle_down",  # basal dendrite
    4: "triangle_up",  # apical dendrite
}

SWC Edition

ALL INTERACTIONS ARE ONLY BOUND TO THE point_layer THERE IS NO CTRL-Z (please save your progress)

• Add point: You can edit the "r" and the "structure_id" using the point_size and symbol
• Remove point: (Select the point and press 1 or suppr or delete) All the link pointing to this point will be removed
• Add edge: Select 2 or more point(s) and press on your keyboard l (aka: link).
• Remove edge: Select 1 or more point(s) and press on your keyboard u (aka: unlink).

Installation

You can install napari-swc-editor via pip:

pip install napari-swc-editor

To install latest development version :

pip install git+https://github.com/LaboratoryOpticsBiosciences/napari-swc-editor.git

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the BSD-3 license, "napari-swc-editor" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.