{"id":24803,"library":"uxarray","title":"uxarray","description":"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.","status":"active","version":"2026.4.1","language":"python","source_language":"en","source_url":"https://github.com/UXARRAY/uxarray","tags":["unstructured-grid","climate","weather","xarray","visualization"],"install":[{"cmd":"pip install uxarray","lang":"bash","label":"Standard install"},{"cmd":"conda install -c conda-forge uxarray","lang":"bash","label":"Conda install"}],"dependencies":[{"reason":"Core dependency for data structures and operations.","package":"xarray","optional":false},{"reason":"Array operations.","package":"numpy","optional":false},{"reason":"Plotting support.","package":"matplotlib","optional":true}],"imports":[{"note":"","wrong":"","symbol":"UxDataset","correct":"from uxarray import UxDataset"},{"note":"","wrong":"","symbol":"UxDataArray","correct":"from uxarray import UxDataArray"},{"note":"","wrong":"","symbol":"Grid","correct":"from uxarray import Grid"},{"note":"The internal path is not public API.","wrong":"from uxarray.core import open_dataset","symbol":"open_dataset","correct":"from uxarray import open_dataset"}],"quickstart":{"code":"import uxarray as ux\n\n# Open an unstructured grid dataset\nds = ux.open_dataset(\"https://raw.githubusercontent.com/UXARRAY/uxarray/main/test/meshfiles/geoflow-small.nc\")\n\n# Print the grid\nprint(ds.uxgrid)\n\n# Compute the mean of a variable (if present)\nif 'var' in ds:\n    print(ds['var'].mean())\n\n# Visualize the grid\nds.uxgrid.plot.mesh()","lang":"python","description":"Open an unstructured grid dataset and perform basic operations."},"warnings":[{"fix":"Upgrade to Python 3.10 or higher.","message":"Requires Python >= 3.10. Older Python versions are not supported.","severity":"breaking","affected_versions":"< 2026.4.1"},{"fix":"Update xarray to version 2026.4.0 or later: pip install 'xarray>=2026.4.0'.","message":"UXarray v2026.4.0+ is not compatible with xarray < 2026.4.0. Breaking changes in xarray 2026.4.0 required updates.","severity":"breaking","affected_versions":">= 2026.4.0"},{"fix":"Ensure your file is an unstructured grid format (e.g., UGRID, MPAS, SCRIP, ESMF). For structured data, use xarray directly.","message":"When 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Verify your file conforms to the expected conventions. Refer to the grid parsing documentation.","message":"Grid parsing can be strict. Files with missing or non-standard metadata may not load. For example, the ICON reader checks for required attributes.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install uxarray' or 'conda install -c conda-forge uxarray'.","cause":"uxarray is not installed.","error":"ModuleNotFoundError: No module named 'uxarray'"},{"fix":"Upgrade uxarray: 'pip install --upgrade uxarray'.","cause":"Using an old version that does not export 'open_dataset' at the top level.","error":"ImportError: cannot import name 'open_dataset' from 'uxarray'"},{"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.","cause":"The file does not contain a recognized unstructured grid format or has missing attributes.","error":"ValueError: Grid type not recognized or unsupported format"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}