cartapa-dataset-checker

Validate spatial proteomics h5ad datasets for CartaPA structural and annotation issues.

1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Kang-chen/cartabio-ide-config --skill cartapa-dataset-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cartapa-dataset-checker
Source: https://github.com/Kang-chen/cartabio-ide-config/tree/main/project/cellpa/.agent/skills/cartapa-dataset-checker
Command: npx skills add https://github.com/Kang-chen/cartabio-ide-config --skill cartapa-dataset-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pandas, anndata, matplotlib, and includes scripts (resource) components.

What problem does it solve?

CartaPA dataset checker identifies and reports structural, annotation, and quality issues in spatial proteomics datasets prepared for CartaPA, preventing model misconfiguration and downstream errors.

Core Features & Use Cases

  • Validates basic structure, required metadata, and protein marker counts.
  • Checks spatial coordinates, celltype annotations, and treatment labels with dataset-specific caveats.
  • Generates a concise validation report and optional coordinate visualization for quick quality checks across CODEX-HCC, CODEX-TNBC, IMC-TNBC, SAFE-HNSCC datasets.

Quick Start

Run the dataset checker on your h5ad file using the provided Python script.

Frequently Asked Questions about cartapa-dataset-checker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate spatial proteomics h5ad datasets for CartaPA model inputs?

To validate spatial proteomics h5ad datasets for CartaPA, run the provided Python script to check structural integrity, required obs columns, protein marker counts, and CartaPA embeddings. It generates a concise validation report to prevent model misconfiguration.

What spatial proteomics data formats and dataset types does the CartaPA checker support?

The CartaPA checker supports h5ad files for CODEX-HCC, CODEX-TNBC, IMC-TNB, and SAFE-HNSCC spatial proteomics datasets. It validates basic structure, spatial coordinates, and celltype annotations specific to these multi-slice experiments.

Can I check celltype annotations and spatial coordinates across multiple tissue slices in anndata objects?

Yes, you can check celltype annotations and spatial coordinates across multiple tissue slices in anndata objects. The checker validates coordinate integrity, celltype diversity, and treatment labels while applying dataset-specific caveats for multi-slice experiments.

Why does my CartaPA model misconfigure when using spatial proteomics data with missing metadata?

CartaPA model misconfiguration occurs when spatial proteomics data lacks required obs columns, proper marker counts, or CartaPA embeddings. The checker identifies these structural and annotation issues, providing warnings for dataset-specific caveats to prevent downstream errors.

Do I need anndata and matplotlib installed to generate visual quality checks for h5ad spatial data?

Yes, you need anndata and matplotlib installed to generate visual quality checks for h5ad spatial data. The checker relies on these dependencies alongside numpy and pandas to produce optional coordinate visualizations and validation reports.