Computes the online short-time Fourier transform (STFT)-based spectrogram for signal. Wire data to the signal input to determine the polymorphic instance to use or manually select the instance.


icon

Inputs/Outputs

  • cbool.png reassigned? (F) —

    reassigned? specifies whether to reassign the spectrogram by moving dispersed energy to the local center of gravity in the joint time-frequency domain. The reassignment can improve the readability of the spectrogram. The default is FALSE.

  • cbool.png reset? (F) —

    reset? specifies whether to clear the buffer for the online computation and use the new window info you specify. The default is FALSE.

  • c1ddbl.png signal —

    signal specifies the input signal.

  • cnclst.png time-frequency sampling info —

    time-frequency sampling info specifies the density to use to sample the signal in the time-frequency domain and defines the size of the resulting 2D time-frequency array.

  • ci32.png time steps —

    time steps specifies the sampling period, in samples, along the time axis in the joint time-frequency domain. The default is -1, which specifies that this VI adjusts time steps automatically so that no more than 512 rows exist in spectrogram.

  • ci32.png frequency bins —

    frequency bins is the FFT block size of the STFT. frequency bins must be a power of 2 and greater than 0. The scale info output contains the actual sampling period in hertz along the frequency axis.

  • cnclst.png window info —

    window info specifies the sliding window to use to truncate the signal and defines the resolution of the resulting time-frequency representation.

  • ci32.png type —

    type specifies the type of the sliding window.

  • ci32.png length —

    length specifies the length, in samples, of the sliding window. The default is -1, which indicates that this VI sets the window length to four times time steps. Thus, the overlap between sliding windows is 75 percent. However, this VI wraps the default window length to 64 when time steps is less than 16.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • c1ddbl.png user defined window —

    user defined window specifies the sliding window to use to compute the STFT. If you specify a value for user defined window, this VI ignores the settings in the window info input.

  • cdbl.png sampling rate —

    sampling rate specifies the sampling rate of signal in hertz. sampling rate must be greater than 0, or this VI sets sampling rate to 1 automatically. The default is 1.

  • i2ddbl.png spectrogram —

    spectrogram returns the quadratic time-frequency representation of the signal. Each row corresponds to the instantaneous power spectrum at a certain time.

  • ifxdt.png scale info —

    scale info returns the time scale and the frequency scale information of the time-frequency representation, including the time offset, the time interval between every two contiguous rows, the frequency offset, and the frequency interval between every two contiguous columns of spectrogram. Use the TFA Get Time and Freq Scale Info VI to return detailed information about the time scale and the frequency scale.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Examples

    Refer to the following VIs for examples of using the TFA Online STFT Spectrogram VI:

    • Online Spectrogram Monitoring (Simulated) VI: labview\examples\Time Frequency Analysis\TFAFunctions
    • Online Spectrogram Monitoring (DAQmx) VI: labview\examples\Time Frequency Analysis\TFAFunctions
    • Online Spectrogram Monitoring (Sound Card) VI: labview\examples\Time Frequency Analysis\TFAFunctions