FFT - Maple Help

Online Help

All Products    Maple    MapleSim


SignalProcessing

  

FFT

  

compute forward fast Fourier transform

  

InverseFFT

  

compute inverse fast Fourier transform

 

Calling Sequence

Parameters

Options

Description

Thread Safety

Examples

Compatibility

Calling Sequence

FFT(A)

FFT(A1, A2)

InverseFFT(A)

InverseFFT(A1, A2)

Parameters

A

-

Array of complex numeric values; the signal

A1, A2

-

Arrays of real numeric values corresponding to the real and imaginary parts of the signal

Options

• 

container     : Array or [Array, Array], predefined Array(s) for holding results

• 

inplace       : truefalse, specifies that output should overwrite input

• 

normalization : name, type of normalization

• 

dimension     : integer or [integer] or all or "all"

Description

• 

The FFT(A) command computes the fast Fourier transform (FFT) of the Array A and returns the result in an Array with datatype complex[8]. With two Array arguments, invoked as FFT(A1, A2), the command interprets A1 and A2 as giving the real and imaginary parts of the input signal, respectively, and returns the result as a sequence of two Arrays with datatype float[8]. These Arrays are the real and imaginary parts of the output signal. For this calling sequence, A1 and A2 must have the same number of elements.

• 

The InverseFFT(A) command computes the inverse fast Fourier transform of the Array A and returns the result in an Array with datatype complex[8]. With two Array arguments, invoked as InverseFFT(A1, A2), the command interprets A1 and A2 as giving the real and imaginary parts of the input signal, respectively, and returns the result as a sequence of two Arrays with datatype float[8]. These Arrays are the real and imaginary parts of the output signal. For this calling sequence, A1 and A2 must have the same number of elements.

• 

Before the code performing the computation runs, the input Array(s) are converted to datatype complex[8] (for the calling sequences with A) or float[8] (for the calling sequences with A1 and A2) if they do not have that datatype already. For this reason, it is most efficient if the input Array(s) have this datatype beforehand.

• 

It is recommended that the number of elements of A be a power of 2 greater than 2.  If you use FFT on a sample not satisfying this requirement, it will use SignalProcessing:-DFT instead; similarly, if you use InverseFFT on such a sample, it will use SignalProcessing:-InverseDFT.

• 

The code underlying these commands (in the Intel Integrated Performance Primitives (IPP) library, see software.intel.com/en-us/intel-ipp) does not support Arrays of dimension two or higher directly. However, when called with such an Array, these commands call the FourierTransform or InverseFourierTransform commands in the DiscreteTransforms package instead, which supports Arrays with dimension at most 5. In this case, the container option cannot be used.

  

For more information on Fourier transforms in Maple, including a summarized comparision of SignalProcessing[FFT], SignalProcessing[DFT], and DiscreteTransforms[FourierTransform], see Fourier Transforms in Maple.

• 

The option normalization must be one of the following: none, symmetric or full. If normalization is none, then the FFT is computed without any normalization. If it is symmetric, then the transforms are computed using 1N as the multiplier for both the forward and inverse transforms. If it is full, then 1N is used as the multiplier, where N is the length of A.

• 

If the container=C option is provided, and there is a single rtable argument A, then the results are put into C and C is returned.  In this case, the container C must be an Array having datatype complex[8] and size equal to that of A.

If the container = [C1, C2] option is provided, and there are two rtable arguments A1 and A2, then the results are put into C1 and C2 and they are returned. In this case, C1 and C2 must be Arrays having datatype float[8] and size equal to that of A1.

With this option, no additional memory is allocated to store the result.

• 

If the inplace or inplace=true option is provided, then A or A1 and A2 are overwritten with the results. In this case, the container option is ignored. Furthermore, if A is specified, it must have datatype complex[8], and if A1 and A2 are specified, they must have datatype float[8].

• 

The option dimension specifies the array dimension to be transformed. If dimension = all or dimension = "all" is provided, then the array is transformed in all dimensions. The default is all.

Thread Safety

• 

The SignalProcessing[FFT] and SignalProcessing[InverseFFT] commands are thread-safe as of Maple 17.

• 

For more information on thread safety, see index/threadsafe.

Examples

withSignalProcessing:

aGenerateTone8,1,1π,π:

bFFTa

0.31338952913812446+0.0I0.304868327527718640.2178559066431096I0.234861851715913760.8316020780325695I0.5051225130415029+0.8410347860008229I0.4253322110377947+0.0I0.50512251304150290.8410347860008229I0.23486185171591376+0.8316020780325695I0.30486832752771864+0.2178559066431096I

(6.1)

cInverseFFTb

0.99999999999999987.64229474954824210-18I0.41614683644142251.89851476769053910-17I0.6536436213500373+7.64229474954824210-18I0.9601702863236703+1.924919455269834710-17I0.14550003213097657.64229474954824210-18I0.8390715302853515+7.01947715595621310-18I0.8438539572576526+7.64229474954824210-18I0.13673722145217277.28352403174917110-18I

(6.2)

Normmapfnormal,ac

0.

(6.3)

bFFTa,normalization=full

0.1107999306032135+0.0I0.107787230881925670.07702369445444311I0.0830362039951760.29401573431282724I0.17858777715081853+0.29735070019747933I0.1503776453409462+0.0I0.178587777150818530.29735070019747933I0.083036203995176+0.29401573431282724I0.10778723088192567+0.07702369445444311I

(6.4)

cInverseFFTb,normalization=full

0.125+0.0I0.052018354555177846.09111566793634610-19I0.08170545266875465+0.0I0.12002128579045881+1.658294911527969910-18I0.018187504016372084+0.0I0.10488394128566897+6.09111566793634610-19I0.10548174465720658+0.0I0.0170921526815216161.658294911527969910-18I

(6.5)

Normmapfnormal,ac

0.875000000000000000

(6.6)

A := Array( 1 .. 1024, proc( n )
       local s := 0;
       local m := n;
       while m <> 0 do
           s := s + irem( m, 10, 'm' )^2
       end end, 'datatype' = 'float'[ 8 ] ):

UFFTA&colon;

useplotsindisplaylistplotA&comma;listplotmap&real;&comma;U1..512&comma;listplotmap&Im;&comma;U1..512end use

We can also use the other calling sequence, to get the real and imaginary parts split. In this case, we have to explicitly specify the imaginary part of the input as 0.

zerosArray1..1024&comma;datatype=float8&colon;

U1,U2FFTA&comma;zeros&colon;

useplotsindisplaylistplotA&comma;listplotU11..512&comma;listplotU21..512end use

withImageTools&colon;

imgReadcatkerneloptsdatadir&comma;/images/phone.jpg

_rtable36893628073405984148

(6.7)

EmbedCreateimg

mFFTimg&colon;

InverseFFTm

_rtable36893628073405964404

(6.8)

m2PowerSpectrumm&colon;

EmbedCreatem2

m3FFTShiftm2&colon;

EmbedCreatem3

Compatibility

• 

The SignalProcessing[FFT] and SignalProcessing[InverseFFT] commands were introduced in Maple 17.

• 

For more information on Maple 17 changes, see Updates in Maple 17.

See Also

DiscreteTransforms[FourierTransform]

fourier_in_maple

SignalProcessing[DCT]

SignalProcessing[DFT]

SignalProcessing[DWT]

SignalProcessing[FFTShift]