Add fused_overlap and multi_overlap dask graph utilities (#1071)

* Add design spec for fused_overlap and multi_overlap utilities

* Add implementation plan for fused_overlap and multi_overlap

* Add _normalize_depth and _pad_nan helpers

* Add fused_overlap utility

* Add multi_overlap utility

* Add fused_overlap and multi_overlap to accessor and exports

* Add fused_overlap and multi_overlap to docs and README

* Add fused_overlap and multi_overlap user guide notebook

Author: brendancol

README.md

@@ -287,6 +287,8 @@ Same-CRS tiles skip reprojection entirely and are placed by direct coordinate al
 | [Rescale](xrspatial/normalize.py) | Min-max normalization to a target range (default [0, 1]) | Standard | ✅️ | ✅️ | ✅️ | ✅️ |
 | [Standardize](xrspatial/normalize.py) | Z-score normalization (subtract mean, divide by std) | Standard | ✅️ | ✅️ | ✅️ | ✅️ |
 | [rechunk_no_shuffle](xrspatial/utils.py) | Rechunk dask arrays using whole-chunk multiples (no shuffle) | Custom | 🔄 | ✅️ | 🔄 | ✅️ |
+| [fused_overlap](xrspatial/utils.py) | Fuse sequential map_overlap calls into a single pass | Custom | 🔄 | ✅️ | 🔄 | ✅️ |
+| [multi_overlap](xrspatial/utils.py) | Run multi-output kernel in a single overlap pass | Custom | 🔄 | ✅️ | 🔄 | ✅️ |
 
 -----------
 

docs/source/reference/utilities.rst

@@ -54,6 +54,14 @@ Normalization
     xrspatial.normalize.rescale
     xrspatial.normalize.standardize
 
+Overlap Fusion
+==============
+.. autosummary::
+    :toctree: _autosummary
+
+    xrspatial.utils.fused_overlap
+    xrspatial.utils.multi_overlap
+
 Rechunking
 ==========
 .. autosummary::