Fast and direct raster I/O for use with Numpy and SciPy

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for seang from gravatar.com seang

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: BSD License (BSD)
  • Author: Sean Gillies
  • Tags raster, gdal
  • Requires: Python >=3.9
Classifiers

Project description

Rasterio reads and writes geospatial raster data.

https://github.com/rasterio/rasterio/actions/workflows/tests.yaml/badge.svg https://github.com/rasterio/rasterio/actions/workflows/test_gdal_latest.yaml/badge.svg https://github.com/rasterio/rasterio/actions/workflows/test_gdal_tags.yaml/badge.svg https://img.shields.io/pypi/v/rasterio

Geographic information systems use GeoTIFF and other formats to organize and store gridded, or raster, datasets. Rasterio reads and writes these formats and provides a Python API based on N-D arrays.

Rasterio 1.4 works with Python >= 3.9, Numpy >= 1.24, and GDAL >= 3.5. Official binary packages for Linux, macOS, and Windows with most built-in format drivers plus HDF5, netCDF, and OpenJPEG2000 are available on PyPI.

Read the documentation for more details: https://rasterio.readthedocs.io/.

Example

Here’s an example of some basic features that Rasterio provides. Three bands are read from an image and averaged to produce something like a panchromatic band. This new band is then written to a new single band TIFF.

import numpy as np
import rasterio

# Read raster bands directly to Numpy arrays.
#
with rasterio.open('tests/data/RGB.byte.tif') as src:
    r, g, b = src.read()

# Combine arrays in place. Expecting that the sum will
# temporarily exceed the 8-bit integer range, initialize it as
# a 64-bit float (the numpy default) array. Adding other
# arrays to it in-place converts those arrays "up" and
# preserves the type of the total array.
total = np.zeros(r.shape)

for band in r, g, b:
    total += band

total /= 3

# Write the product as a raster band to a new 8-bit file. For
# the new file's profile, we start with the meta attributes of
# the source file, but then change the band count to 1, set the
# dtype to uint8, and specify LZW compression.
profile = src.profile
profile.update(dtype=rasterio.uint8, count=1, compress='lzw')

with rasterio.open('example-total.tif', 'w', **profile) as dst:
    dst.write(total.astype(rasterio.uint8), 1)

The output:

http://farm6.staticflickr.com/5501/11393054644_74f54484d9_z_d.jpg

API Overview

Rasterio gives access to properties of a geospatial raster file.

with rasterio.open('tests/data/RGB.byte.tif') as src:
    print(src.width, src.height)
    print(src.crs)
    print(src.transform)
    print(src.count)
    print(src.indexes)

# Printed:
# (791, 718)
# {u'units': u'm', u'no_defs': True, u'ellps': u'WGS84', u'proj': u'utm', u'zone': 18}
# Affine(300.0379266750948, 0.0, 101985.0,
#        0.0, -300.041782729805, 2826915.0)
# 3
# [1, 2, 3]

A rasterio dataset also provides methods for getting read/write windows (like extended array slices) given georeferenced coordinates.

with rasterio.open('tests/data/RGB.byte.tif') as src:
    window = src.window(*src.bounds)
    print(window)
    print(src.read(window=window).shape)

# Printed:
# Window(col_off=0.0, row_off=0.0, width=791.0000000000002, height=718.0)
# (3, 718, 791)

Rasterio CLI

Rasterio’s command line interface, named “rio”, is documented at cli.rst. Its rio insp command opens the hood of any raster dataset so you can poke around using Python.

$ rio insp tests/data/RGB.byte.tif
Rasterio 0.10 Interactive Inspector (Python 3.4.1)
Type "src.meta", "src.read(1)", or "help(src)" for more information.
>>> src.name
'tests/data/RGB.byte.tif'
>>> src.closed
False
>>> src.shape
(718, 791)
>>> src.crs
{'init': 'epsg:32618'}
>>> b, g, r = src.read()
>>> b
masked_array(data =
 [[-- -- -- ..., -- -- --]
 [-- -- -- ..., -- -- --]
 [-- -- -- ..., -- -- --]
 ...,
 [-- -- -- ..., -- -- --]
 [-- -- -- ..., -- -- --]
 [-- -- -- ..., -- -- --]],
             mask =
 [[ True  True  True ...,  True  True  True]
 [ True  True  True ...,  True  True  True]
 [ True  True  True ...,  True  True  True]
 ...,
 [ True  True  True ...,  True  True  True]
 [ True  True  True ...,  True  True  True]
 [ True  True  True ...,  True  True  True]],
       fill_value = 0)

>>> np.nanmin(b), np.nanmax(b), np.nanmean(b)
(0, 255, 29.94772668847656)

Rio Plugins

Rio provides the ability to create subcommands using plugins. See cli.rst for more information on building plugins.

See the plugin registry for a list of available plugins.

Installation

See docs/installation.rst

Support

The primary forum for questions about installation and usage of Rasterio is https://rasterio.groups.io/g/main. The authors and other users will answer questions when they have expertise to share and time to explain. Please take the time to craft a clear question and be patient about responses.

Please do not bring these questions to Rasterio’s issue tracker, which we want to reserve for bug reports and other actionable issues.

Development and Testing

See CONTRIBUTING.rst.

Documentation

See docs/.

License

See LICENSE.txt.

Authors

The rasterio project was begun at Mapbox and was transferred to the rasterio Github organization in October 2021.

