Skip to main content

A plugin to quickly generate dense ground truth with sparse labels

Project description

napari-bootstrapper

License BSD-3 PyPI Python Version tests codecov napari hub npe2 Copier

Introduction

napari-bootstrapper is a tool to quickly generate dense 3D labels using sparse 2D labels within napari.

Dense 3D segmentations are generated using the 2D->3D method described in the preprint titled Sparse Annotation is Sufficient for Bootstrapping Dense Segmentation. In the preprint, we show sparse 2D annotations made in ~10 minutes on a single section can generate dense 3D segmentations that are reasonably good starting points for refining or bootstrapping.

This plugin is limited to the 2D->3D method and is intended for small volumes that can fit in memory. For more complex bootstrapping workflows, dedicated 3D models, and block-wise processing of large volumes, we recommend using the Bootstrapper CLI tool.

Installation

We recommend installing napari-bootstrapper via conda and pip:

  1. Create a new environment called napari-bootstrapper:
conda create -n napari-bootstrapper -c conda-forge python==3.11 napari pyqt
  1. Activate the newly-created environment:
conda activate napari-bootstrapper
  1. You can install napari-bootstrapper via pip:
pip install napari-bootstrapper
  • Or you can install the latest development version from github:
pip install git+https://github.com/ucsdmanorlab/napari-bootstrapper.git

Getting Started

Run the following in your terminal:

conda activate napari-bootstrapper
napari

Citation

If you find Bootstrapper useful in your research, please consider citing our preprint:

@article {Thiyagarajan2024.06.14.599135,
	author = {Thiyagarajan, Vijay Venu and Sheridan, Arlo and Harris, Kristen M. and Manor, Uri},
	title = {Sparse Annotation is Sufficient for Bootstrapping Dense Segmentation},
	year = {2024},
	doi = {10.1101/2024.06.14.599135},
	URL = {https://www.biorxiv.org/content/10.1101/2024.06.14.599135v2},
}

Issues

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

Funding

Chan-Zuckerberg Imaging Scientist Award DOI https://doi.org/10.37921/694870itnyzk from the Chan Zuckerberg Initiative DAF, an advised fund of Silicon Valley Community Foundation (funder DOI 10.13039/100014989).

NSF NeuroNex Technology Hub Award (1707356), NSF NeuroNex2 Award (2014862)

image

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_bootstrapper-0.1.1.tar.gz (19.5 MB view details)

Uploaded Source

Built Distribution

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

napari_bootstrapper-0.1.1-py3-none-any.whl (19.5 MB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for napari_bootstrapper-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d650da4bd8a50149651ee39dd4956174009ca5626b386c4db21320e183d9bbfe
MD5 557b9310dfeb0c48f3c9d62f012718bd
BLAKE2b-256 a8364116cf2df97c7443dc2af55e5119aa57e7e643da3fa25673f0fecaacd358

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for napari_bootstrapper-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 19b09a76de335665ea76f45e6e9a6e528eedbfee257e6ef8d712641069fa00cf
MD5 98d0727f80ef0b5e1e841d1f9067d6bd
BLAKE2b-256 0043d5016eaf4199a4b98584975b6fad27ff671c1a6c665228826c7ee2f6e46f

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