Skip to main content

A napari plugin to segment and classify cells.

Project description

TUMai Helmholtz Neurogenesis Napari Plugin

License MIT PyPI Python Version napari hub

This plugin provides one-click color normalization, denoising, Cellpose-based nuclear segmentation and cell classification.

Key Features

Widget Function Input Output
Normalize + Denoise Color normalization and denoising Bright-field image Processed image
Segment Nuclear segmentation DAPI/nuclear stain Masks, centroids, bounding boxes
Segment + Classify End-to-end cell analysis 4-channel images Cell segmentation + classification

Quick Start

Installation

pip install neurogenesis-napari

Or install through napari:

  1. Open napari
  2. Go to PluginsInstall/Uninstall Plugins
  3. Search for "TumAI Histology Toolkit"
  4. Click Install

Basic Usage

  1. Load your images into napari
  2. Select the appropriate widget from the Plugins menu
  3. Choose your image layers from the dropdown menus
  4. Click the action button to process

The plugin will automatically download required AI models on first use.


Widget Documentation

Normalize + Denoise

Purpose: Standardizes color variations and reduces noise in bright-field images.

Usage

  1. Load a bright-field image into napari
  2. Open PluginsNormalize and Denoise
  3. Select your bright-field image from the BF dropdown
  4. Click "Normalize + Denoise"

What it does

  • Color Normalization: Adjusts colors against an internal reference to standardize appearance across different images/scanners
  • Denoising: Removes noise while preserving important cellular structures
  • Output: Creates a new layer named {original_name}_denoised

Segment

Purpose: Detects and segments individual cell nuclei using Cellpose.

Usage

  1. Load a nuclear staining image (DAPI) into napari
  2. Open PluginsSegment
  3. Select your nuclear image from the DAPI dropdown
  4. Optionally adjust:
    • GPU: Enable for faster processing
    • Model: Choose Cellpose model (cyto3 default)
  5. Click "Segment Nuclei"

What it does

  • Segmentation: Uses Cellpose to identify individual nuclei
  • Creates 3 new layers:
    • {name}_masks: Segmentation masks
    • {name}_centroids: Center points of each detected cell
    • {name}_bboxes: Bounding boxes around each cell

Segment + Classify

Purpose: Complete pipeline that segments nuclei AND classifies cell types in multi-channel images.

Usage

  1. Load a 4-channel image into napari as separate layers:
    • DAPI: Nuclear staining
    • Tuj1: β-III-tubulin
    • RFP: Red fluorescent protein marker
    • BF: Bright-field
  2. Open PluginsSegment and Classify
  3. Select each channel from the respective dropdowns
  4. Choose Reuse cached:
    • True: Reuse previous segmentation (faster) from the segment widget
    • False: Perform fresh segmentation
  5. Click "Segment + Classify"

What it does

  1. Segmentation: Does segmentation same as the segment widget above
  2. Feature extraction: Uses a Variational Autoencoder (VAE) to extract features
  3. Classification: Nearest-centroid classifier assigns cell types

Output

Creates colored polygons for detected cells based on type:

  • 🟣 Astrocytes (magenta polygons)
  • ⚫ Dead Cells (gray polygons)
  • 🔵 Neurons (cyan polygons)
  • 🟢 OPCs (lime polygons)

The classification results can be edited.


Supported Image Formats

  • .czi (via napari-czifile2)
  • .png, .jpg

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

neurogenesis_napari-0.1.0a1.post4.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

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

neurogenesis_napari-0.1.0a1.post4-py3-none-any.whl (2.1 MB view details)

Uploaded Python 3

File details

Details for the file neurogenesis_napari-0.1.0a1.post4.tar.gz.

File metadata

File hashes

Hashes for neurogenesis_napari-0.1.0a1.post4.tar.gz
Algorithm Hash digest
SHA256 5efef8f8208283cab733efd03aca1020a0ac9cdbd398e68391901b1f114e7a36
MD5 403f0ebed9cf28581da10ad5de9a199a
BLAKE2b-256 f56664f36cdf6892b4972b9a45e4db27eae74a7ff80a40bb70c63a7eb5855520

See more details on using hashes here.

File details

Details for the file neurogenesis_napari-0.1.0a1.post4-py3-none-any.whl.

File metadata

File hashes

Hashes for neurogenesis_napari-0.1.0a1.post4-py3-none-any.whl
Algorithm Hash digest
SHA256 f144b81f7231d32fc4189645c596b30659c36b2ec8eff8e31e4df98e51cf6c73
MD5 7b129b7b33833155f6837f4464198f03
BLAKE2b-256 eea98e827ef047a3af746028dcdc5eba6bd7399609578aa5772c07f03e201b16

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