Owning Palette: Order Analysis VIs

Requires: Sound and Vibration Toolkit

Computes a spectral map of the scaled signal [EU] as a function of time or rotational speed. This VI can return the spectral map as a 2D numeric array, a colormap, or a waterfall graph. Wire data to the scaled signal [EU] input to determine the polymorphic instance to use or manually select the instance.

Minimum Data Requirements This function requires a minimum amount of signal and speed profile data before an output will be returned. pulse/revolution , time/speed segment , max order and windows info will affect the amount of data required before an output is returned.

OAT Spectral Map (Intensity)OAT Spectral Map (Colormap)OAT Spectral Map (Waterfall)

OAT Spectral Map (Intensity)

plot type specifies the axis units of the 2D-array spectral map. The default is Frequency-Time.
0 Frequency-Time (default)€”Displays the time on the x-axis and frequency on the y-axis.
1 Time-Frequency €”Displays the frequency on the x-axis and the time on the y-axis.
2 Order-Time €”Displays the time on the x-axis and the order on the y-axis.
3 Time-Order €”Displays the order on the x-axis and the time on the y-axis.
4 Frequency-RPM €”Displays the RPM on the x-axis and the frequency on the y-axis.
5 RPM-Frequency €”Displays the frequency on the x-axis and the frequency on the y-axis.
6 Order-RPM €”Displays the RPM on the x-axis and the order on the y-axis.
7 RPM-Order €”Displays the order on the x-axis and the RPM on the y-axis.
reset? specifies the initialization of the internal states. The first time this VI runs, or when reset? is TRUE, the internal states initialize to zero. If reset? is FALSE, this VI sets the internal states to the final states from the previous call to the VI. The default is FALSE.
dB on? specifies whether to return the resulting 2D-array spectral map in decibels. If dB on? is FALSE, this VI returns the 2D-array spectral map linearly. The default is TRUE.
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.
speed profile specifies the arrival time and the rotational speed of each tachometer pulse.
time [s] specifies the arrival time, in seconds, of each tachometer pulse.
speed [RPM] specifies the rotational speed, in revolutions per minute, of each tachometer pulse.
pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
time/speed segment specifies the segment of the time-domain signal this VI analyzes, in seconds. This parameter only uses the unit seconds when the selected plot type is Frequency-Time , Time-Frequency , Time-Order , or Order-Time . time/speed segment [s or rpm] uses the unit rpm when the selected plot type is Frequency-RPM , RPM-Frequency , RPM-Order , or Order-RPM .
start specifies the value of the start time or rotational speed value. The default value is 0. The default condition causes this VI to use 0 as the start value for time or speed in run-up conditions, or use the start rpm value as the start value for speed in coastdown conditions.
end specifies the end value of time or rotational speed. The default value is 0. The default condition causes this VI to use positive infinity as the end value for time or speed in run-up conditions, or use 0 as the end value for speed in coastdown conditions.
step size specifies the time or rotational speed interval between two spectra. step size must be greater than 0. When specifying the time segment, the default value is 0, which causes the VI to use 0.1 s as step size . When specifying the speed segment, the default value is 0, which causes the VI to use 100 rpm as step size . Using a small step size can improve the time or rpm axis resolution.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.
windows info specifies the window settings the VI uses to compute the 2D-array spectral map.
window type specifies the window to apply to the 2D-array spectral map.
0 None
1 Hanning
2 Hamming
3 Blackman-Harris
4 Exact Blackman
5 Blackman
6 Flat Top
7 4 Term B-Harris
8 7 Term B-Harris
9 Low Sidelobe
10 Gaussian (default)
window length specifies the length of the window to apply to the 2D-array spectral map. window length must be a power of two and greater than or equal to 128. This VI rounds window length to the nearest valid value when window length is less than 128 or not a power of two. Increasing the value of window length can improve the frequency or order resolution but decreases the time or speed resolution. The default is 2048. When the selected plot type is Frequency-Time, Time-Frequency, Frequency-RPM, or RPM-Frequency, window length equals half of the frequency bins. If the plot type is Time-Order , Order-Time , RPM-Order , or Order-RPM , window length equals half of the order bins.
spectral map returns the two-dimensional representation of the spectra for the input signal .
spectral map info returns the scaling information about the spectral map .
scales returns the axis scales of the spectral map .
x scale returns the scaling information associated with the first index value of the 2D spectral map. offset (X0) and multiplier (deltaX) specify scaling values such that the final scaling value equals (deltaX)*X + X0.
offset returns the offset, or initial value, for scaling the data using (deltaX)*X + X0. If you change the offset, the scale no longer uses 0 as the origin of the plot.
multiplier returns the multiplier, or interval, for scaling data using (deltaX)*X + X0.
y scale returns the scaling information associated with the second index value of the 2D spectral map. offset and multiplier specify scaling values such that the final scaling value equals (deltaY*Y) + Y0.
offset returns the offset, or initial value, for scaling the data using (deltaY)*Y + Y0. If you change the offset, the scale no longer uses 0 as the origin of the plot.
multiplier returns the multiplier, or interval, for scaling data using (deltaY)*Y + Y0.
unit labels returns the units of the spectral map .
x-axis unit label returns the x-axis unit label of the spectral map .
y-axis unit label returns the y-axis unit label of the spectral map .
z-axis unit label specifies the z-axis unit label of the spectral map .
plot type returns the plot type of the spectral map .
dB on returns TRUE if the spectral map is in decibels.
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.
end reached? contains error information. This output provides standard error out functionality.
error out contains error information. This output provides standard error out functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.

