Skip to content

power_realPowerRealPowerRealpower_realpower_real🔗

Short description🔗

power_realPowerRealPowerRealpower_realpower_real — Return the power spectrum of a complex image.

Signature🔗

power_real( image Image, out image ImageResult )void PowerReal( const HObject& Image, HObject* ImageResult )static void HOperatorSet.PowerReal( HObject image, out HObject imageResult )def power_real( image: HObject ) -> HObject

Herror power_real( const Hobject Image, Hobject* ImageResult )

Herror T_power_real( const Hobject Image, Hobject* ImageResult )

HImage HImage::PowerReal( ) const

HImage HImage.PowerReal( )

Description🔗

power_realPowerReal computes the power spectrum from the real and imaginary parts of a Fourier-transformed image (see fft_imageFftImage), i.e., the modulus of the frequencies. The result image is of type real. The following formula is used:

\[\begin{eqnarray*} \sqrt{real part^2 + imaginary part^2} \enspace . \end{eqnarray*}\]

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 tuple level.

  • Automatically parallelized on internal data level.

Parameters🔗

Imageimageimage (input_object) (multichannel-)image(-array) → object (complex)HObject (complex)HImage (complex)HObject (complex)Hobject (complex)

Input image in frequency domain.

ImageResultimageResultimage_result (output_object) image(-array) → object (real)HObject (real)HImage (real)HObject (real)Hobject * (real)

Power spectrum of the input image.

Example🔗

(C)

read_image(&Image,"monkey")\;
disp_image(Image,WindowHandle)\;
fft_image(Image,&FFT)\;
power_real(FFT,&Power)\;
disp_image(Power,WindowHandle)\;

Result🔗

power_realPowerReal returns 2 (H_MSG_TRUE) if the image is of correct type. 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

fft_imageFftImage, fft_genericFftGeneric, rft_genericRftGeneric, convol_fftConvolFft, convol_gaborConvolGabor

Possible successors

disp_imageDispImage, convert_image_typeConvertImageType, scale_imageScaleImage

Alternatives

abs_imageAbsImage, convert_image_typeConvertImageType, power_bytePowerByte, power_lnPowerLn

See also

fft_imageFftImage, fft_genericFftGeneric, rft_genericRftGeneric

Module🔗

Foundation