Skip to main content

Napari Hydra Plugin - GUI-based nested object detection

Project description

Napari-Hydra

A napari plugin for single-shot nested instance segmentation of biomedical objects using HydraStarDist — a branched deep learning architecture built on StarDist.

Napari-Hydra enables GUI-based detection, segmentation, and quantification of spatially correlated, star-convex objects (e.g. viral plaques nested within tissue culture wells) directly from digital photographs — no microscopy required.

How to Cite Us

If you use this plugin or the underlying methods in your research, please cite the following:

De, T., Thangamani, S., Urbański, A., & Yakimovich, A. (2025). A digital photography dataset for Vaccinia Virus plaque quantification using Deep Learning. Scientific Data, 12, 719. https://doi.org/10.1038/s41597-025-05030-8

De, T., Urbanski, A., & Yakimovich, A. (2025). Single-shot Star-convex Polygon-based Instance Segmentation for Spatially-correlated Biomedical Objects. arXiv preprint arXiv:2504.12078. https://doi.org/10.48550/arXiv.2504.12078

Overview

Traditional virological plaque assays rely on manual counting — a process that is laborious, subjective, and error-prone. Napari-Hydra addresses this by providing an end-to-end deep learning pipeline accessible through napari's graphical interface.

What is HydraStarDist?

HydraStarDist (HSD) extends the StarDist architecture with a joint encoder and branched decoders, enabling simultaneous detection of two categories of nested objects in a single forward pass. This is in contrast to conventional approaches that require independent models for each object type (e.g. one for wells, one for plaques).

The shared encoder implicitly captures spatial correlations between nested objects (e.g. plaques can only appear within wells), resulting in more meaningful representations and improved joint detection accuracy.

Key Features

  • Single-shot prediction — detect and segment both wells and plaques simultaneously
  • Interactive thresholding — tune probability and NMS thresholds per object class
  • Per-well plaque counting — automatic quantification with per-well breakdown
  • Model fine-tuning — adapt pre-trained models to your own data directly from the GUI
  • Stack support — process time-lapse image stacks with frame-by-frame results
  • Export — save prediction summaries including plaque counts and morphometrics

Installation

pip install napari-hydra

Or install in development mode:

git clone https://github.com/plaque2/napari-hydra.git
cd napari-hydra
pip install -e ".[test]"

Usage

Launch napari with the plugin:

napari -w napari-hydra
  1. Load an image — drag and drop or use File > Open to load a plaque assay photograph.
  2. Run Prediction — select the image layer and model, then click Run Prediction. Wells and plaques are detected simultaneously and displayed as label overlays.
  3. Count — click Count to compute per-well plaque counts.
  4. Tune — fine-tune the model on your own annotated data using the Tune Model button. Fine-tuned models are saved as new timestamped copies, preserving the original.
  5. Export — save a prediction summary with plaque counts and areas.

License

BSD-3-Clause

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

napari_hydra-0.0.3.tar.gz (67.0 kB view details)

Uploaded Source

Built Distribution

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

napari_hydra-0.0.3-py3-none-any.whl (70.3 kB view details)

Uploaded Python 3

File details

Details for the file napari_hydra-0.0.3.tar.gz.

File metadata

  • Download URL: napari_hydra-0.0.3.tar.gz
  • Upload date:
  • Size: 67.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for napari_hydra-0.0.3.tar.gz
Algorithm Hash digest
SHA256 3b99a9f99667a6096d185d6c5b3ef7a90823f20d13aef732a8786b9e688170ff
MD5 4457efd4930d63375b3eaedf2e9997db
BLAKE2b-256 2f3ba42ca51818710a37c2fed7572590a8b523bd37286785b18147959fb25dee

See more details on using hashes here.

File details

Details for the file napari_hydra-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: napari_hydra-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 70.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for napari_hydra-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f016ff192e9f5007426bb3a95556ecbd0fe9456e6677942db39e7a757a90f8a1
MD5 0a7917d3e130947553ce667ee613c5a6
BLAKE2b-256 906d0538df9dea292bd4b5baade14e411b6e10f1696353e7b3af32a8752e3352

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