decorrstretch (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Apply a decorrelation stretch to a multichannel image

Syntax

S = decorrstretch(I)
S = decorrstretch(I,TOL)

Description

S = decorrstretch(I) applies a decorrelation stretch to a multichannel image I and returns the result in S. S has the same size and class as I. The mean and variance in each band are the same as in I.

S = decorrstretch(I,TOL) applies a contrast following the decorrelation stretch. The contrast stretch is controlled by TOL:

TOL = [LOW_FRACT HIGH_FRACT] specifies the fraction of the image to saturate at low and high intensities.
If TOL is a scalar, LOW_FRACT = TOL, and HIGH_FRACT = 1 - TOL, which saturates equal fractions at low and high intensities.

Notes

The decorrelation stretch is normally applied to three band images (ordinary RGB images or RGB multispectral composite images), but decorrstretch works on an arbitrary number of bands.

The primary purpose of decorrelation stretch is visual enhancement. Small adjustments to TOL can strongly affect the visual appearance of the output.

Class Support

The input image must be of class uint8, uint16, int16, single, or double.

Example

[X, map] = imread('forest.tif');
S = decorrstretch(ind2rgb(X, map),'tol',0.01);
figure, imshow(X,map)
figure, imshow(S)

See Also

imadjust, stretchlim

deconvwnr dicomanon