# StarDist OPP napari plugin
[](https://github.com/gatoniel/napari-merge-stardist-masks/raw/main/LICENSE)
[](https://pypi.org/project/napari-merge-stardist-masks)
[](https://python.org)
[](https://github.com/gatoniel/napari-merge-stardist-masks/actions)
[](https://codecov.io/gh/gatoniel/napari-merge-stardist-masks)
[](https://napari-hub.org/plugins/napari-merge-stardist-masks)
This is the [napari] plugin for [StarDist OPP]. Checkout our [paper] for more information.
----------------------------------
## Usage
Read the [tutorial] and download pre-trained models from our [Zenodo repository].
In PowerShell, when you do not have sufficient GPU support, run napari without CUDA support, i.e.,:
```
$env:CUDA_VISIBLE_DEVICES=-1; napari
```
## Installation
You can install `napari-merge-stardist-masks` via [pip]:
pip install napari-merge-stardist-masks
To install latest development version :
pip install git+https://github.com/gatoniel/napari-merge-stardist-masks.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-merge-stardist-masks" is free and open source software
## Issues
If you encounter any problems, please [file an issue] along with a detailed description.
## How to cite
```bibtex
@article{https://doi.org/10.1111/mmi.15064,
author = {Jelli, Eric and Ohmura, Takuya and Netter, Niklas and Abt, Martin and Jiménez-Siebert, Eva and Neuhaus, Konstantin and Rode, Daniel K. H. and Nadell, Carey D. and Drescher, Knut},
title = {Single-cell segmentation in bacterial biofilms with an optimized deep learning method enables tracking of cell lineages and measurements of growth rates},
journal = {Molecular Microbiology},
volume = {n/a},
number = {n/a},
pages = {},
keywords = {3D segmentation, biofilm, deep learning, image analysis, image cytometry, Vibrio cholerae},
doi = {https://doi.org/10.1111/mmi.15064},
url = {https://onlinelibrary.wiley.com/doi/abs/10.1111/mmi.15064},
eprint = {https://onlinelibrary.wiley.com/doi/pdf/10.1111/mmi.15064},
abstract = {Abstract Bacteria often grow into matrix-encased three-dimensional (3D) biofilm communities, which can be imaged at cellular resolution using confocal microscopy. From these 3D images, measurements of single-cell properties with high spatiotemporal resolution are required to investigate cellular heterogeneity and dynamical processes inside biofilms. However, the required measurements rely on the automated segmentation of bacterial cells in 3D images, which is a technical challenge. To improve the accuracy of single-cell segmentation in 3D biofilms, we first evaluated recent classical and deep learning segmentation algorithms. We then extended StarDist, a state-of-the-art deep learning algorithm, by optimizing the post-processing for bacteria, which resulted in the most accurate segmentation results for biofilms among all investigated algorithms. To generate the large 3D training dataset required for deep learning, we developed an iterative process of automated segmentation followed by semi-manual correction, resulting in >18,000 annotated Vibrio cholerae cells in 3D images. We demonstrate that this large training dataset and the neural network with optimized post-processing yield accurate segmentation results for biofilms of different species and on biofilm images from different microscopes. Finally, we used the accurate single-cell segmentation results to track cell lineages in biofilms and to perform spatiotemporal measurements of single-cell growth rates during biofilm development.}
}
```
## Credits
This [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.
[paper]: https://doi.org/10.1111/mmi.15064
[StarDist OPP]: https://github.com/gatoniel/merge-stardist-masks
[tutorial]: https://merge-stardist-masks.readthedocs.io/en/latest/napari-plugin.html
[Zenodo repository]: https://doi.org/10.5281/zenodo.7704410
[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/gatoniel/napari-merge-stardist-masks/issues
[napari]: https://github.com/napari/napari
[tox]: https://tox.readthedocs.io/en/latest/
[pip]: https://pypi.org/project/pip/
[PyPI]: https://pypi.org/
Raw data
{
"_id": null,
"home_page": "https://github.com/gatoniel/napari-merge-stardist-masks",
"name": "napari-merge-stardist-masks",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Niklas Netter",
"author_email": "niknett@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/1b/8c/87fbfc79b6a03f09b9bd9535987e14fb14215c1dd2c6a8014f4fcc3500e7/napari-merge-stardist-masks-0.1.1.tar.gz",
"platform": null,
"description": "# StarDist OPP napari plugin\n\n[](https://github.com/gatoniel/napari-merge-stardist-masks/raw/main/LICENSE)\n[](https://pypi.org/project/napari-merge-stardist-masks)\n[](https://python.org)\n[](https://github.com/gatoniel/napari-merge-stardist-masks/actions)\n[](https://codecov.io/gh/gatoniel/napari-merge-stardist-masks)\n[](https://napari-hub.org/plugins/napari-merge-stardist-masks)\n\nThis is the [napari] plugin for [StarDist OPP]. Checkout our [paper] for more information.\n\n----------------------------------\n\n## Usage\n\nRead the [tutorial] and download pre-trained models from our [Zenodo repository].\n\nIn PowerShell, when you do not have sufficient GPU support, run napari without CUDA support, i.e.,:\n```\n$env:CUDA_VISIBLE_DEVICES=-1; napari\n```\n\n\n## Installation\n\nYou can install `napari-merge-stardist-masks` via [pip]:\n\n pip install napari-merge-stardist-masks\n\n\n\nTo install latest development version :\n\n pip install git+https://github.com/gatoniel/napari-merge-stardist-masks.git\n\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## License\n\nDistributed under the terms of the [BSD-3] license,\n\"napari-merge-stardist-masks\" is free and open source software\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n## How to cite\n```bibtex\n@article{https://doi.org/10.1111/mmi.15064,\nauthor = {Jelli, Eric and Ohmura, Takuya and Netter, Niklas and Abt, Martin and Jim\u00e9nez-Siebert, Eva and Neuhaus, Konstantin and Rode, Daniel K. H. and Nadell, Carey D. and Drescher, Knut},\ntitle = {Single-cell segmentation in bacterial biofilms with an optimized deep learning method enables tracking of cell lineages and measurements of growth rates},\njournal = {Molecular Microbiology},\nvolume = {n/a},\nnumber = {n/a},\npages = {},\nkeywords = {3D segmentation, biofilm, deep learning, image analysis, image cytometry, Vibrio cholerae},\ndoi = {https://doi.org/10.1111/mmi.15064},\nurl = {https://onlinelibrary.wiley.com/doi/abs/10.1111/mmi.15064},\neprint = {https://onlinelibrary.wiley.com/doi/pdf/10.1111/mmi.15064},\nabstract = {Abstract Bacteria often grow into matrix-encased three-dimensional (3D) biofilm communities, which can be imaged at cellular resolution using confocal microscopy. From these 3D images, measurements of single-cell properties with high spatiotemporal resolution are required to investigate cellular heterogeneity and dynamical processes inside biofilms. However, the required measurements rely on the automated segmentation of bacterial cells in 3D images, which is a technical challenge. To improve the accuracy of single-cell segmentation in 3D biofilms, we first evaluated recent classical and deep learning segmentation algorithms. We then extended StarDist, a state-of-the-art deep learning algorithm, by optimizing the post-processing for bacteria, which resulted in the most accurate segmentation results for biofilms among all investigated algorithms. To generate the large 3D training dataset required for deep learning, we developed an iterative process of automated segmentation followed by semi-manual correction, resulting in >18,000 annotated Vibrio cholerae cells in 3D images. We demonstrate that this large training dataset and the neural network with optimized post-processing yield accurate segmentation results for biofilms of different species and on biofilm images from different microscopes. Finally, we used the accurate single-cell segmentation results to track cell lineages in biofilms and to perform spatiotemporal measurements of single-cell growth rates during biofilm development.}\n}\n```\n\n## Credits\n\nThis [napari] plugin was generated with [Cookiecutter] using [@napari]'s [cookiecutter-napari-plugin] template.\n\n[paper]: https://doi.org/10.1111/mmi.15064\n[StarDist OPP]: https://github.com/gatoniel/merge-stardist-masks\n[tutorial]: https://merge-stardist-masks.readthedocs.io/en/latest/napari-plugin.html\n[Zenodo repository]: https://doi.org/10.5281/zenodo.7704410\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/gatoniel/napari-merge-stardist-masks/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",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Segment non-star-convex objects with StarDist by merging masks.",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/gatoniel/napari-merge-stardist-masks/issues",
"Documentation": "https://github.com/gatoniel/napari-merge-stardist-masks#README.md",
"Homepage": "https://github.com/gatoniel/napari-merge-stardist-masks",
"Source Code": "https://github.com/gatoniel/napari-merge-stardist-masks",
"User Support": "https://github.com/gatoniel/napari-merge-stardist-masks/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "54c192ca5236bd55b1fa0077f8f226a8b7bb1cae287153ef17d7720443fce134",
"md5": "5884597e7b7366ad13b7405e486884ee",
"sha256": "958a12ba3863f5f45cc3133ab984fa88fbc7c8efa18797b43a63bc4450047e3e"
},
"downloads": -1,
"filename": "napari_merge_stardist_masks-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5884597e7b7366ad13b7405e486884ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3445046,
"upload_time": "2023-08-08T15:32:15",
"upload_time_iso_8601": "2023-08-08T15:32:15.897041Z",
"url": "https://files.pythonhosted.org/packages/54/c1/92ca5236bd55b1fa0077f8f226a8b7bb1cae287153ef17d7720443fce134/napari_merge_stardist_masks-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1b8c87fbfc79b6a03f09b9bd9535987e14fb14215c1dd2c6a8014f4fcc3500e7",
"md5": "d2adc3f2ee7c78166b9d9a90e2eff031",
"sha256": "311e17c5481f0b2c5733ae8167f773c5149759b25d2b2854647cf1491669e47d"
},
"downloads": -1,
"filename": "napari-merge-stardist-masks-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d2adc3f2ee7c78166b9d9a90e2eff031",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25546877,
"upload_time": "2023-08-08T15:32:17",
"upload_time_iso_8601": "2023-08-08T15:32:17.936544Z",
"url": "https://files.pythonhosted.org/packages/1b/8c/87fbfc79b6a03f09b9bd9535987e14fb14215c1dd2c6a8014f4fcc3500e7/napari-merge-stardist-masks-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-08 15:32:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gatoniel",
"github_project": "napari-merge-stardist-masks",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "napari-merge-stardist-masks"
}
JSON
