{"id":27912,"library":"large-image-source-rasterio","title":"large-image-source-rasterio","description":"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.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","rasterio","geospatial","tiles","girder"],"install":[{"cmd":"pip install large-image-source-rasterio","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core library providing the tile source framework.","package":"large-image","optional":false},{"reason":"Required for geospatial raster reading via GDAL.","package":"rasterio","optional":false}],"imports":[{"note":"Incorrect path; the correct module is large_image_source_rasterio.","wrong":"from large_image.tilesource.rasterio import ...","symbol":"RasterioFileTileSource","correct":"from large_image_source_rasterio import RasterioFileTileSource"}],"quickstart":{"code":"from large_image_source_rasterio import RasterioFileTileSource\nfrom large_image import getTileSource\n\n# Open a GeoTIFF file\nsource = getTileSource('path/to/geotiff.tif')\n# Access metadata\nprint(source.getMetadata())\n# Request a tile (x, y, z)\ntile = source.getTile(0, 0, 0)\nprint(tile.shape)","lang":"python","description":"Basic example to open a rasterio source and get a tile."},"warnings":[{"fix":"Upgrade Python to 3.10+.","message":"Python 3.10 or later is required; Python 3.9 and earlier are unsupported.","severity":"breaking","affected_versions":">=1.30"},{"fix":"Use `import large_image_source_rasterio` with underscores.","message":"The module name uses underscores: large_image_source_rasterio, not hyphens.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace `RasterioFileTileSource(path)` with `getTileSource(path)`.","message":"Direct instantiation of RasterioFileTileSource is discouraged; use large_image.getTileSource() for auto-detection.","severity":"deprecated","affected_versions":"all"},{"fix":"Install GDAL system package (e.g., `apt install libgdal-dev`) or use conda.","message":"GDAL and necessary drivers must be installed separately for rasterio to work.","severity":"gotcha","affected_versions":"all"}],"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-rasterio` and import as `large_image_source_rasterio`.","cause":"Missing installation or incorrect import name.","error":"ModuleNotFoundError: No module named 'large_image_source_rasterio'"},{"fix":"Use `from large_image_source_rasterio import RasterioFileTileSource` and call via `getTileSource()`.","cause":"The class name changed in v1.30 or later.","error":"large_image_source_rasterio.RasterioFileTileSource not found"},{"fix":"Ensure tile level is within the source's min/max zoom: `source.getMetadata()['levels']`.","cause":"Requested zoom level exceeds source's cache or GDAL constraints.","error":"RuntimeError: Tile not available at this level"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}