v0.7.0

New hydrology, terrain metrics, and surface distance modules; 3D multi-band support for focal functions; GPU-accelerated polygonize with connected-component labelling; and broad dask+cupy backend coverage across the library.

New Features

• Add 3D multi-band support to focal functions (#924)
• Add foundational hydrology tools (#921)
• Add terrain metrics module: TRI, TPI, and Roughness (#920)
• Add surface_distance module: 3D terrain distance via multi-source Dijkstra (#918)
• Add CI benchmark workflow with regression detection (#917)
• Polygonize: GPU CCL, promotion, dispatcher, GeoJSON output, and benchmarks (#916)
• Add GPU (CuPy) backends for proximity, allocation, direction (#909)
• Add GPU (CuPy) backend for cost_distance (#910)
• Add out-of-core dask CPU viewshed (#897)
• Add dask+cupy backends for focal tools (#896)
• Add emerging_hotspots() for time-series trend analysis (#890)
• Replace O(n^4) regions() with scipy union-find, add dask/cupy backends (#898)

Bug Fixes & Improvements

• Make dask backends truly lazy, add agg parameter (#914)
• Fill remaining dask+cupy gaps (terrain, perlin, crosstab) (#913)
• Add comprehensive input validation across public API (#912)
• Fix dask zonal.stats() bug, add dask+cupy backend, edge-case tests (#911)
• Prevent OOM and unknown chunks in classify.py dask paths (#895)
• Replace np.unique/np.isfinite with dask-safe helpers in zonal.py (#894)
• Extend KDTree path to allocation/direction to prevent OOM (#893)
• Add memory guard and tiled KDTree fallback to proximity (#892)
• Add memory guard, bounded A*, and HPA* to prevent OOM (#891)

v0.6.0

What's Changed

• Fixes #560: weighted A* pathfinding with friction surface by @brendancol in #862
• Add GPU spill-to-CPU fallback for cost_distance by @brendancol in #863
• Fixes #864: remove local analysis module, add migration guide by @brendancol in #865
• added cupy support to true_color function by @brendancol in #866
• Fixes #748: align hillshade with GDAL and add dask+cupy backend by @brendancol in #867
• Fixes #790: add .xrs xarray accessors by @brendancol in #868
• Fix perlin/terrain dask backends: enable parallelism and out-of-core support by @brendancol in #870
• Fixes #114: add Mahalanobis distance metric by @brendancol in #871
• Document CPU vs GPU algorithm difference in viewshed docstring by @brendancol in #872
• Fixes #587: unify project requirements around setup.cfg by @brendancol in #873
• Fixes #845: add configurable boundary mode to kernel-based spatial ops by @brendancol in #874
• Fixes #804: add min_observable_height() to experimental by @brendancol in #886
• Fix test warnings: suppress expected GPU/NaN warnings, fix real code issues by @brendancol in #887
• Fixes #880: fix cost_distance OOM with iterative tile Dijkstra by @brendancol in #888
• Release v0.6.0 by @brendancol in #889

Full Changelog: v0.5.3...v0.6.0

Version 0.5.3

Version 0.5.3 - 2026-02-22

• Fixes #733: add cost_distance() for weighted proximity (#859)
• Fixes #734: make noise a lazy import so datasets module is usable without it (#858)
• Fixes #774: suppress dd.concat unknown divisions warning in zonal_stats (#857)
• Fixes #392: document and test 3D time-series zonal stats via Dataset (#856)
• Fix hotspots dask performance: 2-pass streaming with O(chunk_size) memory (#855)
• Fixes #134: add xr.Dataset as input type for appropriate modules (#854)
• Warnings(17) filtering for non-GPU (#850)
• Fixes #190: GPU-enable all classification operations (#852)
• updating links and text (#849)
• fixes 766 document handling of f32 vs. f64 data when using xarray spatial (#847)
• Fix rioxarray band_as_variable DataArray extraction (#846)
• added majority as default stat for zonal operations with numpy and cupy (#844)
• fixed proximity intermediate large numpy array problem and proximity output coords are now lazy if input is dask array (#843)
• Changed regions parameter connections to neighborhood and updated docstring (#842)
• Testing and Updating Examples (#837)
• added horizontal vertical unit mismatch heuristic to help address issue #840 (#841)
• Fixes #838 update legacy repo url links (#839)
• added colorado dem to examples datasets yaml

Version 0.5.2

What's Changed

• Dask is now truly optional by @brendancol in #835
• removed references to xarray-spatial.org by @brendancol in #827
• fixes 832 update citation info in readme by @brendancol in #834

Full Changelog: v0.5.1...v0.5.2

Version 0.5.1

What's Changed

• updated runner, python setup action and checkout actions for PyPI publish by @brendancol in #826

Full Changelog: v0.5.0...v0.5.1

Version 0.5.0

What's Changed

• Update docstring for viewshed by @ahuang11 in #807
• Enable dask+cupy (cuda) implementation for (some) convolution methods, e.g. aspect by @relativityhd in #815
• Small Fixes while testing Cuda 13 by @brendancol in #818
• Allow Negative Target Height in Viewshed Analysis (viewshed.py) by @trygvels in #812
• Add Python 3.14, Remove Codecov for now, add dask and pyarrow to setup.cfg by @brendancol in #822
• Ensure the hash value fits into an uint64 by @brendancol in #805
• added in dask-cupy convolve_2d test by @brendancol in #823
• Prep for Version 0.5.0 by @brendancol in #824

New Contributors

• @ahuang11 made their first contribution in #807
• @relativityhd made their first contribution in #815
• @trygvels made their first contribution in #812

Full Changelog: v0.4.0...v0.5.0

v0.4.0

What's Changed

• Python 3.12 Support!
• chore: Remove numpy pin, pin datashader, drop Python 3.7 by @jthetzel in #789
• Bunch of Fixes by @brendancol in #796
• Move docs to readthedocs [WIP] by @tcmetzger in #797
• Fix typo in readthedocs config by @tcmetzger in #799
• Update readthedocs configuration [WIP] by @tcmetzger in #798
• Add links to docs to readme by @tcmetzger in #800
• Prep PR for 0.4.0 Release by @brendancol in #801

Full Changelog: v0.3.7...v0.4.0

Version 0.3.7 - 2023-06-09

The 0.3.7 release is a hot fix for 0.3.6, which has problem with publishing to PyPi as the package exceeds the limit of 100MB. In this new release, example notebooks are cleaned up to reduce the package size.

What's Changed

• Clear example notebook outputs by @thuydotm in #786
• Change log for release v0.3.7 by @thuydotm in #788

Version 0.3.6 - 2023-06-02

With the 0.3.6 release, xarray-spatial now supports python 3.11. This release focuses on demonstrating the reliability of the library by adding more tests against GDAL/QGIS.

What's Changed

• Fixed feature-proposal.md config by @nodell111 in #718
• WIP Add viewshed gpu notebook by @thuydotm in #720
• Update README.md by @RichardScottOZ in #719
• update pharmacy desserts notebook by @thuydotm in #723
• Update contributor badge by @thuydotm in #740
• Use setuptools by @giancastro in #749
• More examples to user guide by @thuydotm in #742
• WIP Housing price feature engineering notebook by @thuydotm in #725
• Zonal_crosstab 3D: Ensure content of input param values is preserved by @thuydotm in #754
• Classification tools: use binary search in numpy case by @thuydotm in #760
• Zonal crosstab user guide notebook enhancement by @thuydotm in #759
• Test against QGIS, GDAL by @thuydotm in #744
• classify.binary: handle NaNs and infinite values by @thuydotm in #763
• Multispectral tools: convert data to float32 dtype before doing calculations by @thuydotm in #755
• Updated citation for 2023 by @brendancol in #769
• Test all functions to ensure inputs unmodified by @thuydotm in #764
• Pin numpy version by @thuydotm in #780
• correct docs for proximity by @thuydotm in #778
• Test on Python 3.11 by @thuydotm in #750
• Change log for release v0.3.6 by @thuydotm in #785

Version 0.3.5 - 2022-06-05

The 0.3.5 release mainly addresses the scaling issue in GPU viewshed to gain better accurate triangulation.
The GPU raytraced viewshed should now give comparable results to the CPU version.
However, the 2 versions use 2 different approaches, there can be slightly differences at some points
where a version returns visible while the other considers them as invisible.
Many thanks to @nodell111, @a7az0th, and the maintainers @thuydotm for contributing to this release.

Enhancements

• command to get change log (#716)
• Added Feature Proposal Template (#714)

Bug Fixes

• Improved viewshed rtx. Now result should match the CPU version (#715)