HALCON Reference Manual 10.0.2
Table of Contents / Filters / Color ClassesClassesClasses | | | Operators

principal_compT_principal_compprincipal_compPrincipalCompPrincipalComp (Operator)

Name

principal_compT_principal_compprincipal_compPrincipalCompPrincipalComp — Compute the principal components of multichannel images.

Signature

principal_comp(MultichannelImage : PCAImage : : InfoPerComp)

Herror T_principal_comp(const Hobject MultichannelImage, Hobject* PCAImage, Htuple* InfoPerComp)

Herror principal_comp(Hobject MultichannelImage, Hobject* PCAImage, HTuple* InfoPerComp)

HImage HImage::PrincipalComp(HTuple* InfoPerComp) const

void HOperatorSetX.PrincipalComp(
[in] IHUntypedObjectX* MultichannelImage, [out] IHUntypedObjectX** PCAImage, [out] VARIANT* InfoPerComp)

IHImageX* HImageX.PrincipalComp([out] VARIANT* InfoPerComp)

static void HOperatorSet.PrincipalComp(HObject multichannelImage, out HObject PCAImage, out HTuple infoPerComp)

HImage HImage.PrincipalComp(out HTuple infoPerComp)

Description

principal_compprincipal_compprincipal_compPrincipalCompPrincipalComp does a principal components analysis of multichannel 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_compprincipal_compprincipal_compPrincipalCompPrincipalComp takes a (multichannel) image MultichannelImageMultichannelImageMultichannelImageMultichannelImagemultichannelImage and transforms it to the output image PCAImagePCAImagePCAImagePCAImagePCAImage, which contains the same number of channels, using the principal components analysis. The parameter InfoPerCompInfoPerCompInfoPerCompInfoPerCompinfoPerComp contains the relative information content of each output channel.

Parallelization

Parameters

MultichannelImageMultichannelImageMultichannelImageMultichannelImagemultichannelImage (input_object)  multichannel-image → objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Multichannel input image.

PCAImagePCAImagePCAImagePCAImagePCAImage (output_object)  multichannel-image → objectHImageHImageHImageXHobject * (real)

Multichannel output image.

InfoPerCompInfoPerCompInfoPerCompInfoPerCompinfoPerComp (output_control)  real-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Information content of each output channel.

Result

The operator principal_compprincipal_compprincipal_compPrincipalCompPrincipalComp returns the value 2 (H_MSG_TRUE) if the parameters are correct. Otherwise an exception is raised.

Alternatives

gen_principal_comp_transgen_principal_comp_transgen_principal_comp_transGenPrincipalCompTransGenPrincipalCompTrans

See also

linear_trans_colorlinear_trans_colorlinear_trans_colorLinearTransColorLinearTransColor

Module

Foundation

Table of Contents / Filters / Color ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH