Skip to content

v2026.10.1

Latest

Choose a tag to compare

@rajeeja rajeeja released this 30 Oct 22:18
79b7aa6

👻 🎃 Happy Halloween! 🎃

🚀 UXARRAY v2026.10.1

Our second October release brings contour plotting, multidimensional calculus, Dataset-level averaging methods, faster visualization, and numerical accuracy improvements.

Try it out and help us find what breaks! Please open an issue with bugs or ideas for new functionality, and join our community meetings to discuss what you'd like to see next.

🌟 Highlights

  • Contour plotting on unstructured grids. New UxDataArray.plot.contour() supports face- and node-centered fields, interactive plots, optional Matplotlib output, and contour labels, with new visualization examples (#1812).
  • Calculus across additional dimensions. gradient(), curl(), divergence(), and scalardotgradient() now support arrays containing additional dimensions such as time and vertical levels, with improved result names, units, and metadata (#1823).
  • Averaging methods for whole Datasets. UxDataset now provides zonal_mean(), zonal_anomaly(), azimuthal_mean(), and weighted_mean(), plus the corresponding average aliases (#1803).

⚠️ Compatibility Changes

  • Python 3.12 or newer is now required. Python 3.11 support has been removed. Visualization extras require Cartopy >=0.26.0 and GeoViews >=1.16.0; the Matplotlib <3.11 restriction is removed (#1850).
  • Previously deprecated APIs have been removed. Use Grid.subset instead of Grid.cross_section, and Grid.attrs instead of Grid.parsed_attrs. The constant-latitude and constant-longitude selection methods formerly accessed through UxDataArray.cross_section now belong under UxDataArray.subset (#1851).
  • Replace exclude_antimeridian with periodic_elements. For to_geodataframe(), use periodic_elements="exclude" for the former True behavior and "split" for the former False behavior (#1851).
  • Deprecated gradient(use_magnitude=..., normalize=...) and divergence(units=...) arguments are removed. Calculus methods no longer silently ignore unsupported keyword arguments (#1823).

✨ Enhancements

  • Faster to_raster() through candidate pruning using individual face radii, with a new Grid.compute_face_radii() method (#1825).
  • Faster polygon plotting with periodic_elements="split" through more efficient MultiPolygonArray construction (#1833).
  • Lazy longitude normalization avoids unnecessary computation when constructing, copying, or subsetting Dask-backed grids (#1791).
  • Clearer type annotations distinguish parameters that accept None from those that do not (#1862).

🐛 Bug Fixes

  • More accurate angle calculations for nearly parallel vectors using compensated differences of products (#1863).
  • Weighted means now reduce along the grid dimension regardless of dimension order, with improved coordinate alignment and weight validation (#1803).
  • Node-centered weighted_mean() when explicit weights are not provided now crashes with a DataCenteringError, instead of AttributeError: 'NoneType' object has no attribute 'sum' (#1803).
  • Prevents Numba workqueue process aborts and reduces OpenMP thread oversubscription when parallel kernels run inside thread pools (#1797).
  • Exodus export correctly handles mixed-size faces and connectivity padding. Mixed meshes are grouped by face size during export, so their original face order is not preserved (#1752).

📚 Documentation

  • New contour visualization tutorials and multidimensional calculus examples (#1812, #1823).
  • Dataset-level averaging examples and API documentation (#1803).
  • Installation guidance for uxarray-base, uxarray-with-geo, and uxarray-with-viz; the uxarray conda package continues to include all recommended dependencies (#1840).

⚙️ CI & Maintenance

  • Updates the PyPI publishing action to include its certificate trust-store security fix, alongside Python setup and uv action updates (#1852, #1826).
  • Pins the Miniforge installer version for more reproducible CI setup (#1843).
  • Restricts token permissions in scheduled CI workflows (#1820).

👏 Contributors

Thank you to @cmdupuis3, @dylannelson, @erogluorhan, @hongyuchen1030, @rajeeja, @Sevans711, and @dependabot[bot].

📦 Full Changelog

v2026.10.0...v2026.10.1