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

energy_gaborenergy_gaborenergy_gaborEnergyGaborEnergyGabor (Operator)

Name

energy_gaborenergy_gaborenergy_gaborEnergyGaborEnergyGabor — Calculate the energy of a two-channel image.

Signature

energy_gabor(ImageGabor, ImageHilbert : Energy : : )

Herror energy_gabor(const Hobject ImageGabor, const Hobject ImageHilbert, Hobject* Energy)

Herror T_energy_gabor(const Hobject ImageGabor, const Hobject ImageHilbert, Hobject* Energy)

Herror energy_gabor(Hobject ImageGabor, Hobject ImageHilbert, Hobject* Energy)

HImage HImage::EnergyGabor(const HImage& ImageHilbert) const

HImageArray HImageArray::EnergyGabor(const HImageArray& ImageHilbert) const

void HOperatorSetX.EnergyGabor(
[in] IHUntypedObjectX* ImageGabor, [in] IHUntypedObjectX* ImageHilbert, [out] IHUntypedObjectX*Energy)

IHImageX* HImageX.EnergyGabor([in] IHImageX* ImageHilbert)

static void HOperatorSet.EnergyGabor(HObject imageGabor, HObject imageHilbert, out HObject energy)

HImage HImage.EnergyGabor(HImage imageHilbert)

Description

energy_gaborenergy_gaborenergy_gaborEnergyGaborEnergyGabor calculates the local contrast (EnergyEnergyEnergyEnergyenergy) of the two input images. The energy of the resulting image is then defined as

     energy = channel1 ^2 + channel2 ^2 .

Often the calculation of the energy is preceded by the convolution of an image with a Gabor filter and the Hilbert transform of the Gabor filter (see convol_gaborconvol_gaborconvol_gaborConvolGaborConvolGabor). In this case, the first channel of the image passed to energy_gaborenergy_gaborenergy_gaborEnergyGaborEnergyGabor is the Gabor-filtered image, transformed back into the spatial domain (see fft_image_invfft_image_invfft_image_invFftImageInvFftImageInv), and the second channel the result of the convolution with the Hilbert transform, also transformed back into the spatial domain. The local energy is a measure for the local contrast of structures (e.g., edges and lines) in the image.

Parallelization

Parameters

ImageGaborImageGaborImageGaborImageGaborimageGabor (input_object)  image(-array) objectHImageHImageHImageXHobject (byte / real)

1st channel of input image (usually: Gabor image).

ImageHilbertImageHilbertImageHilbertImageHilbertimageHilbert (input_object)  image(-array) objectHImageHImageHImageXHobject (byte / real)

2nd channel of input image (usually: Hilbert image).

EnergyEnergyEnergyEnergyenergy (output_object)  image(-array) objectHImageHImageHImageXHobject * (real)

Image containing the local energy.

Example (C)

fft_image(Image,&FFT);
gen_gabor(&Filter,1.4,0.4,1.0,1.5,512);
convol_gabor(FFT,Filter,&Gabor,&Hilbert);
fft_image_inv(Gabor,&GaborInv);
fft_image_inv(Hilbert,&HilbertInv);
energy_gabor(GaborInv,HilbertInv,&Energy);

Result

energy_gaborenergy_gaborenergy_gaborEnergyGaborEnergyGabor returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

gen_gaborgen_gaborgen_gaborGenGaborGenGabor, convol_gaborconvol_gaborconvol_gaborConvolGaborConvolGabor, fft_image_invfft_image_invfft_image_invFftImageInvFftImageInv

Module

Foundation


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