rasterio is a Python package which aims to provide a friendlier API to GDAL than GDAL’s own Python API (which feels very C-like). It is an open source project on GitHub that is created and maintained by mapbox.
Most of the code examples below assume you have imported
rasterio into the current module with:
rasterio’s API documentation can be found at https://rasterio.readthedocs.io/en/stable/index.html. Be warned that it is very incomplete (as of November 2019) — there is missing documentation for many
Reading A GeoTIFF
There are two common ways to do this, with or without a context manager.
With a context manager:
with rasterio.open('example.tif') as dataset: pixels = dataset.read() # This will read all bands # Dataset (the file) is closed automatically once you leave the context
Without a context manager:
dataset = rasterio.open('example.tif') pixels = dataset.read() # You have to remember to close the dataset yourself
reproject() does not create the destination array for you, you have to create the array yourself and pass it into the function.
rasterio.reproject( src_array, dst_array, src_transform, src_crs, dst_transform, dst_crs, resampling)
rasterio._err.CPLE_AppDefinedError: Too many points (10201 out of 10201) failed to transform, unable to compute output bounds.
This error usually occurs if you are trying to reproject an image into a projection space that does not contain the image (e.g. images are in completely different UTM zones).
- May 2017 Updates
- September 2019 Updates
- An Introduction To Asynchronous Programming In Python