Repository navigation
👻 🎃 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(), andscalardotgradient()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.
UxDatasetnow provideszonal_mean(),zonal_anomaly(),azimuthal_mean(), andweighted_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.11restriction is removed (#1850). - Previously deprecated APIs have been removed. Use
Grid.subsetinstead ofGrid.cross_section, andGrid.attrsinstead ofGrid.parsed_attrs. The constant-latitude and constant-longitude selection methods formerly accessed throughUxDataArray.cross_sectionnow belong underUxDataArray.subset(#1851). - Replace
exclude_antimeridianwithperiodic_elements. Forto_geodataframe(), useperiodic_elements="exclude"for the formerTruebehavior and"split"for the formerFalsebehavior (#1851). - Deprecated
gradient(use_magnitude=..., normalize=...)anddivergence(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 newGrid.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
Nonefrom 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 ofAttributeError: '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, anduxarray-with-viz; theuxarrayconda 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].