Admin Production ni-theme
Current Publication

CxInvFFTEx

LabWindows/CVI

CxInvFFTEx

Advanced Analysis Library Only

AnalysisLibErrType CxInvFFTEx (NIComplexNumber fft[], ssize_t numberOfElements, PFFTTable fftTable, int shifted, NIComplexNumber timeDomainSignal[]);

Purpose

Computes the complex inverse Fast Fourier Transform (FFT) of an input sequence. National Instruments recommends you use this function instead of InvFFT.

If you must perform the same size FFT repeatedly, you can use CreateFFTTable to create the FFT table and then pass the table you created to CxInvFFTEx to speed computation. If you pass NULL for fftTable, the function creates the table internally and frees the table when it returns.

The following code is the psuedocode for calling FFT routines:

            N=1024; //Set length of signal
            tbl=CreateFFTTable(N);  //Create N-point table
            for(;;){
                Acquire_N_Point_Signal(signal); //Acquire N points
                FFT(signal,..., tbl,...);       //Perform FFT or IFFT
            }
            DestroyFFTTable(tbl);       //End, release FFT table resources

Parameters

Input
Name Type Description
FFT NIComplexNumber [] The input frequency domain sequence.
numberOfElements ssize_t The number of elements in fft.
FFTTable PFFTTable The FFT table created with CreateFFTTable. You can pass NULL for this parameter if you do not have a reusable FFT table.
shifted int Specifies whether fft is DC-centered. shifted must be one of the following values:
  • FALSE (0): Not centered. The DC component is the first element of fft.
  • TRUE (1): Centered.
Output
Name Type Description
timeDomainSignal NIComplexNumber [] The complex time-domain signal.

Return Value

Name Type Description
status AnalysisLibErrType A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants.

Additional Information

Library: Advanced Analysis Library

Include file: analysis.h

LabWindows/CVI compatibility: LabWindows/CVI 8.0 and later