Skip to main content

rasterio

Fast and direct raster I/O for Python programmers who use Numpy.

This package is aimed at developers who want little more than to read raster images into Numpy arrays or buffers, operate on them in Python (or Cython), and write the results out to new raster files.

Rasterio employs GDAL under the hood for file I/O and raster formatting.

Example

Here’s an example of the features rasterio aims to provide.

import rasterio
import subprocess

# Read raster bands directly to Numpy arrays.
with rasterio.open('rasterio/tests/data/RGB.byte.tif') as src:
    r = src.read_band(0)
    g = src.read_band(1)
    b = src.read_band(2)
    assert [b.dtype.type for b in (r, g, b)] == src.dtypes

# Combine arrays using the 'add' ufunc. Expecting that the sum will exceed the
# 8-bit integer range, I convert to float32.
r = r.astype(rasterio.float32)
g = g.astype(rasterio.float32)
b = b.astype(rasterio.float32)
total = (r + g + b)/3.0

# Write the product as a raster band to a new 8-bit file. For keyword
# arguments, 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.
with rasterio.open(
        '/tmp/total.tif', 'w',
        **dict(
            src.meta,
            **{'dtype': rasterio.uint8, 'count':1, 'compress': 'lzw'})
        ) as dst:
    dst.write_band(0, total.astype(rasterio.uint8))

# Dump out gdalinfo's report card.
info = subprocess.check_output(['gdalinfo', '-stats', '/tmp/total.tif'])
print(info)

Dependencies

C library dependecies:

  • GDAL

Python package dependencies:

  • numpy

  • six

  • Tests require nose

Testing

From the repo directory, run nosetests.

$ nosetests

License

See LICENSE.txt

Authors

See AUTHORS.txt

Changes

See CHANGES.txt

Metadata

Release files for rasterio 0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rasterio 0.1
File Size Uploaded
rasterio-0.1.tar.gz 81.6 kB Details

Release files / rasterio-0.1.tar.gz

Download URL rasterio-0.1.tar.gz
Size 81.6 kB
Tags Source
SHA-256 checksum
How to use checksums
aeb12df73e09179f12b70221e3f1ae5fa517367bf84864ee4336cd6e5e51b307
BLAKE2b-256 checksum
How to use checksums
be30e7e6c08e3ac9cd1d084e271d0bc345a3728c0887f99577c9f4359343d51c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

1.5.2

37 release files

1.4.4

42 release files

1.4.2

21 release files

1.4.0

21 release files

1.3.9

21 release files

1.3.8

17 release files

1.3.7

17 release files

1.3.6

17 release files

1.3.5

17 release files

1.3.4

13 release files

1.3.3

13 release files

1.3.2

10 release files

1.3.1

10 release files

1.2.10

9 release files

1.2.9

9 release files

1.2.8

9 release files

1.2.7

9 release files

1.2.6

9 release files

1.2.5

9 release files

1.2.4

9 release files

1.2.3

9 release files

1.2.2

9 release files

1.2.1

9 release files

1.2.0

9 release files

1.1.8

19 release files

1.1.7

10 release files

1.1.6

10 release files

1.1.3

11 release files

1.1.2

11 release files

1.1.1

11 release files

1.1.0

9 release files

1.0.26

9 release files

1.0.9

11 release files

1.0.7

10 release files

1.0.6

10 release files

1.0.5

10 release files

1.0.4

10 release files

1.0.2

12 release files

1.0.1

12 release files

1.0.0

12 release files

0.36.0

4 release files

0.32.0

4 release files

0.31.0

3 release files

0.30.0

3 release files

0.29.0

3 release files

0.27.0

3 release files

0.26.0

3 release files

0.25.0

3 release files

0.24.0

3 release files

0.21.0

3 release files

0.19.1

3 release files

0.19.0

3 release files

0.18

3 release files

0.17.1

3 release files

0.17

3 release files

0.16

1 release file

0.15.1

1 release file

0.15

1 release file

0.14.1

1 release file

0.14

1 release file

0.13.2

1 release file

0.13.1

1 release file

0.13

2 release files

0.12

3 release files

0.11.1

3 release files

0.11

3 release files

0.10.1

3 release files

0.10

3 release files

0.9

1 release file

0.8

1 release file

0.7.3

1 release file

0.7.2

1 release file

0.7.1

1 release file

0.7

1 release file

0.6

1 release file

0.5.1

1 release file

0.5

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

This release

0.1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page