See AUTHORS.txt.

Changes

See CHANGES.txt.

Who is Using Rasterio?

See here.

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for seang from gravatar.com seang

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: BSD License (BSD)
  • Author: Sean Gillies
  • Tags raster, gdal
  • Requires: Python >=3.9
Classifiers

Release history Release notifications | RSS feed

This version

1.4.2

1.4.1

1.4.0

1.4.0rc2 pre-release

1.4.0rc1 pre-release

1.4b2 pre-release

1.4b1 pre-release

1.4a3 pre-release

1.4a2 pre-release

1.4a1 pre-release

1.3.11

1.3.10

1.3.9

1.3.8.post2

1.3.8.post1

1.3.8

1.3.7

1.3.6

1.3.5.post1

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0.post1

1.3.0

1.3b3 pre-release

1.3b2 pre-release

1.3b1 pre-release

1.3a4 pre-release

1.3a3 pre-release

1.3a2 pre-release

1.3a1 pre-release

1.2.10

1.2.10.dev0 pre-release

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.2b4 pre-release

1.2b3 pre-release

1.2b2 pre-release

1.2b1 pre-release

1.2a1 pre-release

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.1b3 pre-release

1.1b2 pre-release

1.1b1 pre-release

1.0.28

1.0.27

1.0.26

1.0.25

1.0.24

1.0.23

1.0.22

1.0.21

1.0.20

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3.post1

1.0.3

1.0.2

1.0.1

1.0.0

1.0rc5 pre-release

1.0rc4 pre-release

1.0rc3 pre-release

1.0rc2 pre-release

1.0rc1 pre-release

1.0b4 pre-release

1.0b3 pre-release

1.0b2 pre-release

1.0b1 pre-release

1.0a12 pre-release

1.0a11 pre-release

1.0a10 pre-release

1.0a9 pre-release

1.0a8 pre-release

1.0a7 pre-release

0.36.0

0.35.1

0.35.0.post1

0.35.0

0.34.0

0.33.0

0.32.0.post1

0.32.0

0.31.0

0.30.0

0.29.0

0.28.0

0.27.0

0.26.0

0.25.0

0.24.1

0.24.0

0.23.0

0.22.0

0.21.0

0.20.0

0.19.1

0.19.0

0.18

0.17.1

0.17

0.16

0.15.1

0.15

0.14.1

0.14

0.13.2

0.13.1

0.13

0.12.1

0.12

0.11.1

0.11

0.10.1

0.10

0.9

0.8

0.7.3

0.7.2

0.7.1

0.7

0.6

0.5.1

0.5

0.4

0.3

0.2

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rasterio-1.4.2.tar.gz (441.4 kB view hashes)

Uploaded Source

Built Distributions

rasterio-1.4.2-cp313-cp313-win_amd64.whl (25.4 MB view hashes)

Uploaded CPython 3.13 Windows x86-64

rasterio-1.4.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ x86-64

rasterio-1.4.2-cp313-cp313-macosx_14_0_arm64.whl (18.7 MB view hashes)

Uploaded CPython 3.13 macOS 14.0+ ARM64

rasterio-1.4.2-cp313-cp313-macosx_10_15_x86_64.whl (21.5 MB view hashes)

Uploaded CPython 3.13 macOS 10.15+ x86-64

rasterio-1.4.2-cp312-cp312-win_amd64.whl (25.4 MB view hashes)

Uploaded CPython 3.12 Windows x86-64

rasterio-1.4.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

rasterio-1.4.2-cp312-cp312-macosx_14_0_arm64.whl (18.7 MB view hashes)

Uploaded CPython 3.12 macOS 14.0+ ARM64

rasterio-1.4.2-cp312-cp312-macosx_10_15_x86_64.whl (21.5 MB view hashes)

Uploaded CPython 3.12 macOS 10.15+ x86-64

rasterio-1.4.2-cp311-cp311-win_amd64.whl (25.4 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

rasterio-1.4.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

rasterio-1.4.2-cp311-cp311-macosx_14_0_arm64.whl (18.8 MB view hashes)

Uploaded CPython 3.11 macOS 14.0+ ARM64

rasterio-1.4.2-cp311-cp311-macosx_10_15_x86_64.whl (21.5 MB view hashes)

Uploaded CPython 3.11 macOS 10.15+ x86-64

rasterio-1.4.2-cp310-cp310-win_amd64.whl (25.4 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

rasterio-1.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

rasterio-1.4.2-cp310-cp310-macosx_14_0_arm64.whl (18.8 MB view hashes)

Uploaded CPython 3.10 macOS 14.0+ ARM64

rasterio-1.4.2-cp310-cp310-macosx_10_15_x86_64.whl (21.5 MB view hashes)

Uploaded CPython 3.10 macOS 10.15+ x86-64

rasterio-1.4.2-cp39-cp39-win_amd64.whl (25.4 MB view hashes)

Uploaded CPython 3.9 Windows x86-64

rasterio-1.4.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

rasterio-1.4.2-cp39-cp39-macosx_14_0_arm64.whl (18.8 MB view hashes)

Uploaded CPython 3.9 macOS 14.0+ ARM64

rasterio-1.4.2-cp39-cp39-macosx_10_15_x86_64.whl (21.5 MB view hashes)

Uploaded CPython 3.9 macOS 10.15+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page