---
id: multiscale-spatial-image
version: "2.1.0"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# multiscale-spatial-image — Generate a multiscale, chunked, multi-dimensional spatial image data structure that can be serialized to OME-NGFF.

License: permissive · Maintenance: aging · Downloads: 95.6K/mo

## What it is and what it does

multiscale-spatial-image builds multiscale image pyramids—progressively downsampled versions of an image—and organizes them into an Xarray Datatree structure where each scale level is a separate node. Each scale is a chunked Dask array, enabling lazy evaluation and out-of-core processing. The package preserves spatial metadata (coordinates, dimensions) across all scales and can serialize the entire pyramid to OME-NGFF (Open Microscopy Environment Next Generation File Format) via Zarr, making it suitable for scientific imaging workflows that need efficient storage and access to multiscale data.

The package is built on top of spatial-image, xarray, and Dask, and provides convenience methods like transpose, reindex, and assign_coords that operate across all scales while skipping non-dimensional nodes. It targets scientific Python users working with microscopy, medical imaging, or other multidimensional spatial data who need to generate and store image hierarchies in a standard, interoperable format.

Use it for:

- Generate multiscale pyramids from microscopy images for efficient zoom-and-pan visualization in web or desktop viewers
- Prepare large volumetric datasets for hierarchical processing pipelines that operate at different resolutions
- Convert single-scale images to OME-NGFF Zarr stores for archival and sharing with other imaging software
- Apply transformations (transpose, reindex) uniformly across all scales of a multiscale dataset
- Build image analysis workflows that downsample data for preview or coarse-to-fine processing strategies

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates multiscale image pyramids organized as Xarray Datatrees, with built-in support for chunked Dask arrays and serialization to OME-NGFF/Zarr formats.

Yes, if you work with multidimensional spatial imaging data and need to generate and store multiscale pyramids in a standard format. The package has low install friction, permissive licensing, and no known vulnerabilities. Maintenance is aging but not abandoned; the API is explicitly pre-1.0 and subject to change, so pin versions carefully in production. Best suited for scientific and research use cases rather than production services.

## Install

pip install multiscale-spatial-image
uv add multiscale-spatial-image
poetry add multiscale-spatial-image

## Installing multiscale-spatial-image

Before you install: Low friction: pure Python wheel with no compiled dependencies. Maintenance status is aging—274 days since last release—but the repository remains active with recent commits and no archived status.

License in practice: Apache 2.0 permissive license allows commercial and derivative use with minimal restrictions; attribution and license notice required in distributions.

Quickstart:

pip install multiscale_spatial_image

import numpy as np
from spatial_image import to_spatial_image
from multiscale_spatial_image import to_multiscale

array = np.random.randint(0, 256, size=(128, 128), dtype=np.uint8)
image = to_spatial_image(array)
multiscale = to_multiscale(image, [2, 4])

Requires Python 3.11 or later; spatial-image dependency must be installed first to create the base spatial image object.

Verify before relying:

- Performance characteristics and memory efficiency when handling very large image datasets
- Supported downsampling methods beyond the examples shown (coarsen, resampling strategies)
- Compatibility with specific OME-NGFF versions and zarr store configurations

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 95.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

multiscale image pyramid generation, ome-ngff zarr serialization, xarray spatial image downsampling, dask chunked image processing, multiscale scientific imaging, spatial metadata preservation, image coarsening and resampling, imaging, multiscale-pyramids, ome-ngff

[View on SkillFed](https://skillfed.io/packages/multiscale-spatial-image) · [View on PyPI](https://pypi.org/project/multiscale-spatial-image/)