LabVIEW Sound and Vibration API Reference

SVT STFT vs Time VI

  • Updated2024-06-18
  • 11 minute(s) read

SVT STFT vs Time VI

Owning Palette: Transient Analysis VIs

Requires: Sound and Vibration Toolkit

Performs a short-time Fourier transform (STFT) on scaled signal [EU] and returns the power spectrum, waterfall, or colormap at the various times you specify. Wire data to the scaled signal [EU] input to determine the polymorphic instance to use or manually select the instance.

The colormap and waterfall instances return the data charted in either a colormap chart or waterfall graph, based on the selected instance.

SVT STFT vs Time (Intensity)

scaled signal [EU] specifies the scaled signal expressed in the selected engineering units. To obtain a properly scaled signal, you can use the SVL Scale Voltage to EU VI or define a virtual channel in National Instruments Measurement & Automation Explorer (MAX).
t0 specifies the start time of the waveform.
dt specifies the time interval in seconds between data points in the waveform.
Y specifies the data values of the waveform.
FFT block size specifies the number of samples used to compute one FFT. The default is 1,024.
window specifies the time-domain window to be used. The default is Hanning.

0Uniform
1Hanning (default)
2Hamming
3Blackman-Harris
4Exact Blackman
5Blackman
6Flat Top
74 Term B-Harris
87 Term B-Harris
9Low Sidelobe
time segment specifies which segment of the time-domain signal to analyze. Set from [s] to –1.00 s and to [s] to –1.00 s to analyze the entire time-domain signal.
from [s] specifies the initial value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data from the beginning of the time-domain signal.
to [s] specifies the final value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data to the end of the time-domain signal.
time increment specifies the time increment between two consecutive FFT blocks. The default is 100.00.
time increment units sets the units used to specify the time increment. The default is percentage, with 100 percent corresponding to no overlapping.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dB On specifies if results are expressed in decibels. The default is TRUE. The dB reference is specified when the scaling from voltage to engineering units is applied.
weighting specifies the weighting filter of interest. Use Linear if no weighting is needed.

0Linear (default)
1A-weighting
2B-weighting
3C-weighting
power spectra [dB EU] returns the power spectra.
unit label returns the selected engineering units.
f0 and delta f [Hz] returns scaling information for the frequency axes of the power spectra.
f0 returns the minimum value of the frequency axis expressed in hertz.
delta f returns the frequency resolution expressed in hertz.
t0 and delta t [s] returns the minimum value of the time segment and the increment.
t0 returns the minimum value of the time segment expressed in seconds.
delta t returns the time increment expressed in seconds.
error out contains error information. This output provides standard error out functionality.
spectrum info returns information about the spectrum needed by the Spectrum Extended Measurements VIs, the Display VIs, and the Tone and Distortion VIs.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.

SVT STFT vs Time (Waterfall)

scaled signal [EU] specifies the scaled signal expressed in the selected engineering units. To obtain a properly scaled signal, you can use the SVL Scale Voltage to EU VI or define a virtual channel in National Instruments Measurement & Automation Explorer (MAX).
t0 specifies the start time of the waveform.
dt specifies the time interval in seconds between data points in the waveform.
Y specifies the data values of the waveform.
FFT block size specifies the number of samples used to compute one FFT. The default is 1,024.
window specifies the time-domain window to be used. The default is Hanning.

0Uniform
1Hanning (default)
2Hamming
3Blackman-Harris
4Exact Blackman
5Blackman
6Flat Top
74 Term B-Harris
87 Term B-Harris
9Low Sidelobe
time segment specifies which segment of the time-domain signal to analyze. Set from [s] to –1.00 s and to [s] to –1.00 s to analyze the entire time-domain signal.
from [s] specifies the initial value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data from the beginning of the time-domain signal.
to [s] specifies the final value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data to the end of the time-domain signal.
time increment specifies the time increment between two consecutive FFT blocks. The default is 100.00.
time increment units sets the units used to specify the time increment. The default is percentage, with 100 percent corresponding to no overlapping.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dB On specifies if results are expressed in decibels. The default is TRUE. The dB reference is specified when the scaling from voltage to engineering units is applied.
weighting specifies the weighting filter of interest. Use Linear if no weighting is needed.

0Linear (default)
1A-weighting
2B-weighting
3C-weighting
waterfall graph returns an array of 2D waveform signals in three dimensions. You can display this information with the Waterfall graph.
z0 returns the initial value of the first plot on the z-axis.
dz returns the interval between plots on the z-axis.
plots returns the data on the waterfall graph.
x0 returns the initial value on the x-axis.
dx returns the interval between points on the waterfall graph.
Y returns the values of the points on the waterfall graph.
unit label returns the selected engineering units.
error out contains error information. This output provides standard error out functionality.
spectrum info returns information about the spectrum needed by the Spectrum Extended Measurements VIs, the Display VIs, and the Tone and Distortion VIs.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.

SVT STFT vs Time (Colormap)

scaled signal [EU] specifies the scaled signal expressed in the selected engineering units. To obtain a properly scaled signal, you can use the SVL Scale Voltage to EU VI or define a virtual channel in National Instruments Measurement & Automation Explorer (MAX).
t0 specifies the start time of the waveform.
dt specifies the time interval in seconds between data points in the waveform.
Y specifies the data values of the waveform.
FFT block size specifies the number of samples used to compute one FFT. The default is 1,024.
window specifies the time-domain window to be used. The default is Hanning.

0Uniform
1Hanning (default)
2Hamming
3Blackman-Harris
4Exact Blackman
5Blackman
6Flat Top
74 Term B-Harris
87 Term B-Harris
9Low Sidelobe
time segment specifies which segment of the time-domain signal to analyze. Set from [s] to –1.00 s and to [s] to –1.00 s to analyze the entire time-domain signal.
from [s] specifies the initial value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data from the beginning of the time-domain signal.
to [s] specifies the final value for the time segment expressed in seconds. The default is –1.00 s. The default value specifies to analyze the data to the end of the time-domain signal.
time increment specifies the time increment between two consecutive FFT blocks. The default is 100.00.
time increment units sets the units used to specify the time increment. The default is percentage, with 100 percent corresponding to no overlapping.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
dB On specifies if results are expressed in decibels. The default is TRUE. The dB reference is specified when the scaling from voltage to engineering units is applied.
weighting specifies the weighting filter of interest. Use Linear if no weighting is needed.

0Linear (default)
1A-weighting
2B-weighting
3C-weighting
colormap returns the spectral results converted from the waterfall data. You can display this cluster as a Colormap to show the transient results on an intensity graph with a rainbow color scale.
spectral map returns the 2D array of magnitude data converted according to the scaling parameters.
X scale returns the scaling information associated with the first index of the 2D spectral map.
offset returns the x value associated with elements (0, n) of spectral map.
multiplier returns the x-axis spacing between consecutive elements in a column.
Y scale returns the scaling information associated with the second index of the 2D spectral map.
offset returns the y value associated with elements (n, 0) of spectral map.
multiplier returns the y-axis spacing between consecutive elements in a row.
attribute returns additional information about the spectra. LabVIEW uses this information to display the data properly and to perform extended measurements.
unit label returns the selected engineering units.
error out contains error information. This output provides standard error out functionality.
spectrum info returns information about the spectrum needed by the Spectrum Extended Measurements VIs, the Display VIs, and the Tone and Distortion VIs.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.

Log in to get a better experience