STATMASK: Overlay image with coloured statistical mask

Overlay an image with a thresholded statistical mask. The mask values are not rescaled.
Updated 31 Jan 2013

View License

Overlays a mask of statistics on an image. By default the
currently displayed figure is overlain.

First, the underlay is converted to RGB. The statistical overlay
is upscaled if necessary (using nearest neighbour sampling) to
match the size of the underlay. Then the RGB data is overlain
with the statmask, without rescaling of the stat values. This
allows for inspection of mask values with the data cursor.

The function returns a handle to the overlay mask if requested.

Notes: Requires freezeColors from the file exchange
Consider using getclim to help set your colormap limits

hOv = statmask(stats, [thresh, cmap, clim, cbOpt, hAx])

stats: matrix representing mask values
thresh: scalar value of threshold for transparency (default 0)
cmap: colour-map to use. default flipud(autumn(256))
clim: limits for color display of stats overlay (default min/max of stats)
cbOpt: colorbar display: 'on', 'onwest', or 'hidden', else off (default 'on')
hAx: handle to axes on which to operate (default current axes)

hOv: handle to overlay image is returned

I = peaks(200);
bwMask = eye(25).*rand(25);
imshow(I, [], 'Colormap', bone(256), 'InitialMag', 200);

Cite As

Andrew Davis (2024). STATMASK: Overlay image with coloured statistical mask (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2012a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Find more on Display Image in Help Center and MATLAB Answers

Inspired by: freezeColors / unfreezeColors

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes