skillfed

rioxarray

geospatial xarray extension powered by rasterio

rioxarray v0.23.0 1.1M downloads/30d#4,306 on PyPI621
Permissive license Apache-2.0 Active released

What it is and what it does

rioxarray is an xarray extension that adds geospatial and raster-specific operations to xarray DataArrays and Datasets. It bridges xarray's labeled array interface with rasterio's raster I/O and geospatial capabilities, letting you work with georeferenced gridded data—satellite imagery, climate models, digital elevation models—using xarray's familiar syntax and operations.

The package handles common geospatial tasks like reading and writing raster files, reprojecting between coordinate reference systems, clipping to geographic bounds, and managing spatial metadata. It depends on rasterio for raster I/O, xarray for the array interface, pyproj for coordinate transformations, and numpy for underlying computation. It's actively maintained and supports Python 3.12 and later.

Use it for:

  • Load satellite or aerial imagery into xarray and perform analysis using labeled dimensions and coordinate-aware slicing
  • Reproject raster data between different coordinate reference systems while preserving spatial metadata
  • Read and write raster formats with automatic coordinate and CRS metadata handling
  • Clip raster datasets to geographic regions using coordinate-aware operations
  • Combine raster analysis with xarray's groupby, resample, and aggregation operations for time-series or multi-band data

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

rioxarray extends xarray with geospatial and raster operations powered by rasterio, enabling you to work with georeferenced gridded data using familiar xarray syntax.

Yes. rioxarray is actively maintained, has no known vulnerabilities, installs with low friction, and fills a genuine gap for developers working with geospatial gridded data in Python. If you use xarray and need raster operations or geospatial metadata handling, it's the standard choice. The Apache-2.0 license is permissive for all use cases.

Install

rioxarray on PyPI

pip

pip install rioxarray

uv

uv add rioxarray

poetry

poetry add rioxarray

Installing rioxarray

Before you install

Low friction install with a stable dependency chain. The package is actively maintained (last commit 2026-07-27, 18 days since release) and supports current Python versions (3.12, 3.13, 3.14). Five runtime dependencies are all well-established geospatial and scientific libraries.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions. The package also includes Apache-licensed code adopted from other projects, with those licenses bundled in the repository.

Quickstart

pip install rioxarray
import rioxarray
import xarray as xr
data = rioxarray.open_rasterio('file.tif')

Requires rasterio, which depends on system-level GDAL/GEOS libraries that may need separate installation depending on your platform.

Verify before relying

  • Whether GDAL/GEOS system dependencies are pre-installed or require separate setup on your platform
  • Performance characteristics when working with very large raster datasets or complex reprojection operations

Package facts

License Apache-2.0 (permissive)
Python support supports the current Python release (>=3.12)
Install friction low — pure-Python wheel
Runtime dependencies 5 — packaging, rasterio, xarray, pyproj, numpy
Maintenance actively maintained — 18 days since the last release
Last repo commit
First released
Downloads 1,141,789/month — #4,306 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: rioxarray-0.23.0-py3-none-any.whl

Keywords: rioxarray, xarray, rasterio

Development Status :: 4 - BetaIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/Engineering :: GISTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed

Tags

xarray raster geospatialrasterio xarray extensiongeoreferenced gridded datageospatial data analysis pythonraster reprojection xarraycoordinate reference system xarrayraster io with xarray
geospatialraster-dataxarray-extension

More Python Modules packages