Extract Multiple Tone Information VI

Owning Palette: Waveform Measurements VIs

Requires: Full Development System

Returns the frequency, amplitude, and phase for each signal tone whose amplitude exceeds a specified threshold. Wire data to the time signal in input to determine the polymorphic instance to use or manually select the instance.

Details  Example

Use the pull-down menu to select an instance of this VI.

 Add to the block diagram  Find on the palette

Extract Multiple Tone Information 1 Chan

time signal in is the time-domain waveform.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signal in.
max num tones specifies the maximum number of tones that this VI extracts. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals contains the signals specified by export mode.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is one single tone.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information 1 Chan (CDB)

time signal in is the time-domain waveform.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signal in.
max num tones specifies the maximum number of tones that this VI extracts. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals contains the signals specified by export mode.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is one single tone.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information N Chan

time signals in is an array of time-domain waveforms.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signals in.
max num tones specifies the maximum number of tones that this VI extracts. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals is an array of exported signals.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is the multiple tone information for one signal in time signals in.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information N Chan (CDB)

time signals in is an array of time-domain waveforms.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signals in.
max num tones specifies the maximum number of tones that this VI extracts. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals is an array of exported signals.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is the multiple tone information for one signal in time signals in.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information N Chan - N Specs

time signals in is an array of time-domain waveforms.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signals in. Each element of the array is the threshold for one signal in time signals in.
max num tones specifies the maximum number of tones that this VI extracts from each signal. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals is an array of exported signals.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is the multiple tone information for one signal in time signals in.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information N Channels - N Specs (CDB)

time signals in is an array of time-domain waveforms.
export mode selects the source of the signal and spectrum to export to exported signals.

0none—Fastest computation
1input signal—Input signal only
2detected signal—Multiple tone
3residual signal—Signal minus tone
threshold specifies the minimum amplitude that each tone must exceed for this VI to extract it from time signals in. Each element of the array is the threshold for one signal in time signals in.
max num tones specifies the maximum number of tones that this VI extracts from each signal. If you set max num tones to –1, this VI extracts all tones whose amplitude exceeds threshold.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
output sorting specifies the sorting order of the tones that this VI extracts.

0increasing frequency
1decreasing amplitude
exported signals is an array of exported signals.
exported time signal is the waveform containing the exported time signal as selected by export mode.
exported spectrum (dB) is the spectrum of the exported time signal as selected by export mode.
f0 returns the start frequency, in hertz, of the spectrum.
df returns the frequency resolution, in hertz, of the spectrum.
dB Spectrum (Hann) is the magnitude spectrum of the (Hanning) windowed input signal, expressed in dB relative to 1.0 Vrms^2 for input signals in units of volts (V).
multiple tone information returns the frequency, amplitude, and phase of each tone that this VI extracts. Each element of the array is the multiple tone information for one signal in time signals in.
detected frequency is the frequency of the detected single tone in Hz.
detected amplitude is the peak amplitude of the detected single tone.
detected phase is the phase of the detected single tone in degrees.

Use the Wrap Angle VI to change the units of detected phase. Wire detected phase to the angle in input on the Wrap Angle VI, and select degree in, degree out or degree in, radians out for the angle units input.
error out contains error information. This output provides standard error out functionality.

Extract Multiple Tone Information Details

The input signal can be real or complex and single-channel, in the form of a waveform, or multichannel, in the form of an array of waveforms. If you wire an array of real waveforms to time signal in, LabVIEW selects the Extract Multiple Tone Information N Chan instance by default. If you wire an array of complex waveforms to time signal in, LabVIEW selects the Extract Multiple Tone Information N Chan (CDB) instance by default.

A real multiple tone signal can be expressed as shown in the following equation:

where Ai, fi, and i are the amplitude, frequency, and phase, respectively, of the ith tone of a multiple tone signal with N tones and Fs is the sample rate in samples per second of the input waveform signal.

A complex multiple tone signal can be expressed as shown in the following equation:

where Ai, fi, and i are the amplitude, frequency, and phase, respectively, of the ith tone of a multiple tone signal with N tones and Fs is the sample rate in samples per second of the input waveform signal.

For a real signal, the frequency range is (min frequency, max frequency) = (0, Fs/2). For a complex signal, the frequency range is (min frequency, max frequency) = (–Fs/2, Fs/2).

Example

Refer to the Complex Multi-Tone Measurements VI in the labview\examples\Signal Processing\Waveform Measurements directory for an example of using the Extract Multiple Tone Information VI.

 Open example  Find related examples