uxarray

library2026.6.0pypypi✓ verified 88d ago

UXarray is an Xarray extension for working with unstructured grid climate and global weather data, providing grid-aware analysis operations such as remapping, averaging, and visualization. Current version: 2026.4.1. Released approximately monthly.

data observability

pip install uxarray

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · UXARRAY

uxarray

datapythonv2026.6.0

Install

40.2s avg

Import

42076ms

Disk

1454MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 40.2s · import 42.076s · 1433.6MB

1454MB installed

● package 1454MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

UxDataset

✓ from uxarray import UxDataset

UxDataArray

✓ from uxarray import UxDataArray

Grid

✓ from uxarray import Grid

open_dataset

✓ from uxarray import open_dataset

✗ from uxarray.core import open_dataset

The internal path is not public API.

Open an unstructured grid dataset and perform basic operations.

import uxarray as ux # Open an unstructured grid dataset ds = ux.open_dataset("https://raw.githubusercontent.com/UXARRAY/uxarray/main/test/meshfiles/geoflow-small.nc") # Print the grid print(ds.uxgrid) # Compute the mean of a variable (if present) if 'var' in ds: print(ds['var'].mean()) # Visualize the grid ds.uxgrid.plot.mesh()

Debug

Known issues

breakingRequires Python >= 3.10. Older Python versions are not supported.

fix

Upgrade to Python 3.10 or higher.

affects: < 2026.4.1

breakingUXarray v2026.4.0+ is not compatible with xarray < 2026.4.0. Breaking changes in xarray 2026.4.0 required updates.

fix

Update xarray to version 2026.4.0 or later: pip install 'xarray>=2026.4.0'.

affects: >= 2026.4.0

gotchaWhen opening datasets, the grid topology must be present in the file. Opening a standard structured grid file (e.g., regular lat/lon) will fail or produce unexpected results.

fix

Ensure your file is an unstructured grid format (e.g., UGRID, MPAS, SCRIP, ESMF). For structured data, use xarray directly.

affects: all

gotchaGrid parsing can be strict. Files with missing or non-standard metadata may not load. For example, the ICON reader checks for required attributes.

fix

Verify your file conforms to the expected conventions. Refer to the grid parsing documentation.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'uxarray'

uxarray is not installed.

fix

Run 'pip install uxarray' or 'conda install -c conda-forge uxarray'.

ImportError: cannot import name 'open_dataset' from 'uxarray'

Using an old version that does not export 'open_dataset' at the top level.

fix

Upgrade uxarray: 'pip install --upgrade uxarray'.

ValueError: Grid type not recognized or unsupported format

The file does not contain a recognized unstructured grid format or has missing attributes.

fix

Check that the file is a supported format (UGRID, MPAS, etc.) and contains required grid topology variables. Use 'uxarray.Grid.from_file()' for more control.

Upgrade

Version history

2026.6.0latest on PyPI · released Jun 18, 2026

Audit

Dependencies

xarrayrequiredCore dependency for data structures and operations.

numpyrequiredArray operations.

matplotliboptionalPlotting support.

Agent activity

45 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/UXARRAY/uxarray ↗

packagehttps://pypi.org/project/uxarray/ ↗

homepagehttps://uxarray.dev ↗

docshttps://uxarray.readthedocs.io/ ↗