spatialdata

Organize, query, and visualize spatial omics data with a unified Python framework.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/Ketomihine/my_skills --skill spatialdata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spatialdata
Source: https://github.com/Ketomihine/my_skills/tree/main/spatialdata
Command: npx skills add https://github.com/Ketomihine/my_skills --skill spatialdata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SpatialData provides a unified Python-based framework to manage, analyze, and visualize multi-modal spatial omics data, enabling seamless integration of images, labels, shapes, points, and tabular annotations with robust metadata about coordinate systems and transformations.

Core Features & Use Cases

  • Unified data model: Represent spatial elements (images, labels, shapes, points) and annotation tables in a single SpatialData object.
  • Coordinate systems & transforms: Define intrinsic/extrinsic coordinate spaces and apply transformations to align datasets across scales.
  • NGFF/Zarr interoperability: Read and write data using NGFF-compatible formats and the SpatialData Zarr extension for scalable storage and lazy loading.
  • Use Case: Load Visium- or Xenium-style datasets, query regions of interest, join spatial elements with annotation tables, and visualize results with napari-spatialdata.

Quick Start

Install SpatialData using pip, then load a sample SpatialData object (e.g., from spatialdata.datasets import blobs; sdata = blobs()) to begin exploring Images, Labels, Points, Shapes, and Tables.

Frequently Asked Questions about spatialdata

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

FAQPage Schema
How do I integrate and visualize multi-modal spatial omics data in Python?

A unified spatial omics data framework provides a single SpatialData object to represent images, labels, shapes, points, and tabular annotations. It solves the problem of fragmented multi-modal data by embedding coordinate transformations and metadata directly alongside the spatial elements.

How do I load and query Visium or Xenium datasets using a unified data model?

To load and query Visium or Xenium datasets, you use the spatialdata-io ecosystem tool to read the raw files into a SpatialData object. Once loaded, you can query regions of interest and join spatial elements with their corresponding annotation tables for downstream analysis.

Does this spatial omics framework support scalable storage and lazy loading for large datasets?

Yes, the framework supports scalable storage and lazy loading through NGFF-compatible formats and the SpatialData Zarr extension. This allows you to read and write large spatial omics datasets efficiently without loading the entire dataset into memory at once.

Can I apply coordinate transformations to align multi-modal spatial omics datasets across different scales?

Yes, you can apply coordinate transformations to align datasets across different scales by defining intrinsic and extrinsic coordinate spaces. The framework manages robust metadata for these transformations, enabling precise alignment of images, labels, and points.

What is the best way to organize spatial elements like points and shapes with annotation tables?

The best way to organize spatial elements and annotation tables is by storing them together in a single SpatialData object. This unified data model ensures that images, labels, shapes, points, and tables remain synchronized with robust coordinate system metadata.