Skip to content

i.ifft

Inverse Fast Fourier Transform (IFFT) for image processing.

i.ifft real=name imaginary=name output=name [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

i.ifft real=name imaginary=name output=name

grass.script.run_command("i.ifft", real, imaginary, output, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("i.ifft", real="name", imaginary="name", output="name")

Parameters

real=name [required]
    Name of input raster map (image fft, real part)
imaginary=name [required]
    Name of input raster map (image fft, imaginary part
output=name [required]
    Name for output raster map
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

real : str, required
    Name of input raster map (image fft, real part)
    Used as: input, raster, name
imaginary : str, required
    Name of input raster map (image fft, imaginary part
    Used as: input, raster, name
output : str, required
    Name for output raster map
    Used as: output, raster, name
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

i.ifft is an image processing program based on the algorithm given by Frigo et al. (1998), that converts real and imaginary frequency space images (produced by i.fft) into a normal image.

NOTES

The current mask is respected when reading the real and imaginary component files; thus, creating a mask is a primary step for selecting the portion of the frequency space data to be included in the inverse transform. The module wxGUI vector digitizer can be used to create masks while viewing the real or imaginary component image. Alternatively r.circle can be used to generate high-, low- and donut filters specifying the DC point as circle/ring center. When i.ifft is executed, it (automatically) uses the same GRASS region definition setting that was used during the original transformation done with i.fft.

REFERENCES

  • M. Frigo and S. G. Johnson (1998): "FFTW: An Adaptive Software Architecture for the FFT". See www.fftw.org: FFTW is a C subroutine library for computing the Discrete Fourier Transform (DFT) in one or more dimensions, of both real and complex data, and of arbitrary input size.
  • Richards, J.A (1986): Remote Sensing Digital Image Analysis, Springer-Verlag, 1986.
  • Personal communication, between program author and Ali R. Vali, Space Research Center, University of Texas, Austin, 1990.

SEE ALSO

i.cca, g.gui.iclass, i.fft, i.pca, r.circle, wxGUI vector digitizer

AUTHORS

David Satnik, GIS Laboratory, Central Washington University
Glynn Clements (FFTW support)

SOURCE CODE

Available at: i.ifft source code (history)
Latest change: Monday Mar 17 15:33:39 2025 in commit 3f5b5a4