Skip to main content

PyPI Zenodo Status Python Version License

Read the documentation at https://merge-stardist-masks.readthedocs.io/ Tests Codecov

pre-commit Black

This repository contains the python package for the new StarDist post-processing step StarDist OPP. StarDist OPP allows to use StarDist segmentation on non-star-convex objects. In our paper, we show that StarDist OPP outperforms other methods in instance segmentation tasks for three-dimensional microbial biofilms. Check it out for more information.

https://github.com/gatoniel/merge-stardist-masks/raw/main/images/graphical-overview.png

Features

  • StarDist OPP merges masks together - hence the repository name

https://github.com/gatoniel/merge-stardist-masks/raw/main/images/graphical-algorithm-explanation.png
  • StarDist OPP works in 2D and 3D

  • In 2D, StarDist OPP works also on big and winding objects

Requirements

Usage

Please see the EXAMPLE in Usage for details or check out the tutorial of our napari plugin to directly use StarDist OPP on your data.

Installation

You can install StarDist OPP via pip from PyPI:

$ pip install merge-stardist-masks

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, StarDist OPP is free and open source software.

Issues

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

How to cite

@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 = {119},
number = {6},
pages = {659-676},
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.},
year = {2023}
}
https://github.com/gatoniel/merge-stardist-masks/raw/main/images/stardist-opp-cover-image.png

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.

Release files for merge-stardist-masks 0.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for merge-stardist-masks 0.2.4
File Size Uploaded
merge_stardist_masks-0.2.4.tar.gz 28.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for merge-stardist-masks 0.2.4
File Interpreter ABI Platform
merge_stardist_masks-0.2.4-py3-none-any.whl Python 3 none any Details

Total release size: 63.7 kB

Release files / merge_stardist_masks-0.2.4.tar.gz

Download URL merge_stardist_masks-0.2.4.tar.gz
Size 28.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a64d1bbcce3c135109af1d771a6a147ba1c45ed31009ca90db850e9bf14031c7
BLAKE2b-256 checksum
How to use checksums
d347e05706c3729ad4d0d891b4b66ca6937d46aa820ac9908ecee28f482d7509
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.

Transparency log

Release files / merge_stardist_masks-0.2.4-py3-none-any.whl

Download URL merge_stardist_masks-0.2.4-py3-none-any.whl
Size 34.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9f28e39ef5857cc86bb489d7dd9b9baafba3604a070524a7c5d1d40894c84aa2
BLAKE2b-256 checksum
How to use checksums
afba4fb61e2bf63dfe449120aed8fff1b069130349529c66add28b5b02a183bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.4 This release

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page