large-image-source-rasterio

1.34.1 verified Sat May 09 auth: no python

A rasterio tilesource for large_image, enabling geospatial raster tile serving via GDAL/rasterio. Current version 1.34.1, part of the large_image ecosystem with frequent releases.

pip install large-image-source-rasterio

Common errors

error ModuleNotFoundError: No module named 'large_image_source_rasterio' ↓

cause Missing installation or incorrect import name.

fix

Run pip install large-image-source-rasterio and import as large_image_source_rasterio.

error large_image_source_rasterio.RasterioFileTileSource not found ↓

cause The class name changed in v1.30 or later.

fix

Use from large_image_source_rasterio import RasterioFileTileSource and call via getTileSource().

error RuntimeError: Tile not available at this level ↓

cause Requested zoom level exceeds source's cache or GDAL constraints.

fix

Ensure tile level is within the source's min/max zoom: source.getMetadata()['levels'].

Warnings

breaking Python 3.10 or later is required; Python 3.9 and earlier are unsupported. ↓

fix Upgrade Python to 3.10+.

gotcha The module name uses underscores: large_image_source_rasterio, not hyphens. ↓

fix Use `import large_image_source_rasterio` with underscores.

deprecated Direct instantiation of RasterioFileTileSource is discouraged; use large_image.getTileSource() for auto-detection. ↓

fix Replace `RasterioFileTileSource(path)` with `getTileSource(path)`.

gotcha GDAL and necessary drivers must be installed separately for rasterio to work. ↓

fix Install GDAL system package (e.g., `apt install libgdal-dev`) or use conda.

Imports

RasterioFileTileSource

wrong

from large_image.tilesource.rasterio import ...

correct

from large_image_source_rasterio import RasterioFileTileSource

Incorrect path; the correct module is large_image_source_rasterio.

Quickstart

Basic example to open a rasterio source and get a tile.

from large_image_source_rasterio import RasterioFileTileSource
from large_image import getTileSource

# Open a GeoTIFF file
source = getTileSource('path/to/geotiff.tif')
# Access metadata
print(source.getMetadata())
# Request a tile (x, y, z)
tile = source.getTile(0, 0, 0)
print(tile.shape)