Registry / data / uxarray

uxarray

JSON →
library2026.4.1pypypi✓ verified 34d 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.

dataobservability
github ↗package ↗homepage ↗docs ↗
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

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

from uxarray import UxDataset
from uxarray import UxDataArray
from uxarray import Grid

The internal path is not public API.

from uxarray import open_dataset

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 footguns
breakingRequires Python >= 3.10. Older Python versions are not supported.
breakingUXarray v2026.4.0+ is not compatible with xarray < 2026.4.0. Breaking changes in xarray 2026.4.0 required updates.
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.
gotchaGrid parsing can be strict. Files with missing or non-standard metadata may not load. For example, the ICON reader checks for required attributes.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
0 hits · last 30 days

No traffic data recorded yet.

Resources
githubhttps://github.com/UXARRAY/uxarray ↗
packagehttps://pypi.org/project/uxarray/ ↗
homepagehttps://uxarray.dev ↗
docshttps://uxarray.readthedocs.io/ ↗