{"id":27906,"library":"large-image-source-gdal","title":"large-image-source-gdal","description":"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.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","gdal","geospatial","tiles","raster"],"install":[{"cmd":"pip install large-image-source-gdal","lang":"bash","label":"Default install from PyPI"}],"dependencies":[{"reason":"Required runtime dependency for raster access via GDAL","package":"GDAL","optional":false},{"reason":"Core framework; provides base tile source abstraction","package":"large-image","optional":false}],"imports":[{"note":"GDALFileTileSource is in the separate source package, not in the core large_image.","wrong":"from large_image import GDALFileTileSource","symbol":"GDALFileTileSource","correct":"from large_image_source_gdal import GDALFileTileSource"}],"quickstart":{"code":"from large_image_source_gdal import GDALFileTileSource\nsource = GDALFileTileSource('path/to/geotiff.tif')\ntile = source.getTile(0, 0, 0)\nprint(tile.shape)","lang":"python","description":"Open a GeoTIFF and fetch a single tile."},"warnings":[{"fix":"Install GDAL via conda (conda install gdal) or system package manager (apt install gdal-bin libgdal-dev).","message":"GDAL must be installed and available on the system PATH. pip install of the Python package does NOT install the GDAL C library.","severity":"gotcha","affected_versions":"all"},{"fix":"Use large_image's internal coordinate system; convert from TMS using source.tileXYToLatLng or similar helpers.","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use large-image-source-gdal without the girder extra: pip install large-image-source-gdal (no [girder]).","message":"Girder integration is marked for removal (girder < 5). Rely on pure large_image usage without girder dependency.","severity":"deprecated","affected_versions":">=1.34.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run: pip install large-image-source-gdal","cause":"The package is not installed.","error":"ImportError: No module named 'large_image_source_gdal'"},{"fix":"Install GDAL system library (e.g., conda install gdal) and verify the file path exists and is readable.","cause":"GDAL library not installed or file path invalid.","error":"large_image_source_gdal.GDALFileTileSource - ERROR - Failed to open dataset"},{"fix":"Use: from large_image_source_gdal import GDALFileTileSource","cause":"Wrong import path; trying to import from wrong module.","error":"AttributeError: module 'large_image_source_gdal' has no attribute 'GDALFileTileSource'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}