# Pathml

> Flujos locales de patología computacional solo para investigación: carga y teselado de portaobjetos, preprocesado y QC, datos h5path, cuantificación de imágenes multiplex, grafos espaciales e inferencia acotada.

Fuente: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/pathml
Markdown: https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/pathml.md

Repositorio: https://github.com/K-Dense-AI/scientific-agent-skills
Autor: K-Dense-AI
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 59 tok instalada, 2.6k tok al activarse, 37.7k tok con todos los archivos del bundle
Bundle: 13 archivos, 147 KB
Permisos que pide: read write edit bash glob

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent claude-code
# Cursor
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent cursor
# Codex
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent codex
# Gemini CLI
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent gemini
# Windsurf
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent windsurf
# Cline
npx -y skills add K-Dense-AI/scientific-agent-skills --skill pathml --agent cline
```

## Qué hace

- Ejecuta flujos de patología computacional locales con PathML: carga y tesela portaobjetos, y arma pipelines de preprocesado y control de calidad
- Gestiona datos `.h5path`, cuantifica imágenes multiplex y construye grafos espaciales
- Planifica inferencia de modelos acotada, verificando procedencia y checksum antes de cargar un checkpoint
- Exige desidentificación de datos y separación por paciente antes de teselar, como límite de seguridad
- Bloquea por defecto cualquier descarga de red de modelos remotos salvo consentimiento explícito del usuario

## Cuándo usarla

- Se necesita cargar, testear o procesar portaobjetos (whole-slide images) de patología de forma local
- Se construyen pipelines de preprocesado, QC de tejido o normalización de tinción con PathML
- Se cuantifican imágenes multiplex o se construyen grafos espaciales para análisis de patología

## Cuándo no

- El resultado se usaría para diagnosticar, graduar, estadificar o tratar a un paciente: PathML es software de investigación, no un dispositivo médico validado

## Qué la activa

- "Carga este portaobjetos SVS y aplica detección de tejido"
- "Construye un pipeline de preprocesado con PathML"
- "Cuantifica esta imagen multiplex CODEX"
- "Planea la inferencia de un modelo HoVer-Net sobre estas teselas"

## Antes de instalar

- PathML 3.0.5 requiere Python 3.10-3.12 más OpenSlide, BLAS/LAPACK y Java/Bio-Formats, y se instala con `uv pip install pathml==3.0.5` junto a librerías nativas específicas de la plataforma.
- Necesita en el PATH: python

## Archivos

- SKILL.md — 10 KB
- references/data_management.md — 11 KB
- references/graphs.md — 10 KB
- references/image_loading.md — 10 KB
- references/machine_learning.md — 12 KB
- references/multiparametric.md — 12 KB
- references/preprocessing.md — 12 KB
- scripts/_common.py — 12 KB
- scripts/image_qc.py — 11 KB
- scripts/plan_inference.py — 9 KB
- scripts/plan_pipeline.py — 9 KB
- scripts/slide_manifest.py — 14 KB
- scripts/validate_spatial_schema.py — 16 KB

## SKILL.md

Reproducido tal cual desde K-Dense-AI/scientific-agent-skills bajo MIT. Esta sección es el documento original y está en inglés.

# PathML

## Scope and safety boundary

Use PathML for **local computational pathology research**. It is beta research
software, not a validated medical device, diagnostic system, clinical decision
support tool, or substitute for a pathologist. Do not use outputs to diagnose,
grade, stage, or treat a patient.

Pathology files may contain faces, labels, accession numbers, patient identifiers,
DICOM tags, filenames, or linked clinical data. Before processing:

1. Confirm authorization, consent/waiver, data-use terms, and institutional policy.
2. De-identify pixels and metadata; keep the re-identification key outside the
   analysis workspace.
3. Use pseudonymous `patient_id`, `slide_id`, and `specimen_id` values. Do not put
   direct identifiers in filenames, logs, `.h5path` labels, model cards, or reports.
4. Keep inputs, intermediates, and outputs on approved local encrypted storage.
5. Split by patient (then slide) before tiling or fitting any preprocessing step.

## Version baseline, verified 2026-07-23

- **Installable stable release:** PyPI `pathml==3.0.5`, published 2026-03-24.
- The v3.0.5 release notes state Python **3.10-3.12** and sunset 3.9.
  PyPI does not declare `Requires-Python` and still has a stale 3.8 classifier, so
  use the release statement and test the exact environment.
- GitHub releases v3.0.6 (2026-04-14) and v3.0.7 (2026-07-09) exist, but PyPI has
  no artifacts for them as of this review. v3.0.7 updates Torch/TorchVision/
  torch-geometric and ONNX export code. Do not mix those source dependencies with
  the 3.0.5 wheel.
- ReadTheDocs `/latest` identifies itself as 3.0.5. Examples here were checked
  against the v3.0.5 tag and PyPI wheel metadata, not unversioned snippets.
- This skill is MIT-licensed. PathML itself is GPL-2.0 with upstream commercial
  licensing options; review upstream terms before redistribution.

## Reproducible installation

Use Python 3.11 unless the project has tested another supported interpreter:

```bash
uv venv --python 3.11
source .venv/bin/activate
uv pip install "pathml==3.0.5"
python -c "import importlib.metadata as m; print(m.version('pathml'))"
```

PathML 3.0.5 declares no package extras: do **not** use `pathml[all]`. Its base
distribution pins a large scientific/ML stack, including Torch 2.8.0, ONNX 1.17.0,
ONNX Runtime 1.17.x, OpenSlide Python 1.3.1, python-bioformats 4.1.0, and
python-javabridge 4.0.4.

Install native prerequisites before the uv command:

```bash
# Debian/Ubuntu
sudo apt-get install openslide-tools gcc g++ libblas-dev liblapack-dev openjdk-17-jdk

