.TH i.fft 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBi.fft\fR\fR  - Fast Fourier Transform (FFT) for image processing.
.SH KEYWORDS
imagery, FFT
.SH SYNOPSIS
\fBi.fft\fR
.br
\fBi.fft help\fR
.br
\fBi.fft input_image\fR=\fIname\fR \fBreal_image\fR=\fIname\fR \fBimaginary_image\fR=\fIname\fR  [\fBrange\fR=\fIinteger\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput_image\fR=\fIname\fR" 4m
.br
Name of input raster map
.IP "\fBreal_image\fR=\fIname\fR" 4m
.br
Name for output real part arrays stored as raster map
.IP "\fBimaginary_image\fR=\fIname\fR" 4m
.br
Name for output imaginary part arrays stored as raster map
.IP "\fBrange\fR=\fIinteger\fR" 4m
.br
Range of values in output display files
.br
Default: \fI255\fR
.PP
.SH DESCRIPTION
\fIi.fft\fR is an image processing program based on the FFT algorithm
given by Frigo et al. (1998), that processes a single input raster map layer
(\fBinput_image\fR) and constructs the real and imaginary Fourier
components in frequency space.
.SH NOTES
The real and imaginary components are stored as arrays of
doubles in the \fIcell_misc\fR directory (for use in the
inverse transform program,
\fIi.ifft\fR),
and are also scaled and formatted into the
\fBreal_image\fR and \fBimaginary_image\fR raster map
layers for inspection, masking, etc.  In these raster map
layers the low frequency components are in the center and
the high frequency components are toward the edges.  The
\fBinput_image\fR need not be square;  before
processing, the X and Y dimensions of the
\fBinput_image\fR are padded with zeroes to the next
highest power of two in extent (i.e., 256 x 256 is
processed at that size, but 200 x 400 is padded to 256 x
512).  The cell category values for viewing, etc., are
calculated by taking the natural log of the actual values
then rescaling to 255, or whatever optional range is given
on the command line, as suggested by Richards (1986).  A
color table is assigned to the resultant map layer.
.PP
The current geographic region and mask settings are
respected when reading the input file.  The presence of a
mask will, in general, make the resulting fast Fourier
transform invalid, or at least difficult to interpret.
.SH EXAMPLE
North Carolina example:
\fC
.DS
.br
g.region rast=lsat7_2002_70
.br
i.fft input_image=lsat7_2002_70 real=lsat7_2002_70.real imaginary=lsat7_2002_70.imag
.br
.br
# set region to resulting FFT output map (due to new FFT coordinate space):
.br
g.region rast=lsat7_2002_70.real \-p
.br
d.mon x0
.br
d.rast lsat7_2002_70.real
.br
d.rast lsat7_2002_70.imag
.br
.DE
\fR
.SH SEE ALSO
.RS
.IP
 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.
.IP
 John A. Richards, 1986. Remote Sensing Digital Image Analysis, Springer-Verlag.
.RE
.PP
Personal communication, between progam author and Ali R. Vali,
Space Research Center, University of Texas, Austin, 1990.
.PP
\fIi.cca\fR
.br
\fIi.class\fR
.br
\fIi.ifft\fR
.br
\fIi.pca\fR
.SH AUTHOR
David Satnik, GIS Laboratory, 
Central Washington University
.br
Glynn Clements (FFTW support)
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team