power_bytepower_bytePowerBytePowerByte (Operator)

Name

power_bytepower_bytePowerBytePowerByte — Return the power spectrum of a complex image.

Signature

power_byte(Image : PowerByte : : )

Herror power_byte(const Hobject Image, Hobject* PowerByte)

Herror T_power_byte(const Hobject Image, Hobject* PowerByte)

void PowerByte(const HObject& Image, HObject* PowerByte)

HImage HImage::PowerByte() const

static void HOperatorSet.PowerByte(HObject image, out HObject powerByte)

HImage HImage.PowerByte()

Description

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

Please note, that resulting gray values that exceed the value of 255 are clipped at 255 because of the resulting image type 'byte'"byte""byte""byte""byte".

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (complex)

Input image in frequency domain.

PowerBytePowerBytePowerBytePowerBytepowerByte (output_object)  image(-array) objectHImageHImageHobject * (byte)

Power spectrum of the input image.

Example (C)

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

Result

power_bytepower_bytePowerBytePowerBytePowerByte 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>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

fft_imagefft_imageFftImageFftImageFftImage, fft_genericfft_genericFftGenericFftGenericFftGeneric, rft_genericrft_genericRftGenericRftGenericRftGeneric, convol_fftconvol_fftConvolFftConvolFftConvolFft, convol_gaborconvol_gaborConvolGaborConvolGaborConvolGabor

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

abs_imageabs_imageAbsImageAbsImageAbsImage, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageType, power_realpower_realPowerRealPowerRealPowerReal, power_lnpower_lnPowerLnPowerLnPowerLn

See also

fft_imagefft_imageFftImageFftImageFftImage, fft_genericfft_genericFftGenericFftGenericFftGeneric, rft_genericrft_genericRftGenericRftGenericRftGeneric

Module

Foundation