large-image

library1.34.2pypypi✓ verified 80d ago

A Python library for working with large, multiresolution images, supporting tiles, annotations, and warping. Current version is 1.34.1, with regular releases every few weeks.

data ai-ml

pip install large-image

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · LARGE-IMAGE

large-image

datapythonv1.34.2

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.34.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

1/2 runs

py 3.11

1/2 runs

py 3.12

1/2 runs

py 3.13

1/2 runs

py 3.9

1/2 runs

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

open

✓ from large_image import open

✗ from large_image import source

getTileSource

✓ from large_image import getTileSource

canRead

✓ from large_image import canRead

Opens a multiresolution image and retrieves a tile and a region.

from large_image import getTileSource # Open an image (replace with a path to a large image) source = getTileSource('path/to/large_image.svs') print('Image metadata:', source.getMetadata()) # Get a tile (x, y, z) - e.g., tile at top-left of level 0 tile = source.getTile(0, 0, 0) print('Tile shape:', tile.shape) # Get a region (format: {'left', 'top', 'right', 'bottom'}) region = source.getRegion(region={'left': 0, 'top': 0, 'right': 256, 'bottom': 256}) print('Region shape:', region.shape)

Debug

Known issues

gotchaTile coordinates (x, y, z) are integer tile indices, not pixel coordinates. Use getRegion for pixel-based cropping.

fix

Use getRegion with pixel coordinates if you need arbitrary rectangular crops.

affects: <1.34.0

deprecatedThe `large_image_source_tiff` and other per-format modules are deprecated in favor of the unified `source` API.

fix

Use `from large_image import source` or `getTileSource` directly.

affects: >=1.0

gotchaWhen installed without optional dependencies (e.g., OpenSlide, tifffile), unsupported image formats will raise an ImportError.

fix

Install with the appropriate extras: `pip install large-image[openslide,tiff]`.

affects: all

Upgrade

Version history

1.34.2latest on PyPI · released Jun 2, 2026

Audit

Dependencies

numpyrequiredUsed for image array operations

PillowrequiredUsed for basic image I/O

girderoptionalOptional Girder integration for server-side image serving

openslide-pythonoptionalOptional support for SVS/OME-TIFF via OpenSlide

tifffileoptionalOptional support for TIFF files

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/girder/large_image ↗

packagehttps://pypi.org/project/large-image/ ↗

homepagehttps://kitware.github.io/large-image/ ↗