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

Converts spectra from rectangular components to polar components. You can display magnitude and phase information on graphs and send this information to other Spectrum Extended Measurements VIs.

You can use this VI to convert one spectrum or N spectra. The data types you wire to the real spectrum and imaginary spectrum inputs determine the polymorphic instance to use.

Use the SVFA Magnitude and Phase to Real and Imaginary VI to convert polar components to rectangular components.

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

Select an instance SVFA Real and Imaginary to Magnitude and Phase (1 Channel)SVFA Real and Imaginary to Magnitude and Phase (N Channels)

SVFA Real and Imaginary to Magnitude and Phase (1 Channel)

	view specifies how this VI returns the converted spectrum or spectra. dB On specifies whether the magnitude results are expressed in decibels. The default is FALSE, which means magnitude results are expressed in engineering units. 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.
	real spectrum specifies the real part of the rectangular components. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. real part specifies the real part of the spectrum.
	imaginary spectrum specifies the imaginary part of the rectangular components. x0 specifies the start frequency or order of the spectrum. dx specifies the frequency or order resolution of the spectrum. imaginary part specifies the imaginary part of the spectrum.
	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.
	magnitude spectrum returns the frequency spacing and the magnitude of the spectrum in units of either amplitude or power. The spectrum info out parameter specifies the type of units. You can use the SVFA Unit Conversion VI to change the type of units. x0 returns the start frequency or order of the spectrum. dx returns the frequency or order resolution of the spectrum. magnitude returns the magnitude of the spectrum.
	magnitude unit label returns the unit label for the magnitude spectrum.
	phase spectrum returns the frequency spacing and the phase of the spectrum in units of degree or radian. The spectrum info out parameter specifies the type of units. You can use the SVFA Phase Unit Conversion VI to change the type of units. 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 spectrum.
	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 Real and Imaginary to Magnitude and Phase (N Channels)

	view specifies how this VI returns the converted spectrum or spectra. dB On specifies whether the magnitude results are expressed in decibels. The default is FALSE, which means magnitude results are expressed in engineering units. 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.
	real spectra specifies the real parts of the rectangular components. x0 specifies the start frequencies or orders of the spectra. dx specifies the frequencies or order resolutions of the spectra. real part specifies the real parts of the spectra.
	imaginary spectra specifies the imaginary parts of the spectra. x0 specifies the start frequencies or orders of the spectra. dx specifies the frequencies or order resolutions of the spectra. imaginary part specifies the imaginary parts of the spectra.
	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.
	magnitude spectra returns the frequency spacings and the magnitudes of the spectra in units of either amplitude or power. The spectrum info out parameter specifies the type of units. You can use the SVFA Unit Conversion VI to change the type of units. x0 returns the start frequencies or orders of the spectra. dx returns the frequencies or order resolutions of the spectra. magnitude returns the magnitudes of the spectra.
	magnitude unit labels returns the unit labels for the selected magnitude units.
	phase spectra returns the frequency spacings and the phases of the spectra in units of degree or radian. The spectrum info out parameter specifies the type of units. You can use the SVFA Phase Unit Conversion VI to change the type of units. x0 returns the start frequencies or orders of the spectra. dx returns the frequencies or order resolutions of the spectra. phase returns the phases of the spectra.
	phase unit labels returns the unit labels for the selected phase 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.