large-image-source-gdal

1.34.1 verified Sat May 09 auth: no python

A GDAL-based tile source for large_image, enabling reading geospatial raster formats (GeoTIFF, JPEG2000, etc.) as tile pyramids. Version 1.34.1, actively maintained, part of the girder/large_image ecosystem. Release cadence: ~monthly.

pip install large-image-source-gdal

Common errors

error ImportError: No module named 'large_image_source_gdal' ↓

cause The package is not installed.

fix

Run: pip install large-image-source-gdal

error large_image_source_gdal.GDALFileTileSource - ERROR - Failed to open dataset ↓

cause GDAL library not installed or file path invalid.

fix

Install GDAL system library (e.g., conda install gdal) and verify the file path exists and is readable.

error AttributeError: module 'large_image_source_gdal' has no attribute 'GDALFileTileSource' ↓

cause Wrong import path; trying to import from wrong module.

fix

Use: from large_image_source_gdal import GDALFileTileSource

Warnings

gotcha GDAL must be installed and available on the system PATH. pip install of the Python package does NOT install the GDAL C library. ↓

fix Install GDAL via conda (conda install gdal) or system package manager (apt install gdal-bin libgdal-dev).

gotcha Tile coordinates (x, y, z) follow the large_image convention: x and y are column/row at the given zoom level. Starting at 0/0/0 for the top-left tile. Misalignment with standard GIS tiling schemes (e.g., TMS) is common. ↓

fix Use large_image's internal coordinate system; convert from TMS using source.tileXYToLatLng or similar helpers.

deprecated Girder integration is marked for removal (girder < 5). Rely on pure large_image usage without girder dependency. ↓

fix Use large-image-source-gdal without the girder extra: pip install large-image-source-gdal (no [girder]).

Imports

GDALFileTileSource
wrong
```
from large_image import GDALFileTileSource
```
correct
```
from large_image_source_gdal import GDALFileTileSource
```
GDALFileTileSource is in the separate source package, not in the core large_image.

Quickstart

Open a GeoTIFF and fetch a single tile.

from large_image_source_gdal import GDALFileTileSource
source = GDALFileTileSource('path/to/geotiff.tif')
tile = source.getTile(0, 0, 0)
print(tile.shape)