Pathml

Source: https://github.com/aipoch/medical-research-skills

PathML

When to Use

• Use this skill when you need a full-featured computational pathology toolkit for advanced wsi analysis, including multiplexed immunofluorescence (codex, vectra), nuclei segmentation, tissue graph construction, and machine learning model training on pathology data. supports over 160 slide formats. for simple tile extraction from h&e slides, histolab may be simpler in a reproducible workflow.
• Use this skill when a data analytics task needs a packaged method instead of ad-hoc freeform output.
• Use this skill when the user expects a concrete deliverable, validation step, or file-based result.
• Use this skill when the documented workflow in this package is the most direct path to complete the request.
• Use this skill when you need the pathml package behavior rather than a generic answer.

Key Features

• Scope-focused workflow aligned to: A full-featured computational pathology toolkit for advanced WSI analysis, including multiplexed immunofluorescence (CODEX, Vectra), nuclei segmentation, tissue graph construction, and machine learning model training on pathology data. Supports over 160 slide formats. For simple tile extraction from H&E slides, histolab may be simpler.
• Documentation-first workflow with no packaged script requirement.
• Reference material available in references/ for task-specific guidance.
• Structured execution path designed to keep outputs consistent and reviewable.

Dependencies

• Python: 3.10+. Repository baseline for current packaged skills.
• Third-party packages: not explicitly version-pinned in this skill package. Add pinned versions if this skill needs stricter environment control.

Example Usage

Skill directory: 20260316/scientific-skills/Data Analytics/pathml
No packaged executable script was detected.
Use the documented workflow in SKILL.md together with the references/assets in this folder.

Example run plan:

1. Read the skill instructions and collect the required inputs.
2. Follow the documented workflow exactly.
3. Use packaged references/assets from this folder when the task needs templates or rules.
4. Return a structured result tied to the requested deliverable.

Implementation Details

See ## Overview above for related details.

• Execution model: validate the request, choose the packaged workflow, and produce a bounded deliverable.
• Input controls: confirm the source files, scope limits, output format, and acceptance criteria before running any script.
• Primary implementation surface: instruction-only workflow in SKILL.md.
• Reference guidance: references/ contains supporting rules, prompts, or checklists.
• Parameters to clarify first: input path, output path, scope filters, thresholds, and any domain-specific constraints.
• Output discipline: keep results reproducible, identify assumptions explicitly, and avoid undocumented side effects.

Overview

PathML is a comprehensive Python toolkit designed for computational pathology workflows, facilitating machine learning and image analysis of whole slide pathology images. This framework provides modular, composable tools for loading various slide formats, image preprocessing, constructing spatial graphs, training deep learning models, and analyzing multiplexed parametric imaging data from techniques like CODEX and multiplexed immunofluorescence.

When to Use This Skill

Apply this skill in the following scenarios:

• Loading and processing whole slide images (WSI) in various proprietary formats
• Preprocessing H&E stained tissue images with stain normalization
• Nuclei detection, segmentation, and classification workflows
• Constructing cell and tissue graphs for spatial analysis
• Training or deploying machine learning models on pathology data (HoVer-Net, HACTNet)
• Analyzing multiplexed parametric imaging for spatial proteomics (CODEX, Vectra, MERFISH)
• Quantifying marker expression from multiplexed immunofluorescence
• Managing large-scale pathology datasets using HDF5 storage
• Tile-based analysis and stitching operations

Core Capabilities

PathML provides six major core capability areas, all documented in detail in the reference files:

1. Image Loading & Formats

Load whole slide images from over 160 proprietary formats, including Aperio SVS, Hamamatsu NDPI, Leica SCN, Zeiss ZVI, DICOM, and OME-TIFF. PathML automatically handles vendor-specific formats and provides a unified interface for accessing image pyramids, metadata, and regions of interest.

See: references/image_loading.md for supported formats, loading strategies, and handling different slide types.

2. Preprocessing Pipelines

Build modular preprocessing pipelines by composing transforms for image operations, quality control, stain normalization, tissue detection, and mask operations. PathML's Pipeline architecture supports reproducible, scalable preprocessing across large datasets.

Key transforms:

• StainNormalizationHE - Macenko/Vahadane stain normalization
• TissueDetectionHE, NucleusDetectionHE - Tissue/nuclei segmentation
• MedianBlur, GaussianBlur - Noise reduction
• LabelArtifactTileHE - Artifact quality control

See: references/preprocessing.md for the complete transform catalog, pipeline construction, and preprocessing workflows.

3. Graph Construction

Construct spatial graphs representing cell and tissue-level relationships. Extract features from segmented objects to create graph-based representations suitable for graph neural networks and spatial analysis.

See: references/graphs.md for graph construction methods, feature extraction, and spatial analysis workflows.

4. Machine Learning

Train and deploy deep learning models for nuclei detection, segmentation, and classification. PathML integrates PyTorch with pre-built models (HoVer-Net, HACTNet), custom DataLoaders, and ONNX support for inference.

Key models:

• HoVer-Net - Simultaneous nuclei segmentation and classification
• HACTNet - Hierarchical cell-type classification

See: references/machine_learning.md for model training, evaluation, inference workflows, and how to use public datasets.

5. Multiparametric Imaging

Analyze spatial proteomics and gene expression data from CODEX, Vectra, MERFISH, and other multiplexed imaging platforms. PathML provides specialized slide classes and transforms for handling multiplexed parametric data, cell segmentation using Mesmer, and quantification workflows.

See: references/multiparametric.md for CODEX/Vectra workflows, cell segmentation, marker quantification, and integration with AnnData.