Skip to content

energy_gaborenergy_gaborEnergyGaborEnergyGaborenergy_gaborenergy_gabor🔗

Short description🔗

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

Signature🔗

energy_gabor( image ImageGabor, image ImageHilbert, out image Energy )energy_gabor( ImageGabor, ImageHilbert : Energy : : )void EnergyGabor( const HObject& ImageGabor, const HObject& ImageHilbert, HObject* Energy )static void HOperatorSet.EnergyGabor( HObject imageGabor, HObject imageHilbert, out HObject energy )def energy_gabor( image_gabor: HObject, image_hilbert: HObject ) -> HObject

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

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

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

HImage HImage.EnergyGabor( HImage imageHilbert )

Description🔗

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

\[\begin{eqnarray*} \textrm{Energy} = \mbox{channel1}^2 + \mbox{channel2}^2 \enspace .\end{eqnarray*}\]

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_gaborConvolGabor). In this case, the first channel of the image passed to energy_gaborEnergyGabor is the Gabor-filtered image, transformed back into the spatial domain (see fft_image_invFftImageInv), 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.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on domain level.

Parameters🔗

ImageGaborimageGaborimage_gabor (input_object) (multichannel-)image(-array) → object (byte / real)object (byte / real)HObject (byte / real)HImage (byte / real)HObject (byte / real)Hobject (byte / real)

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

ImageHilbertimageHilbertimage_hilbert (input_object) (multichannel-)image(-array) → object (byte / real)object (byte / real)HObject (byte / real)HImage (byte / real)HObject (byte / real)Hobject (byte / real)

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

Energyenergyenergy (output_object) image(-array) → object (real)object (real)HObject (real)HImage (real)HObject (real)Hobject * (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_gaborEnergyGabor 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>:). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

gen_gaborGenGabor, convol_gaborConvolGabor, fft_image_invFftImageInv

Module🔗

Foundation