OAT Spectral Map (Colormap)

plot type specifies the type of colormap to display. The default is Frequency-Time.
0 Frequency-Time (default)€”Displays the time on the x-axis and frequency on the y-axis.
1 Time-Frequency €”Displays the frequency on the x-axis and the time on the y-axis.
2 Order-Time €”Displays the time on the x-axis and the order on the y-axis.
3 Time-Order €”Displays the order on the x-axis and the time on the y-axis.
4 Frequency-RPM €”Displays the RPM on the x-axis and the frequency on the y-axis.
5 RPM-Frequency €”Displays the frequency on the x-axis and the frequency on the y-axis.
6 Order-RPM €”Displays the RPM on the x-axis and the order on the y-axis.
7 RPM-Order €”Displays the order on the x-axis and the RPM on the y-axis.
reset? specifies the initialization of the internal states. The first time this VI runs, or when reset? is TRUE, the internal states initialize to zero. If reset? is FALSE, this VI sets the internal states to the final states from the previous call to the VI. The default is FALSE.
dB on? specifies whether to return the resulting colormap in decibels. If dB on? is FALSE, this VI returns the colormap linearly. The default is TRUE.
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.
speed profile specifies the arrival time and the rotational speed of each tachometer pulse.
time [s] specifies the arrival time, in seconds, of each tachometer pulse.
speed [RPM] specifies the rotational speed, in revolutions per minute, of each tachometer pulse.
pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
time/speed segment specifies the segment of the time-domain signal this VI analyzes, in seconds. This parameter only uses the unit seconds when the selected plot type is Frequency-Time , Time-Frequency , Time-Order , or Order-Time . time/speed segment [s or rpm] uses the unit rpm when the selected plot type is Frequency-RPM , RPM-Frequency , RPM-Order , or Order-RPM .
start specifies the value of the start time or rotational speed value. The default value is 0. The default condition causes this VI to use 0 as the start value for time or speed in run-up conditions, or use the start rpm value as the start value for speed in coastdown conditions.
end specifies the end value of time or rotational speed. The default value is 0. The default condition causes this VI to use positive infinity as the end value for time or speed in run-up conditions, or use 0 as the end value for speed in coastdown conditions.
step size specifies the time or rotational speed interval between two spectra. step size must be greater than 0. When specifying the time segment, the default value is 0, which causes the VI to use 0.1 s as step size . When specifying the speed segment, the default value is 0, which causes the VI to use 100 rpm as step size . Using a small step size can improve the time or rpm axis resolution.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.
windows info specifies the window settings the VI uses to compute the colormap.
window type specifies the window to apply to the colormap.
0 None
1 Hanning
2 Hamming
3 Blackman-Harris
4 Exact Blackman
5 Blackman
6 Flat Top
7 4 Term B-Harris
8 7 Term B-Harris
9 Low Sidelobe
10 Gaussian (default)
window length specifies the length of the window to apply to the colormap. window length must be a power of two and greater than or equal to 128. This VI rounds window length to the nearest valid value when window length is less than 128 or not a power of two. Increasing the value of window length can improve the frequency or order resolution but decreases the time or speed resolution. The default is 2048. When the selected plot type is Frequency-Time, Time-Frequency, Frequency-RPM, or RPM-Frequency, window length equals half of the frequency bins. If the plot type is Time-Order , Order-Time , RPM-Order , or Order-RPM , window length equals half of the order bins.
colormap returns the colormap representation of the spectra for the input signal.
value returns the value of the resulting colormap.
x scale returns the scaling information associated with the first index value of the 2D spectral map. offset (X0) and multiplier (deltaX) specify scaling values such that the final scaling value equals (deltaX)*X + X0.
offset returns the offset, or initial value, for scaling the data using (deltaX)*X + X0. If you change the offset, the scale no longer uses 0 as the origin of the plot.
multiplier returns the multiplier, or interval, for scaling data using (deltaX)*X + X0.
y scale returns the scaling information associated with the second index value of the 2D spectral map. offset and multiplier specify scaling values such that the final scaling value equals (deltaY*Y) + Y0.
offset returns the offset, or initial value, for scaling the data using (deltaY)*Y + Y0. If you change the offset, the scale no longer uses 0 as the origin of the plot.
multiplier returns the multiplier, or interval, for scaling data using (deltaY)*Y + Y0.
colormap unit labels returns the units of the colormap .
x-axis unit label returns the x-axis unit label of the colormap .
y-axis unit label returns the y-axis unit label of the colormap .
z-axis unit label specifies the z-axis unit label of the colormap .
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.
end reached? contains error information. This output provides standard error out functionality.
error out contains error information. This output provides standard error out functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.

