You are here: NI Home > Support > Product Reference > Manuals > Sound and Vibration Measurement Suite 6.0 Help

Converts between dB/linear, magnitude/magnitude^2, rms/peak/peak-peak, spectrum/spectral density, and dB ref1/dB ref2. You can use this polymorphic VI to convert a single spectrum, N spectra, a single complex spectrum, N complex spectra, a single channel of XY data, N channels of XY data, a single channel with M orders of XY data, N channels with M orders of XY data, waterfall data, or colormap data. The data type you wire to the spectrum or magnitudes input determines the polymorphic instance to use.

Details  

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

Select an instance SVFA Unit Conversion (1Ch) (Real Spectrum)SVFA Unit Conversion (N Ch) (Real Spectrum)SVFA Unit Conversion (1Ch) (Complex Spectrum)SVFA Unit Conversion (N Ch) (Complex Spectrum)SVFA Unit Conversion (1 Ch) (XY Spectrum)SVFA Unit Conversion (N Ch) (XY Spectrum)SVFA Unit Conversion (1 Ch, M Orders) (XY Spectrum)SVFA Unit Conversion (N Ch, M Orders) (XY Spectrum)SVFA Unit Conversion (Waterfall)SVFA Unit Conversion (Colormap)

SVFA Unit Conversion (1Ch) (Real Spectrum)

	spectrum specifies the abscissa scaling and the magnitude of the spectrum. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. magnitude specifies the magnitude of the spectrum.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	spectrum info in specifies the properties of the previously computed spectrum. spectrum info in includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Note  You must connect spectrum info in when performing extended measurements. Do not modify the spectrum info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted spectrum returns the converted spectrum that has been scaled according to desired scaling and spectral density desired. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. magnitude is the magnitude of the converted spectrum.
	unit label returns the selected engineering units.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (N Ch) (Real Spectrum)

	spectra specifies the data for each spectrum. spectrum specifies the abscissa scaling and the magnitude of the spectrum. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. magnitude specifies the magnitude of the spectrum.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	spectrum info in specifies the properties of the previously computed spectrum. spectrum info in includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Note  You must connect spectrum info in when performing extended measurements. Do not modify the spectrum info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted spectra returns the converted spectra that have been scaled according to desired scaling and spectral density desired. converted spectrum returns the converted spectrum that has been scaled according to desired scaling and spectral density desired. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. magnitude is the magnitude of the converted spectrum.
	unit labels returns the unit label for each channel.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (1Ch) (Complex Spectrum)

	complex spectrum is the complex form of the spectrum with spectrum information. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. complex spectrum is the complex form of the computed spectrum.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	unwrap phase specifies whether this VI unwraps the phase. Phase unwrapping eliminates discontinuities with an absolute value greater than pi. If you set unwrap phase to TRUE, this VI unwraps the phase. The default is FALSE, which means this VI wraps the phase between -pi and pi.
	convert to degree specifies whether this VI expresses phase results in degrees or radians. If you set convert to degree to FALSE, this VI expresses phase results in radians. The default is TRUE, which means this VI expresses phase results in degrees.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted spectrum returns the converted spectrum that has been scaled according to desired scaling and spectral density desired. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. magnitude is the magnitude of the converted spectrum.
	magnitude unit label returns the unit label for the selected magnitude units.
	phase spectrum returns the phase of the spectrum. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. phase returns the phase of the frequency response.
	phase unit label returns the unit label for the phase spectrum.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (N Ch) (Complex Spectrum)

	complex spectra are the complex forms of the computed spectra with spectrum information. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. complex spectrum is the complex form of the computed spectrum.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	unwrap phase specifies whether this VI unwraps the phase. Phase unwrapping eliminates discontinuities with an absolute value greater than pi. If you set unwrap phase to TRUE, this VI unwraps the phase. The default is FALSE, which means this VI wraps the phase between -pi and pi.
	convert to degree specifies whether this VI expresses phase results in degrees or radians. If you set convert to degree to FALSE, this VI expresses phase results in radians. The default is TRUE, which means this VI expresses phase results in degrees.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted spectra returns the converted spectra that have been scaled according to desired scaling and spectral density desired. converted spectrum returns the converted spectrum that has been scaled according to desired scaling and spectral density desired. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. magnitude is the magnitude of the converted spectrum.
	magnitude unit labels returns the magnitude unit label of each spectrum.
	phase spectra returns the phases of the spectra. phase spectrum returns the phase of the spectrum. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. phase returns the phase of the frequency response.
	phase unit labels returns the phase unit label of each spectrum.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (1 Ch) (XY Spectrum)

	magnitudes contains the magnitude of an individual order. time/rev/rpm specifies the x-axis value of the plot. magnitude specifies the y-axis value of the plot.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	magnitude info in specifies the properties of the computed magnitudes. Do not modify the magnitude info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted magnitudes returns the magnitudes converted according to the scaling parameters. time/rev/rpm returns the x-axis value of the magnitude plot. magnitude returns the y-axis value of the magnitude plot, expressed in RMS value.
	unit label returns the selected engineering units.
	magnitude info out returns the properties of the computed magnitudes. Do not modify the magnitude info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (N Ch) (XY Spectrum)

	magnitudes contains the magnitude of the specified orders. time/rev/rpm specifies the x-axis value of the plot. magnitude specifies the y-axis value of the plot.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	magnitudes info in specifies properties of the computed spectrum. Do not modify the magnitudes info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted magnitudes returns the magnitudes converted according to the scaling parameters. converted magnitudes returns the magnitudes converted according to the scaling parameters. time/rev/rpm returns the x-axis value of the magnitude plot. magnitude returns the y-axis value of the magnitude plot, expressed in RMS value.
	unit labels returns the unit label for each channel.
	magnitudes info out returns the properties of the computed spectrum. Do not modify the magnitudes info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (1 Ch, M Orders) (XY Spectrum)

	magnitudes specifies the magnitude of each order. time/rev/rpm specifies the x-axis value of the plot. magnitude specifies the y-axis value of the magnitude plot.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectrum info in specifies the properties of the previously computed spectrum. spectrum info in includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Note  You must connect spectrum info in when performing extended measurements. Do not modify the spectrum info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted magnitudes returns the magnitudes converted according to the scaling parameters. time/rev/rpm returns the x-axis value of the magnitude plot. magnitude returns the y-axis value of the magnitude plot, expressed in RMS value.
	unit label returns the selected engineering units.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (N Ch, M Orders) (XY Spectrum)

	magnitudes specifies the magnitude of each order. time/rev/rpm specifies the x-axis value of the plot. magnitude specifies the y-axis value of the magnitude plot.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	magnitudes info in specifies properties of the computed spectrum. Do not modify the magnitudes info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted magnitudes returns the magnitudes converted according to the scaling parameters. time/rev/rpm returns the x-axis value of the magnitude plot. magnitude returns the y-axis value of the magnitude plot, expressed in RMS value.
	unit labels returns the unit label for each channel.
	magnitude info out returns the properties of the computed magnitudes. Do not modify the magnitude info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (Waterfall)

	waterfall specifies an array of 2D waveform signals in three dimensions. z0 specifies the initial value of the first plot on the z-axis. dz specifies the interval between plots on the z-axis. plots specifies the data on the waterfall graph. x0 specifies the initial value on the x-axis. dx specifies the interval between points on the waterfall graph. Y specifies the values of the points on the waterfall graph.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	spectrum info in specifies the properties of the previously computed spectrum. spectrum info in includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Note  You must connect spectrum info in when performing extended measurements. Do not modify the spectrum info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted waterfall 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.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion (Colormap)

	colormap specifies the spectral results of a transient analysis. spectral map specifies the 2D array of magnitude data for the spectra. X scale specifies the scaling information associated with the first index of the 2D spectral map. offset and multiplier specify scaling values such that the final value equals (deltaX)*X + Xo. offset specifies the offset, or initial value, for scaling data using (deltaX)*X + Xo. If you change the offset, the scale no longer uses 0 as the origin of the plot. multiplier specifies the multiplier, or interval, for scaling data using (deltaX)*X + Xo. Y scale specifies the scaling information associated with the first index of the 2D spectral map. offset and multiplier specify scaling values such that the final value equals (deltaY)*Y + Yo. offset specifies the offset, or initial value, for scaling data using (deltaY)*Y + Yo. If you change the offset, the scale no longer uses 0 as the origin of the plot. multiplier specifies the multiplier, or interval, for scaling data using (deltaY)*Y + Yo. attribute specifies additional information about the spectra. LabVIEW uses this information to display the data properly and to perform extended measurements.
	desired scaling specifies the scaling applied in the converted spectrum. linear/dB specifies whether this VI expresses results in engineering units or decibels. 0 no change (Default) 1 linear—Specifies that this VI expresses results in engineering units. 2 dB—Specifies that this VI expresses results in decibels. dB reference specifies the dB reference in the desired scaling of the converted spectrum. The default is 0.00, or no change. power/magnitude specifies whether this VI expresses results in units of magnitude or power (magnitude^2). 0 no change (default) 1 power 2 magnitude view specifies the peak scaling of the converted spectrum. 0 no change (default) 1 rms 2 peak 3 peak-peak
	spectral density desired specifies whether or not the converted spectrum must be returned as spectral density. 0 no change (default) 1 spectrum 2 spectral density
	spectrum info in specifies the properties of the previously computed spectrum. spectrum info in includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Note  You must connect spectrum info in when performing extended measurements. Do not modify the spectrum info in values.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Refer to Controlling Error Notification to treat what is normally an error as no error or to treat a warning as an error. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	converted colormap returns the spectral results converted according to the scaling parameters. You can display this cluster Colormap Graph 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.
	spectrum info out returns the properties of the computed spectrum. spectrum info out includes the channel name, spectrum type, spectrum scale as linear or dB, applied window, window size, FFT size, units, x-axis units, dB reference, applied weighting, peak units, and spectral density. Do not modify the spectrum info out values.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

SVFA Unit Conversion Details

The following table lists the units supported by the SVFA Unit Conversion VI.

Spectrum Attribute	Options
Spectrum type	Amplitude [Magnitude]; Power [Magnitude^2]
Scaling	Linear; dB
Peak units	RMS; Peak (pk); Peak-to-Peak (peak-peak)
dB reference	Any reference greater than 0
Spectral density	Spectrum; Spectral density

Enter the desired dB reference in the desired units of the output spectrum.

This VI does not automatically perform conversions on the dB reference. If the input spectrum is expressed in dB peak ref 10V and you want to express the spectrum in dB RMS ref 7.07V, you must enter 7.07 in the dB reference subparameter of the desired scaling control in addition to changing the view subparameter of the desired scaling control to rms. The dB reference subparameter always has the same peak units as the converted spectrum.

Note  The SVFA Unit Conversion VI operates on amplitude, power, and complex spectra. The VI also operates on magnitudes in XY format.