{"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,"search_vec":"'2026.4.1':31 'analysi':21 'approxim':33 'averag':26 'awar':20 'climat':12,38 'current':29 'data':16 'extens':6 'global':14 'grid':11,19,37 'grid-awar':18 'month':34 'oper':22 'provid':17 'releas':32 'remap':25 'unstructur':10,36 'unstructured-grid':35 'uxarray':1,2 'version':30 'visual':28,41 'weather':15,39 'work':8 'xarray':5,40","created_at":"2026-05-01T08:15:00.609212+00:00","updated_at":"2026-05-01T08:15:00.609212+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2026.6.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://uxarray.dev","github":"https://github.com/UXARRAY/uxarray","docs":"https://uxarray.readthedocs.io/","changelog":null,"pypi":"https://pypi.org/project/uxarray/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","observability"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}