[](https://github.com/guiwitz/napari-convpaint/raw/main/LICENSE)
[](https://pypi.org/project/napari-convpaint)
[](https://python.org)
[](https://github.com/guiwitz/napari-convpaint/actions)
[](https://codecov.io/gh/guiwitz/napari-convpaint)
[](https://napari-hub.org/plugins/napari-convpaint)

This napari plugin can be used to segment objects or structures in images based on a few brush strokes providing examples of the classes. Based on the same idea as other tools like ilastik, its main strength is that it can use features from pretrained neural networks like VGG16 or DINOV2, enabling the segmentation of more complex images.
**Find more information and tutorials in the [docs](https://guiwitz.github.io/napari-convpaint/) or read the [preprint](https://doi.org/10.1101/2024.09.12.610926).**

## Installation
You can install `napari-convpaint` via [pip]
pip install napari-convpaint
To install latest development version :
pip install git+https://github.com/guiwitz/napari-convpaint.git
## Example use case: Tracking shark body parts in a movie
These are the scribble annotations provided for training:

And this is the resulting Convpaint segmentation:
<video src="https://github.com/user-attachments/assets/6a2be1fe-25cc-4af1-9f50-aab9bc4123d9"></video>
Check out the documentation or the paper for more usecases!
## License
Distributed under the terms of the [BSD-3] license,
"napari-convpaint" is free and open source software
## 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.
## Issues
If you encounter any problems, please [file an issue] along with a detailed description.
[napari]: https://github.com/napari/napari
[Cookiecutter]: https://github.com/audreyr/cookiecutter
[@napari]: https://github.com/napari
[MIT]: http://opensource.org/licenses/MIT
[BSD-3]: http://opensource.org/licenses/BSD-3-Clause
[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt
[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt
[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0
[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt
[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin
[file an issue]: https://github.com/guiwitz/napari-convpaint/issues
[napari]: https://github.com/napari/napari
[tox]: https://tox.readthedocs.io/en/latest/
[pip]: https://pypi.org/project/pip/
[PyPI]: https://pypi.org/
## Authors
The idea behind this napari plugin was first developed by [Lucien Hinderling](https://hinderling.github.io) in the group of [Olivier Pertz](https://www.pertzlab.net/), at the Institute of Cell Biology, University of Bern. The code has first been shared as open source resource in form of a [Jupyter Notebook](https://github.com/hinderling/napari_pixel_classifier). With the desire to make this resource accessible to a broader public in the scientific community, the Pertz lab obtained a CZI napari plugin development grant with the title ["Democratizing Image Analysis with an Easy-to-Train Classifier"](https://chanzuckerberg.com/science/programs-resources/imaging/napari/democratizing-image-analysis-with-an-easy-to-train-classifier/) which supported the adaptation of the initial concept as a napari plugin called napari-convpaint. The plugin has been developed by [Guillaume Witz](https://guiwitz.github.io/blog/about/), Mykhailo Vladymyrov and Ana Stojiljkovic at the [Data Science Lab](https://www.dsl.unibe.ch/), University of Bern, in tight collaboration with the Pertz lab (Lucien Hinderling, [Roman Schwob](https://github.com/quasar1357), [Benjamin Gräedel](https://x.com/benigraedel), [Maciej Dobrzyński](https://macdobry.net)).
## Cite Convpaint
If you find Convpaint useful in your research, please consider citing:
```
@article {Hinderling2024.09.12.610926,
author = {Hinderling, Lucien and Witz, Guillaume and Schwob, Roman and Stojiljkovic, Ana and Dobrzynski, Maciej and Vladymyrov, Mykhailo and Frei, Joel and Graedel, Benjamin and Frismantiene, Agne and Pertz, Olivier},
title = {Convpaint - Universal framework for interactive pixel classification using pretrained neural networks},
year = {2024},
doi = {10.1101/2024.09.12.610926},
URL = {https://www.biorxiv.org/content/early/2024/09/14/2024.09.12.610926},
journal = {bioRxiv}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/guiwitz/napari-convpaint",
"name": "napari-convpaint",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "napari, plugin, segmentation, machine learning, deep learning, image analysis, neural networks",
"author": "Guillaume Witz",
"author_email": "guillaume.witz@unibe.ch",
"download_url": "https://files.pythonhosted.org/packages/e7/11/7349930da0feed60a162e816a023e63159864e07ecb93e422e113ba1939d/napari_convpaint-0.6.0.tar.gz",
"platform": null,
"description": "\n[](https://github.com/guiwitz/napari-convpaint/raw/main/LICENSE)\n[](https://pypi.org/project/napari-convpaint)\n[](https://python.org)\n[](https://github.com/guiwitz/napari-convpaint/actions)\n[](https://codecov.io/gh/guiwitz/napari-convpaint)\n[](https://napari-hub.org/plugins/napari-convpaint)\n\n\n\n\nThis napari plugin can be used to segment objects or structures in images based on a few brush strokes providing examples of the classes. Based on the same idea as other tools like ilastik, its main strength is that it can use features from pretrained neural networks like VGG16 or DINOV2, enabling the segmentation of more complex images.\n\n**Find more information and tutorials in the [docs](https://guiwitz.github.io/napari-convpaint/) or read the [preprint](https://doi.org/10.1101/2024.09.12.610926).**\n\n\n\n\n## Installation\n\nYou can install `napari-convpaint` via [pip]\n\n pip install napari-convpaint\n\nTo install latest development version :\n\n pip install git+https://github.com/guiwitz/napari-convpaint.git\n\n\n## Example use case: Tracking shark body parts in a movie\nThese are the scribble annotations provided for training:\n\n\nAnd this is the resulting Convpaint segmentation:\n<video src=\"https://github.com/user-attachments/assets/6a2be1fe-25cc-4af1-9f50-aab9bc4123d9\"></video>\n\nCheck out the documentation or the paper for more usecases!\n\n## License\n\nDistributed under the terms of the [BSD-3] license,\n\"napari-convpaint\" is free and open source software\n\n## Contributing\n\nContributions are very welcome. Tests can be run with [tox], please ensure\nthe coverage at least stays the same before you submit a pull request.\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n[napari]: https://github.com/napari/napari\n[Cookiecutter]: https://github.com/audreyr/cookiecutter\n[@napari]: https://github.com/napari\n[MIT]: http://opensource.org/licenses/MIT\n[BSD-3]: http://opensource.org/licenses/BSD-3-Clause\n[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt\n[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt\n[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0\n[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt\n[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin\n\n[file an issue]: https://github.com/guiwitz/napari-convpaint/issues\n\n[napari]: https://github.com/napari/napari\n[tox]: https://tox.readthedocs.io/en/latest/\n[pip]: https://pypi.org/project/pip/\n[PyPI]: https://pypi.org/\n\n## Authors\n\nThe idea behind this napari plugin was first developed by [Lucien Hinderling](https://hinderling.github.io) in the group of [Olivier Pertz](https://www.pertzlab.net/), at the Institute of Cell Biology, University of Bern. The code has first been shared as open source resource in form of a [Jupyter Notebook](https://github.com/hinderling/napari_pixel_classifier). With the desire to make this resource accessible to a broader public in the scientific community, the Pertz lab obtained a CZI napari plugin development grant with the title [\"Democratizing Image Analysis with an Easy-to-Train Classifier\"](https://chanzuckerberg.com/science/programs-resources/imaging/napari/democratizing-image-analysis-with-an-easy-to-train-classifier/) which supported the adaptation of the initial concept as a napari plugin called napari-convpaint. The plugin has been developed by [Guillaume Witz](https://guiwitz.github.io/blog/about/), Mykhailo Vladymyrov and Ana Stojiljkovic at the [Data Science Lab](https://www.dsl.unibe.ch/), University of Bern, in tight collaboration with the Pertz lab (Lucien Hinderling, [Roman Schwob](https://github.com/quasar1357), [Benjamin Gr\u00e4edel](https://x.com/benigraedel), [Maciej Dobrzy\u0144ski](https://macdobry.net)).\n\n## Cite Convpaint\n\nIf you find Convpaint useful in your research, please consider citing:\n```\n@article {Hinderling2024.09.12.610926,\n\tauthor = {Hinderling, Lucien and Witz, Guillaume and Schwob, Roman and Stojiljkovic, Ana and Dobrzynski, Maciej and Vladymyrov, Mykhailo and Frei, Joel and Graedel, Benjamin and Frismantiene, Agne and Pertz, Olivier},\n\ttitle = {Convpaint - Universal framework for interactive pixel classification using pretrained neural networks},\n\tyear = {2024},\n\tdoi = {10.1101/2024.09.12.610926},\n\tURL = {https://www.biorxiv.org/content/early/2024/09/14/2024.09.12.610926},\n\tjournal = {bioRxiv}\n}\n```\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "A plugin for segmentation by pixel classification using pre-trained neural networks for feature extraction",
"version": "0.6.0",
"project_urls": {
"Bug Tracker": "https://github.com/guiwitz/napari-convpaint/issues",
"Documentation": "https://github.com/guiwitz/napari-convpaint#README.md",
"Homepage": "https://github.com/guiwitz/napari-convpaint",
"Source Code": "https://github.com/guiwitz/napari-convpaint",
"User Support": "https://github.com/guiwitz/napari-convpaint/issues"
},
"split_keywords": [
"napari",
" plugin",
" segmentation",
" machine learning",
" deep learning",
" image analysis",
" neural networks"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1fd3f045a1969b062aa71f7622b020712d54adb27653b4db06c69433aeba20da",
"md5": "c6c840728e4dd5fcbc15da3e3ea3fbf9",
"sha256": "0d73657e1e34bb8d40d1af72114f1f99845d28236a78cec050f9ac5142ab1954"
},
"downloads": -1,
"filename": "napari_convpaint-0.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6c840728e4dd5fcbc15da3e3ea3fbf9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 46626,
"upload_time": "2025-01-24T13:02:44",
"upload_time_iso_8601": "2025-01-24T13:02:44.830992Z",
"url": "https://files.pythonhosted.org/packages/1f/d3/f045a1969b062aa71f7622b020712d54adb27653b4db06c69433aeba20da/napari_convpaint-0.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e7117349930da0feed60a162e816a023e63159864e07ecb93e422e113ba1939d",
"md5": "8d6c2aa250f5bf1a8bb3210ec7b39bf6",
"sha256": "9cd3ef69e48a4231fc7293f8835b3d4cf86d8ae2c26dc990d51e925237acd770"
},
"downloads": -1,
"filename": "napari_convpaint-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "8d6c2aa250f5bf1a8bb3210ec7b39bf6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 17384712,
"upload_time": "2025-01-24T13:02:47",
"upload_time_iso_8601": "2025-01-24T13:02:47.701054Z",
"url": "https://files.pythonhosted.org/packages/e7/11/7349930da0feed60a162e816a023e63159864e07ecb93e422e113ba1939d/napari_convpaint-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-24 13:02:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "guiwitz",
"github_project": "napari-convpaint",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "napari-convpaint"
}