adding more nodes

docs/nodes/Immerse Detail.md

@@ -0,0 +1,29 @@
+# Immerse Detail
+
+Overlay a high-resolution detail scan onto a lower-resolution overview image. Uses sliding-window cross-correlation (coarse + fine search) to automatically locate the detail within the overview. Equivalent to Gwyddion's immerse.c module.
+
+## Inputs
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| overview | DATA_FIELD | Yes | Lower-resolution overview field |
+| detail | DATA_FIELD | Yes | Higher-resolution detail field to place into the overview |
+
+## Outputs
+
+| Name | Type | Description |
+|------|------|-------------|
+| combined | DATA_FIELD | Overview field with the detail region replaced or blended in |
+
+## Controls
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| blend | dropdown | replace | How to combine the detail with the overview: replace (overwrite) or average (mean of both) |
+
+## Notes
+
+- If the detail has a different pixel size than the overview, it is resampled (via `scipy.ndimage.zoom`) to match the overview pixel spacing before placement.
+- Alignment uses a two-pass normalized cross-correlation: a coarse search with stride, followed by a fine pixel-by-pixel search around the best coarse position.
+- If the detail is larger than the overview in either dimension, the overview is returned unchanged.
+- The output retains the overview's physical dimensions and metadata.