# macOS
brew install openslide openjdk@17

# Windows OpenSlide option documented upstream
vcpkg install openslide
```

Java/Bio-Formats is needed for the broad multidimensional format backend.
OpenSlide handles common brightfield WSI formats more efficiently. CUDA is
optional and must match the pinned PyTorch build; follow PyTorch's platform
selector rather than guessing a CUDA wheel. See `references/image_loading.md`.

## Stable minimal workflow

PathML 3.0.5 uses slide convenience classes and `SlideData.run()`. It does not
provide `SlideData.from_slide()`, and `Pipeline` does not have `run()`:

```python
from pathml.core import HESlide
from pathml.preprocessing import BoxBlur, Pipeline, TissueDetectionHE

slide = HESlide("data/pseudonymous_slide.svs", backend="openslide")
pipeline = Pipeline(
    [
        BoxBlur(kernel_size=5),
        TissueDetectionHE(mask_name="tissue", min_region_size=5000),
    ]
)
slide.run(
    pipeline,
    distributed=False,
    tile_size=512,
    tile_stride=512,
    level=0,
    tile_pad=False,
)
slide.write("derived/pseudonymous_slide.h5path")
```

Start with a bounded manual sample before a full run:

```python
from itertools import islice

for tile in islice(slide.generate_tiles(shape=512, stride=512, level=0), 8):
    pipeline.apply(tile)
    assert tile.masks["tissue"].shape[:2] == tile.image.shape[:2]
```

Tiles use `(i, j)` = `(row, column)` coordinates at the selected pyramid level.
For OpenSlide, PathML maps them to level-0 coordinates internally. Record the
level and downsample; convert to `(x, y)` or micrometres explicitly downstream.

## Research workflow

1. **Inventory locally.** Validate the manifest, reject URLs/symlinks, inspect only
   allowlisted technical metadata, and remove identifiers.
2. **Freeze splits.** Assign every patient and all their slides to one split before
   generating overlapping tiles, graphs, normalization references, or features.
3. **Plan bounds.** Estimate tile count, RAM, output size, and pipeline stages.
4. **Pilot preprocessing.** Inspect tissue masks, whitespace/artifact labels,
   stain behavior, edge padding, and empty-mask cases on representative training
   slides. Do not tune from test slides.
5. **Run and preserve coordinates.** Keep tile level, `(i, j)`, downsample, MPP,
   mask names, QC decisions, and failed/skipped tiles.
6. **Build spatial data deliberately.** Validate channel order, physical units,
   instance labels, node-feature alignment, graph edges, and cell-to-tissue
   assignments.
7. **Infer in bounded batches.** Verify model provenance and checksum without
   loading unknown pickle checkpoints. Keep predictions linked to slide/tile
   coordinates and stitch overlaps with a documented rule.
8. **Report provenance and limits.** Include package lock, source hashes, scanner,
   stain, parameters, seeds, split manifest, model card, exclusions, and QC.

## No-network default and explicit consent gate

Do not instantiate download-capable classes or set dataset `download=True` unless
the user explicitly opts in after receiving the endpoint and disclosure:

- `SegmentMIFRemote` downloads an ONNX file from
  `https://huggingface.co/pathml/test/resolve/main/mesmer.onnx` at construction,
  then runs inference locally. Stable source does **not** upload image pixels.
  The request still discloses network metadata such as IP address and headers and
  creates `temp.onnx`; there is no built-in checksum or offline flag.
- Deprecated `SegmentMIF` imports local DeepCell Mesmer, but DeepCell model
  initialization may need separately provisioned weights. It is not a PathML
  extra and is not the preferred stable API.
- `RemoteTestHoverNet` downloads a model from Hugging Face.
- `PanNukeDataModule(download=True)` contacts Warwick; `DeepFocusDataModule`
  contacts Zenodo. Both default to `download=False`.