OAT Spectral Map (Waterfall)

plot type specifies the axis units of the waterfall graph. You cannot set plot type to Time-Frequency , Time-Order , RPM-Frequency , or RPM-Order for a waterfall graph.
0 Frequency-Time (default)€”Shows time on the x-axis and frequency on the y-axis.
1 Time-Frequency €”Shows frequency on the x-axis and time on the y-axis.
2 Order-Time €”Shows time on the x-axis and order on the y-axis.
3 Time-Order €”Shows order on the x-axis and time on the y-axis.
4 Frequency-RPM €”Shows revolutions-per-minute (RPM) on the x-axis and frequency on the y-axis.
5 RPM-Frequency €”Shows frequency on the x-axis and RPM on the y-axis.
6 Order-RPM €”Shows RPM on the x-axis and order on the y-axis.
7 RPM-Order €”Shows order on the x-axis and RPM on the y-axis.
reset? specifies the initialization of the internal states. The first time this VI runs, or when reset? is TRUE, the internal states initialize to zero. If reset? is FALSE, this VI sets the internal states to the final states from the previous call to the VI. The default is FALSE.
dB on? specifies whether to return the resulting waterfall graph in decibels. If dB on? is FALSE, this VI returns the waterfall graph linearly. The default is FALSE.
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.
speed profile specifies the arrival time and the rotational speed of each tachometer pulse.
time [s] specifies the arrival time, in seconds, of each tachometer pulse.
speed [RPM] specifies the rotational speed, in revolutions per minute, of each tachometer pulse.
pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
time/speed segment specifies the segment of the time-domain signal this VI analyzes, in seconds. This parameter only uses the unit seconds when the selected plot type is Frequency-Time , Time-Frequency , Time-Order , or Order-Time . time/speed segment [s or rpm] uses the unit rpm when the selected plot type is Frequency-RPM , RPM-Frequency , RPM-Order , or Order-RPM .
start specifies the value of the start time or rotational speed value. The default value is 0. The default condition causes this VI to use 0 as the start value for time or speed in run-up conditions, or use the start rpm value as the start value for speed in coastdown conditions.
end specifies the end value of time or rotational speed. The default value is 0. The default condition causes this VI to use positive infinity as the end value for time or speed in run-up conditions, or use 0 as the end value for speed in coastdown conditions.
step size specifies the time or rotational speed interval between two spectra. step size must be greater than 0. When specifying the time segment, the default value is 0, which causes the VI to use 0.1 s as step size . When specifying the speed segment, the default value is 0, which causes the VI to use 100 rpm as step size . Using a small step size can improve the time or rpm axis resolution.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.
windows info specifies the window settings the VI uses to compute the waterfall graph.
window type specifies the window to apply to the waterfall graph.
0 None
1 Hanning
2 Hamming
3 Blackman-Harris
4 Exact Blackman
5 Blackman
6 Flat Top
7 4 Term B-Harris
8 7 Term B-Harris
9 Low Sidelobe
10 Gaussian (default)
window length specifies the length of the window to apply to the waterfall graph. window length must be a power of two and greater than or equal to 128. This VI rounds window length to the nearest valid value when window length is less than 128 or not a power of two. Increasing the value of window length can improve the frequency or order resolution but decreases the time or speed resolution. The default is 2048. When the selected plot type is Frequency-Time, Time-Frequency, Frequency-RPM, or RPM-Frequency, window length equals half of the frequency bins. If the plot type is Time-Order , Order-Time , RPM-Order , or Order-RPM , window length equals half of the order bins.
waterfall graph returns the waterfall graph representation of the spectra for the input signal.
z0 returns the initial value of the first plot on the z-axis.
dz returns the interval between plots on the z-axis.
waveforms returns the waveform data of the waterfall graph.
f0 returns the start frequency of the waveform expressed in hertz.
df returns the frequency resolution of the waveform expressed in hertz.
magnitude returns the magnitude of the waveform.
waterfall unit labels returns the units of the waterfall graph .
x-axis unit label returns the x-axis unit label of the waterfall graph .
y-axis unit label returns the y-axis unit label of the waterfall graph .
z-axis unit label specifies the z-axis unit label of the waterfall graph .
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.
end reached? contains error information. This output provides standard error out functionality.
error out contains error information. This output provides standard error out functionality.
max order (auto) specifies the maximum order to analyze in the order spectrum. The maximum order used might be larger than the one you specify. If max order is less than 1 , the maximum order sets to 1. The default is 32.