Skip to main content

A minimalist toolkit for holographic plankton image segmentation

Project description

HoloContour Logo

A minimalist tool for holographic plankton image segmentation.

HoloContour

This repository provides a pipeline for segmenting holographic particle images using a hybrid region-growing and contour refinement method. It integrates with the MorphoCut framework and exports outputs compatible with EcoTaxa.


🚀 Features

  • Contour-based object detection with:
    • Intensity filtering
    • Histogram matching (optional)
    • Region growing from intensity minima
  • Optional plot saving of initial vs. refined masks
  • Compatible with EcoTaxaWriter
  • YAML-based configuration
  • Safe fallback for empty masks

⚙️ Usage

1. Install Dependencies

pip install -r requirements.txt

python main.py --config configs/sample_config.yaml --input path/to/your/data

🖼 Example

The figure below shows an example of the pipeline's segmentation output:

Segmentation Result

  • Red dashed: Initial region estimate
  • Blue solid: Refined segmentation contour

License

This project is licensed under the MIT License - see the LICENSE file for details.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

holocontour-0.1.1.tar.gz (6.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

holocontour-0.1.1-py3-none-any.whl (6.5 MB view details)

Uploaded Python 3

File details

Details for the file holocontour-0.1.1.tar.gz.

File metadata

  • Download URL: holocontour-0.1.1.tar.gz
  • Upload date:
  • Size: 6.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.7

File hashes

Hashes for holocontour-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d7570035d24c7d63e55dbda3acd2fb806ca8481ee330d4af88a5374afe21c7ed
MD5 73e887fc70bff3d5b4c9a195b72185f8
BLAKE2b-256 63baf6d6c3125e585f942a1f20a31df46c57d0e927d3b521446f41a0a1e41c66

See more details on using hashes here.

File details

Details for the file holocontour-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: holocontour-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.7

File hashes

Hashes for holocontour-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fd12565836853248b0befc05ef64aad1645efd71958c20dd4ac5f85d6dd3c50d
MD5 da1d0b79bf7c0ce7a95b6c41233249e3
BLAKE2b-256 f0dbf7fbd320d19c827cb9e8f67b95b4bcdc4df0870155a2182063ff2b3fd146

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page