plugin for cell segmentation
Project description
napari-cellseg3D: a napari plug-in for direct 3D cell segmentation with deep learning
A napari plugin for 3D cell segmentation: training, inference, and data review. In particular, this project was developed for analysis of mesoSPIM-acquired (cleared tissue + lightsheet) datasets.
News
June 2022: This is an alpha version, please expect bugs and issues, and help us make the code better by reporting them as an issue!
Installation
You can install napari-cellseg3d
via pip:
pip install napari-cellseg3d
Documentation
Available at https://AdaptiveMotorControlLab.github.io/CellSeg3d
You can also generate docs by running make html
in the docs folder.
Usage
To use the plugin, please run:
napari
Then go into Plugins > napari-cellseg3d, and choose which tool to use.
- Review: This module allows you to review your labels, from predictions or manual labeling, and correct them if needed. It then saves the status of each file in a csv, for easier monitoring.
- Inference: This module allows you to use pre-trained segmentation algorithms on volumes to automatically label cells and compute statistics.
- Train: This module allows you to train segmentation algorithms from labeled volumes.
- Utilities: This module allows you to perform several actions like cropping your volumes and labels dynamically, by selecting a fixed size volume and moving it around the image; computing prediction scores from ground truth and predicition labels; or converting labels from instance to segmentation and the opposite.
Requirements
Python >= 3.8 required
Requires pytorch and MONAI. For PyTorch, please see PyTorch's website for installation instructions. A CUDA-capable GPU is not needed but very strongly recommended, especially for training. If you get errors from MONAI regarding missing readers, please see MONAI's optional dependencies page for instructions on getting the readers required by your images.
Issues
If you encounter any problems, please file an issue along with a detailed description.
Testing
To run tests locally:
- Locally : run
pytest
in the plugin folder - Locally with coverage : In the plugin folder, run
coverage run --source=src -m pytest
thencoverage.xml
to generate a .xml coverage file. - With tox : run
tox
in the plugin folder (will simulate tests with several python and OS configs, requires substantial storage space)
Contributing
Contributions are very welcome.
Please ensure the coverage at least stays the same before you submit a pull request.
For local installation from Github cloning, please run:
pip install -e .
License
Distributed under the terms of the MIT license.
"napari-cellseg3d" is free and open source software.
Acknowledgements
This plugin was developed by Cyril Achard, Maxime Vidal, Mackenzie Mathis. This work was funded, in part, from the Wyss Center to the Mathis Laboratory of Adaptive Motor Control.
Plugin base
This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for napari-cellseg3d-0.0.1rc1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d153e70402da687196c29e374530ddf1df4828641aba7b4b950dc098ae910ed |
|
MD5 | 981e14f4b322db07485878b6a097df15 |
|
BLAKE2b-256 | 01ade4f1b6334f2914f379a2187ec66e8a6c6d2bfad4221dfff63df73c5046b7 |
Hashes for napari_cellseg3d-0.0.1rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5cc1e2b229adabafd81b4ee716e2a6bd5c70865335cc75f8e14d6cd7270a177a |
|
MD5 | 34535b44862bbb2d45973d1abe51a9ac |
|
BLAKE2b-256 | 25505822c94d27d8a3f61b8e319c6a4630819c588e5656de71a627daf097c78d |