spatialdata
Spatial data format.
Decision gist · record as of 2026-08-14
Yes, if you work with spatial omics data and need a standardized, cross-language framework. The package is actively maintained, permissively licensed, and backed by a peer-reviewed publication and institutional support. Install friction is low. However, be aware that it requires Python 3.12, carries substantial downstream dependencies, and the documentation explicitly notes the library is under review—expect potential API changes as the community provides feedback. Not suitable if you need Windows-specific support guarantees or absolute API stability.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- Installation via conda is currently not available; pip is the only supported installation method.
- Low install friction with a pure-wheel distribution.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause permissive license allows commercial and private use with minimal restrictions; you must retain copyright notice and disclaimer in distributions.
last release 2026-07-02 (43 days) · last repo commit 2026-08-14 · 383 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 129,899 downloads/mo, #11,656 on PyPI
Alternatives
Verify before relying
pip install spatialdata
import spatialdata
# Load or create spatial omics data via the framework
data = spatialdata.read_zarr('path/to/data.zarr')- Specific performance characteristics or scalability limits for large spatial datasets.
- Maturity level and API stability guarantees given the note that the library is 'currently under review'.
- Windows support status beyond 'manually tested' — automated testing covers Linux and macOS only.
What it is and what it does
SpatialData is a framework and schema for storing and working with spatial omics data—datasets that combine gene expression, protein abundance, or other molecular measurements with spatial coordinates. It defines a universal format built on the OME-NGFF specification, allowing researchers to represent uni- and multi-modal spatial experiments in a standardized way. The core library handles data access, manipulation, and serialization; it is part of a growing ecosystem that includes companion packages for loading data from common technologies, static plotting, and interactive exploration.
The package depends on a large stack of scientific libraries—including dask for distributed computing, geopandas for spatial operations, xarray for multi-dimensional arrays, and zarr for chunked storage—making it suitable for workflows that need to process, analyze, or share spatial omics datasets across teams or languages. It is actively maintained by the scverse project and has been cited in peer-reviewed literature, though the documentation notes that the library is still under community review and may see API changes.
Use it for
- Load spatial transcriptomics or proteomics data from commercial platforms (e.g., Visium, MERFISH) into a standardized format for downstream analysis.
- Store and share multi-modal spatial omics experiments (combining imaging, gene expression, and metadata) in a single interoperable file.
- Build analysis pipelines that work with spatial data in Python while ensuring compatibility with R and JavaScript implementations.
- Perform distributed spatial operations (clustering, segmentation, neighborhood analysis) on large datasets using dask integration.
- Visualize spatial omics data interactively via the napari plugin or generate publication-ready static plots.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you work with spatial omics data and need a standardized, cross-language framework.
The package is actively maintained, permissively licensed, and backed by a peer-reviewed publication and institutional support. Install friction is low. However, be aware that it requires Python 3.12, carries substantial downstream dependencies, and the documentation explicitly notes the library is under review—expect potential API changes as the community provides feedback. Not suitable if you need Windows-specific support guarantees or absolute API stability.
Install
spatialdata on PyPI
Before you install
Low install friction with a pure-wheel distribution. Active maintenance with a recent release (43 days old) and ongoing development. The package carries 28 runtime dependencies including heavy scientific stacks (dask, geopandas, xarray, zarr), which will pull in substantial downstream requirements but are all standard in the spatial-omics ecosystem.
Requires Python 3.12 or later. Installation via conda is currently not available; pip is the only supported installation method.
License in practice
BSD 3-Clause permissive license allows commercial and private use with minimal restrictions; you must retain copyright notice and disclaimer in distributions.
Quickstart
pip install spatialdata
import spatialdata
# Load or create spatial omics data via the framework
data = spatialdata.read_zarr('path/to/data.zarr')Verify before relying
- Specific performance characteristics or scalability limits for large spatial datasets.
- Maturity level and API stability guarantees given the note that the library is 'currently under review'.
- Windows support status beyond 'manually tested' — automated testing covers Linux and macOS only.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 28 packagesanndataannselclickdask-imagedaskdatashaderdistributedfsspecgeopandasmultiscale-spatial-imagenetworkxnumbanumpyome-zarrpandaspoochpyarrowrichscikit-imagescipysetuptoolsshapelyspatial-imagetyping-extensionsuniversal-pathlibxarray-spatialxarrayzarr |
| Maintenance | Actively maintained 43 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 129,899 / month, #11,656 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: spatialdata-0.8.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “spatial omics data framework”
- spatialdataSpatialData is a data framework and serialization format for uni- and…
- scvi-toolsscvi-tools provides probabilistic models for analyzing single-cell…
- mypy-boto3-omicsProvides type annotations and IDE autocomplete support for the AWS…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also anndata · mudata · scvi-tools · multiscale-spatial-image · GridDataFormats · spatial-access · apache-sedona · scanpy · spaghetti · spatial_image