Registry / data / large-image-source-gdal

large-image-source-gdal

JSON →
library1.34.1pypypiunverified

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
INSTALL
IMPORT
SIG · LARGE-IMAGE-SOURCE
L
large-image-source-gdal
datapythonv1.34.1
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

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

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

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)
Debug
Known issues
gotchaGDAL 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).
affects: all
gotchaTile 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.
affects: all
deprecatedGirder 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]).
affects: >=1.34.0
Upgrade
Version history
1.34.1latest on PyPI · released Mar 24, 2026
Audit
Dependencies
GDALrequiredRequired runtime dependency for raster access via GDAL
large-imagerequiredCore framework; provides base tile source abstraction
Agent activity
10 hits · last 30 days
node
2
Resources