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.post3.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.post3-py3-none-any.whl (2.1 MB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for neurogenesis_napari-0.1.0a1.post3.tar.gz
Algorithm Hash digest
SHA256 abe42cb2a0f726123b1443032897889e726d26168c3160f024347478880bd4ad
MD5 f318221d2074bfe08fe8c3bf19ca034f
BLAKE2b-256 ec47feb1274e250a864ab02385ca522922e56765f236d4ec7de93855819e6e2c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for neurogenesis_napari-0.1.0a1.post3-py3-none-any.whl
Algorithm Hash digest
SHA256 e7d1d2ebf21668af475b3294faa1bda01aae403eac47ee51e1535f477e7b72e5
MD5 db24a4a10ca2e042a3f4cf8791b38551
BLAKE2b-256 ea902cc261f10cc9d2a5b9cb372eb52c4a654d2cf7335f00f8928602e9958ed5

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