Herror ::principal_comp (
    Hobject MultichannelImage,
    Hobject *PCAImage,
    HTuple *InfoPerComp
)
HImage HImage::PrincipalComp (
    HTuple *InfoPerComp
) const

Compute the principal components of multi-channel images.

::principal_comp does a principal components analysis of multi-channel images. This is useful for images obtained, e.g., with the thematic mapper of the Landsat satellite. Because the spectral bands are highly correlated it is desirable to transform them to uncorrelated images. This can be used to save storage, since the bands containing little information can be discarded, and with respect to a later classification step.

The operator ::principal_comp takes a (multi-channel) image MultichannelImage and transforms it to the output image PCAImage, which contains the same number of channels, using the principal components analysis. The parameter InfoPerComp contains the relative information content of each output channel.


Parameters

MultichannelImage (input_object)
multichannel-image -> Hobject: HImage ( byte / int1 / int2 / int4 / real )
Multi-channel input image.

PCAImage (output_object)
multichannel-image -> Hobject * : HImage ( real )
Multi-channel ouput image.

InfoPerComp (output_control)
real-array -> HTuple.double *
Information content of each output channel.


Result

The operator ::principal_comp returns the value H_MSG_TRUE if the parameters are correct. Otherwise an exception is raised.


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH