Main Content

FFT

Fast Fourier transform (FFT) of input

  • FFT block

Libraries:
DSP System Toolbox / Transforms

Description

The FFT block computes the fast Fourier transform (FFT) across the first dimension of an N-D input array, u. The block uses one of two possible FFT implementations. You can select an implementation based on the FFTW library or an implementation based on a collection of Radix-2 algorithms. To allow the block to choose the implementation, you can select Auto. For more information about the FFT implementations, see Algorithms.

For user-specified FFT lengths not equal to P, zero padding or truncating, or modulo-length data wrapping occurs before the FFT operation. For an FFT with PM:

y = fft(u,M) % P ≤ M

Wrapping:

y(:,L) = fft(datawrap(u(:,L),M)) % P > M; L = 1,...,N

Truncating:

y (:,L) = fft(u,M) % P > M; L = 1,...,N

Tip

When the input length, P, is greater than the FFT length, M, you may see magnitude increases in your FFT output. These magnitude increases occur because the FFT block uses modulo-M data wrapping to preserve all available input samples.

To avoid such magnitude increases, you can truncate the length of your input sample, P, to the FFT length, M. To do so, place a Pad block before the FFT block in your model.

Ports

Input

expand all

Input signal for computing the FFT. The block computes the FFT along the first dimension of the N-D input signal.

For more information on how the block computes the FFT, see Description and Algorithms.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point
Complex Number Support: Yes

Output

expand all

The FFT, computed across the first dimension of an N-D input array. When the output of the block has an integer or fixed-point data type, it is always signed.

The kth entry of the Lth output channel, y(k,L), equals the kth point of the M-point discrete Fourier transform (DFT) of the Lth input channel:

y(k,L)=p=1Pu(p,L)ej2π(p1)(k1)/Mk=1,,M

For more information on how the block computes the FFT, see Description and Algorithms.

Data Types: single | double | int8 | int16 | int32 | fixed point
Complex Number Support: Yes

Parameters

expand all

Main

Set this parameter to FFTW to support an arbitrary length input signal. The block restricts generated code with FFTW implementation to host computers capable of running MATLAB®.

Set this parameter to Radix-2 for bit-reversed processing, fixed or floating-point data, or portable C-code generation using the Simulink® Coder™. The dimension M of the M-by-N input matrix, must be a power of two. To work with other input sizes, use the Pad block to pad or truncate these dimensions to powers of two, or if possible choose the FFTW implementation. For more information about the algorithms used by the Radix-2 mode, see Radix-2 Implementation.

Set this parameter to Auto to let the block choose the FFT implementation. For floating-point inputs with non-power-of-two transform lengths, the FFTW algorithm is automatically chosen. Otherwise a Radix-2 algorithm is automatically chosen. For non-power-of-two transform lengths, the block restricts generated code to MATLAB host computers.

Designate the order of the output channel elements relative to the ordering of the input elements. When you select this check box, the output channel elements appear in bit-reversed order relative to the input ordering. If you clear this check box, the output channel elements appear in linear order relative to the input ordering.

Note

The FFT block calculates its output in bit-reversed order. Linearly ordering the FFT block output requires an extra bit-reversal operation. In many situations, you can increase the speed of the FFT block by selecting the Output in bit-reversed order check box.

For more information ordering of the output, see Linear and Bit-Reversed Output Order.

Dependencies

To enable this parameter, set FFT implementation to Auto or Radix-2.

When you select this parameter, the block divides the output of the FFT by the FFT length. This option is useful when you want the output of the FFT to stay in the same amplitude range as its input. This is particularly useful when working with fixed-point data types.

Select to inherit the FFT length from the input dimensions. When you select this check box, the input length must be a power of two.

Dependencies

When you do not select this check box, the FFT length parameter becomes available to specify the length.

Specify FFT length as an integer greater than or equal to two.

When you set the FFT implementation parameter to Radix-2, or when you check the Output in bit-reversed order check box, this value must be a power of two.

Dependencies

To enable this parameter, clear the Inherit FFT length from input dimensions check box.

Choose to wrap or truncate the input, depending on the FFT length. If you select this parameter, modulo-length data wrapping occurs before the FFT operation when the FFT length is shorter than the input length. If you clear this check box, truncation of the input data to the FFT length occurs before the FFT operation.

Dependencies

To enable this parameter, clear the Inherit FFT length from input dimensions check box.

Data Types

Select the rounding mode for fixed-point operations.

Limitations

The sine table values do not obey this parameter; instead, they always round to Nearest.

The Rounding mode parameter has no effect on numeric results when all these conditions are met:

  • Product output data type is Inherit: Inherit via internal rule.

  • Accumulator data type is Inherit: Inherit via internal rule.

With these data type settings, the block operates in full-precision mode.

When you select this parameter, the block saturates the result of its fixed-point operation. When you clear this parameter, the block wraps the result of its fixed-point operation. For details on saturate and wrap, see overflow mode for fixed-point operations.

Limitations

The Saturate on integer overflow parameter has no effect on numeric results when all these conditions are met:

  • Product output data type is Inherit: Inherit via internal rule.

  • Accumulator data type is Inherit: Inherit via internal rule.

With these data type settings, the block operates in full-precision mode.

Choose how to specify the word length of the values of the sine table. The fraction length of the sine table values always equals the word length minus one. You can set this parameter to:

  • A rule that inherits a data type, for example, Inherit: Same word length as input

  • An expression that evaluates to a valid data type, for example, fixdt(1,16)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Sine table parameter.

See Specify Data Types Using Data Type Assistant (Simulink) for more information.

Limitations

The sine table values do not obey the Rounding mode and Saturate on integer overflow parameters; instead, they are always saturated and rounded to Nearest.

Specify the product output data type. See Fixed Point and Multiplication Data Types for illustrations depicting the use of the product output data type in this block. You can set this parameter to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule. For more information on this rule, see Inherit via Internal Rule.

  • An expression that evaluates to a valid data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Product output parameter.

See Specify Data Types Using Data Type Assistant (Simulink) for more information.

Specify the accumulator data type. See Fixed Point for illustrations depicting the use of the accumulator data type in this block. You can set this parameter to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule. For more information on this rule, see Inherit via Internal Rule.

  • An expression that evaluates to a valid data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Accumulator parameter.

See Specify Data Types Using Data Type Assistant (Simulink) for more information.

Specify the output data type. See Fixed Point for illustrations depicting the use of the output data type in this block. You can set this parameter to:

  • A rule that inherits a data type, for example, Inherit: Inherit via internal rule.

    When you select Inherit: Inherit via internal rule, the block calculates the output word length and fraction length automatically. The equations that the block uses to calculate the ideal output word length and fraction length depend on the setting of the Divide output by FFT length check box.

    • When you select the Divide output by FFT length check box, the ideal output word and fraction lengths are the same as the input word and fraction lengths.

    • When you clear the Divide output by FFT length check box, the block computes the ideal output word and fraction lengths according to the following equations:

      WLideal output=WLinput+floor(log2(FFT length1))+1

      FLideal output=FLinput

    Using these ideal results, the internal rule then selects word lengths and fraction lengths that are appropriate for your hardware. For more information, see Inherit via Internal Rule.

  • An expression that evaluates to a valid data type, for example, fixdt(1,16,0)

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the Output parameter.

See Control Data Types of Signals (Simulink) for more information.

Specify the minimum value that the block should output. The default value is [] (unspecified). Simulink software uses this value to perform:

  • Simulation range checking (see Specify Signal Ranges (Simulink))

  • Automatic scaling of fixed-point data types

Specify the maximum value that the block should output. The default value is [] (unspecified). Simulink software uses this value to perform:

  • Simulation range checking (see Specify Signal Ranges (Simulink))

  • Automatic scaling of fixed-point data types

Select this parameter to prevent the fixed-point tools from overriding the data types you specify in the block dialog box.

Block Characteristics

Data Types

double | fixed point | integer | single

Direct Feedthrough

no

Multidimensional Signals

yes

Variable-Size Signals

yesa

Zero-Crossing Detection

no

a Variable-size signals are only supported when the Inherit FFT length from input dimensions checkbox is selected.

Algorithms

expand all

References

[1] Orfanidis, S. J. Introduction to Signal Processing. Upper Saddle River, NJ: Prentice Hall, 1996, p. 497.

[2] Proakis, John G. and Dimitris G. Manolakis. Digital Signal Processing, 3rd ed. Upper Saddle River, NJ: Prentice Hall, 1996.

[4] Frigo, M. and S. G. Johnson, “FFTW: An Adaptive Software Architecture for the FFT,”Proceedings of the International Conference on Acoustics, Speech, and Signal Processing, Vol. 3, 1998, pp. 1381-1384.

Extended Capabilities

Version History

Introduced before R2006a