dic_preprocess.analysisRun.makeFalseColorOverlay

Inputs

referenceImage

Numeric grayscale or RGB reference image.

alignedImage

Numeric grayscale or RGB moving image. A different height or width is resized to the reference dimensions by nearest neighbor.

Outputs

overlay

Double RGB image the size of referenceImage. Red contains the independently normalized moving image, green contains the independently normalized reference, and blue is zero.

Description

Coincident structure appears yellow, moving-only structure red, and reference-only structure green. Independent min/max grayscale normalization emphasizes geometry rather than preserving absolute intensity calibration.

Failure Behavior

A constant image retains its normalized intensity instead of being stretched. An all-NaN image remains NaN. Empty arrays, unsupported image classes, or invalid channel shapes propagate errors from LabKit image conversion or nearest-neighbor resizing.

Example

reference = eye(5);
moving = circshift(reference, [0 1]);
overlay = dic_preprocess.analysisRun.makeFalseColorOverlay( ...
reference, moving);
assert(isequal(size(overlay), [5 5 3]))
assert(all(overlay(:,:,3) == 0, "all"))