Before any future hosted prediction call, state the exact destination, pixel
channels/regions, metadata, identifiers, retention, legal basis, and safeguards;
obtain explicit consent; and never send PHI by default. Prefer reviewed,
checksummed local model artifacts and local inference.

## Model-code security

- PyTorch `model.eval()` means **evaluation mode** for modules; it is not Python's
  dangerous built-in evaluator. Never use Python dynamic evaluation or execution.
- Do not name local files `pathml.py`, `torch.py`, `onnx.py`, or after standard
  libraries; shadow modules can silently change imports.
- PathML's `EntityDataset` loads `.pt` objects with `weights_only=False`. Never
  open an untrusted graph/checkpoint. Treat pickle-based pipelines and `.pt` files
  as executable code.
- ONNX is safer than pickle but not inherently trusted. Verify source, SHA-256,
  expected input/output schema, file size, and runtime limits; use isolation for
  third-party models.

## Bundled local CLIs

All helpers reject URLs and symlinks, cap inputs/work, use strict JSON, avoid
network access, and require no PathML import for `--help`:

```bash
python scripts/slide_manifest.py validate --manifest manifest.csv --root .
python scripts/slide_manifest.py inspect --slide data/example.svs --root .
python scripts/plan_pipeline.py --width 100000 --height 80000 --tile-size 512 --stride 512
python scripts/image_qc.py synthetic --width 256 --height 256
python scripts/validate_spatial_schema.py graph --input graph.json --root .
python scripts/validate_spatial_schema.py multiplex --input cells.csv --root .
python scripts/plan_inference.py --tile-count 4000 --batch-size 16 --height 256 --width 256
```

The inference planner reads numbers or a bounded JSON model card only; it never
imports a model framework or opens a checkpoint.

## Detailed references

- `references/image_loading.md` — slide classes, backends, formats, levels,
  coordinates, technical metadata, and privacy.
- `references/preprocessing.md` — stable transforms, masks/QC, stain processing,
  pipeline execution, and leakage prevention.
- `references/data_management.md` — `.h5path`, manifests, datasets, provenance,
  splits, and safe downloads.
- `references/multiparametric.md` — multidimensional layout, CODEX/Vectra,
  quantification, AnnData, DeepCell/Mesmer, and network disclosure.
- `references/graphs.md` — instance maps, feature alignment, KNN/RAG/HACT graphs,
  spatial units, schemas, and validation.
- `references/machine_learning.md` — HoVer-Net/HACTNet, local ONNX inference,
  batching, checkpoint trust, evaluation, and model provenance.

## Primary sources

All checked 2026-07-23:

- PyPI metadata: https://pypi.org/project/pathml/3.0.5/
- Stable source tag: https://github.com/Dana-Farber-AIOS/pathml/tree/v3.0.5
- Releases: https://github.com/Dana-Farber-AIOS/pathml/releases
- Stable documentation: https://pathml.readthedocs.io/en/stable/
- Rosenthal et al. (2022), PathML toolkit:
  https://doi.org/10.1158/1541-7786.MCR-21-0665
- Omar et al. (2025), multiplex workflows:
  https://doi.org/10.1016/j.labinv.2025.104220

## Dónde encaja

- Categoría: [Investigación](https://skillsagentes.com/categorias/investigacion.md) — Investigación estructurada, búsqueda de fuentes y síntesis.
- Creador: [K-Dense-AI](https://skillsagentes.com/creators/k-dense-ai.md) — 163 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Citation Management](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/citation-management.md): Gestión integral de citas académicas: busca en OpenAlex, PubMed y Google Scholar, extrae metadatos precisos, valida citas y genera entradas BibTeX correctamente formateadas.
- [Scientific Slides](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/scientific-slides.md): Crea decks de diapositivas y presentaciones para charlas de investigación: PowerPoint, presentaciones de conferencia, seminarios, defensas de tesis. Da estructura, plantillas, guía de tiempos y validación visual.
- [Literature Review](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/literature-review.md): Realiza revisiones bibliográficas sistemáticas y completas usando varias bases académicas (PubMed, arXiv, bioRxiv, Semantic Scholar). Genera markdown y PDF con citas verificadas en varios estilos (APA, Nature, Vancouver).
- [Infographics](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/infographics.md): Crea infografías profesionales con Nano Banana Pro AI y refinamiento iterativo inteligente. Usa Gemini 3.6 Flash para revisar la calidad e integra investigación con Perplexity Sonar. Soporta 10 tipos, 8 estilos y paletas para daltonismo.
- [Latex Posters](https://skillsagentes.com/skills/k-dense-ai/scientific-agent-skills/latex-posters.md): Crea pósteres de investigación profesionales en LaTeX con beamerposter, tikzposter o baposter, para conferencias y comunicación científica: layout, colores, columnas múltiples e integración de figuras.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)