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

Owning Palette: Utility VIs

Installed With: Sound and Vibration Measurement Suite

Divides an input signal into even-time segments or even-speed intervals. The input signal of this VI can be an even-angle signal or an XY signal. When you use this VI to divide an XY signal, the XY signal can be only the output of the OAT Order Magnitude and Phase VI, OAT Overall Level Plot VI, or Order Tracking Express VI.

You must manually select the polymorphic instance you want to use.

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

Select an instance OAT Even Time or Speed Segment (Even Angle, 1 Channel)OAT Even Time or Speed Segment (Even Angle, N Channels)OAT Even Time or Speed Segment (XY)OAT Even Time or Speed Segment (XY, 1D Array)OAT Even Time or Speed Segment (XY, 2D Array)

OAT Even Time or Speed Segment (Even Angle, 1 Channel)

	reset? specifies the initialization of the internal states. If reset? is TRUE, or when the VI first runs, 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.
	segment unit specifies whether to divide the input signal into even-time segments or even-speed intervals. 0 Time (s) (Default) 1 Speed (RPM)
	even-angle signal specifies the even-angle-resampled data. even-angle signal is synchronous to the rotational speed with a constant number of samples per revolution. r0 specifies the starting index value for counting revolutions. dr specifies the revolution interval between two sequential samples. Y specifies the value of the even-angle-spaced sample in a scaled engineering unit.
	even-angle channel info specifies the information about the measurement configuration that this VI uses to acquire the resampled data. Do not change the values in even-angle channel info.
	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.
	error in describes error conditions that occur before this node runs. The default is no error. If an error occurred before this node runs, the node passes the error in value to error out. This node runs normally only if no error occurred before this node runs. If an error occurs while this node 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. 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 node ran or FALSE (checkmark) to indicate a warning or that no error occurred before this node 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 node that produced the error or warning. The default is an empty string.
	segment settings specifies the settings for the input even-angle signal segments. When segment unit is Time (s), this VI divides the input signal into even-time segments. When segment unit is Speed (RPM) this VI divides the input signal into even-speed intervals. start specifies the start value. The default is 0. In creating even-speed segments, if you set start to 0.00, this VI sets the actual start speed value as the start value for run-down test. end specifies the end value. The default is 0.00. If you set end to 0, this VI uses positive infinity as the end value for time or speed in run-up test or uses 0 as the end value for speed in run-down test. step size specifies the interval between two segments. The default is 0.00. In creating even-time segments, step size must be greater than 0. This VI uses 0.1 as the step size if you set step size to the default value. In creating even-speed segments, this VI uses 50 as the step size if you set step size to the default value.
	segment block size specifies the block size of the even-angle signal at each even-time or even-speed segment. The default is 128.
	even-angle signal out returns the segments of the input even-angle signal at specified time or speed intervals. r0 returns the starting index value for counting revolutions. dr returns the revolution interval between two sequential samples. Y returns the value of the even-angle-spaced sample in a scaled engineering unit.
	dup even-angle channel info returns even-angle channel info unchanged.
	new signal available? returns TRUE if the input even-angle signal contains segments at the time or speed intervals that you specified in segment settings.
	current segment status returns the information of the output segment. rev returns the revolution index of the output segment. time returns the time instance of the output segment. RPM returns the RPM value of the output segment. end reached? indicates whether the output segment reaches the end time or speed value you specified in segment settings.
	error out contains error information. If error in indicates that an error occurred before this node ran, error out contains the same error information. Otherwise, it describes the error status that this node 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 node that produced the error or warning.
	actual segment settings returns the segment settings that this VI used to divide the input even-angle signal into segments. actual start returns the start value this VI used to divide the input even-angle signal into segments. actual end returns the end value this VI used to divide the input even-angle signal into segments. actual step size returns the actual interval between two segments.

OAT Even Time or Speed Segment (Even Angle, N Channels)

	reset? specifies the initialization of the internal states. If reset? is TRUE, or when the VI first runs, 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.
	segment unit specifies whether to divide the input signal into even-time segments or even-speed intervals. 0 Time (s) (Default) 1 Speed (RPM)
	even-angle signals specifies the even-angle-resampled data. even-angle signals are synchronous to the rotational speed with constant number of samples per revolution. r0 specifies the starting index value for counting revolutions. dr specifies the revolution interval between two sequential samples. Y specifies the value of the even-angle-spaced sample in scaled engineering unit.
	even-angle channel info specifies the information about the measurement configuration that this VI uses to acquire the resampled data. Do not change the values in even-angle channel info.
	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.
	error in describes error conditions that occur before this node runs. The default is no error. If an error occurred before this node runs, the node passes the error in value to error out. This node runs normally only if no error occurred before this node runs. If an error occurs while this node 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. 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 node ran or FALSE (checkmark) to indicate a warning or that no error occurred before this node 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 node that produced the error or warning. The default is an empty string.
	segment settings specifies the settings for the input even-angle signal segments. When segment unit is Time (s), this VI divides the input signal into even-time segments. When segment unit is Speed (RPM) this VI divides the input signal into even-speed intervals. start specifies the start value. The default is 0. In creating even-speed segments, if you set start to 0.00, this VI sets the actual start speed value as the start value for run-down test. end specifies the end value. The default is 0.00. If you set end to 0, this VI uses positive infinity as the end value for time or speed in run-up test or uses 0 as the end value for speed in run-down test. step size specifies the interval between two segments. The default is 0.00. In creating even-time segments, step size must be greater than 0. This VI uses 0.1 as the step size if you set step size to the default value. In creating even-speed segments, this VI uses 50 as the step size if you set step size to the default value.
	segment block size specifies the block size of the even-angle signal at each even-time or even-speed segment. The default is 128.
	even-angle signals out returns the even-angle signal segments at specified time or speed intervals. r0 returns the starting index value for counting revolutions. dr returns the revolution interval between two sequential samples. Y returns the value of the even-angle-spaced sample in a scaled engineering unit.
	dup even-angle channel info returns even-angle channel info unchanged.
	new signal available? returns TRUE if the input even-angle signal contains segments at the time or speed intervals that you specified in segment settings.
	current segment status returns the information of the output segment. rev returns the revolution index of the output segment. time returns the time instance of the output segment. RPM returns the RPM value of the output segment. end reached? indicates whether the output segment reaches the end time or speed value you specified in segment settings.
	error out contains error information. If error in indicates that an error occurred before this node ran, error out contains the same error information. Otherwise, it describes the error status that this node 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 node that produced the error or warning.
	actual segment settings returns the segment settings that this VI used to divide the input even-angle signal into segments. actual start returns the start value this VI used to divide the input even-angle signal into segments. actual end returns the end value this VI used to divide the input even-angle signal into segments. actual step size returns the actual interval between two segments.

OAT Even Time or Speed Segment (XY)

	phase input? specifies whether the input XY signal is a phase input. The default is FALSE.
	reset? specifies the initialization of the internal states. If reset? is TRUE, or when the VI first runs, 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.
	x-axis selection specifies the scale type to use for the x-axis of the output XY graph. 0 Time 1 Revolution 2 RPM (Default)
	XY signal specifies the XY signal to divide into segments. X specifies the x-axis value of the XY signal. Y specifies the y-axis value of the XY signal.
	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.
	position info specifies the position information of the input XY signal. positions [s] specifies the locations of the samples, in seconds. samples/rev specifies the number of samples in one revolution.
	pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
	error in describes error conditions that occur before this node runs. The default is no error. If an error occurred before this node runs, the node passes the error in value to error out. This node runs normally only if no error occurred before this node runs. If an error occurs while this node 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. 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 node ran or FALSE (checkmark) to indicate a warning or that no error occurred before this node 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 node that produced the error or warning. The default is an empty string.
	segment settings specifies the settings for dividing the input XY signal into segments. The scale type you specified in x-axis selection determines the unit of segment settings. start specifies the start value. The default is 0. In creating even-speed segments, if you set start to 0.00, this VI sets the actual start speed value as the start value for run-down test. end specifies the end value. The default is 0.00. If you set end to 0, this VI uses positive infinity as the end value for time or speed in run-up test or uses 0 as the end value for speed in run-down test. step size specifies the interval between two segments. The default is 0.00. In creating even-time segments, step size must be greater than 0. This VI uses 0.1 as the step size if you set step size to the default value. In creating even-speed segments, this VI uses 50 as the step size if you set step size to the default value.
	view info specifies the measurement information of the XY signal. dB on? specifies whether the XY signal is in decibels. The default is FALSE. unwrap phase? specifies whether the phase is unwrapped if the XY signal is a phase input. The default is TRUE. unit in degree? specifies whether the phase is in degrees or in radians when the XY signal is a phase input. The default is TRUE.
	XY signal out returns the XY signal segments. X returns the x-axis value of the XY signal. Y returns the y-axis value of the XY signal.
	position info out returns the position information of XY signal out. positions [s] returns the locations of the samples, in seconds. samples/rev returns the number of samples in one revolution.
	end reached? indicates whether the output segment reaches the end time or speed value you specified in segment settings.
	error out contains error information. If error in indicates that an error occurred before this node ran, error out contains the same error information. Otherwise, it describes the error status that this node 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 node that produced the error or warning.
	actual segment settings returns the segment settings that this VI used to divide the input XY signal into segments. actual start returns the start value this VI used to divide the input XY signal into segments. actual end returns the end value this VI used to divide the input XY signal into segments. actual step size returns the actual interval between two segments.

OAT Even Time or Speed Segment (XY, 1D Array)

	phase input? specifies whether the input XY signal is a phase input. The default is FALSE.
	reset? specifies the initialization of the internal states. If reset? is TRUE, or when the VI first runs, 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.
	x-axis selection specifies the scale type to use for the x-axis of the output XY graph. 0 Time 1 Revolution 2 RPM (Default)
	XY signals specifies the XY signals to divide into segments. X specifies the x-axis value of the XY signal. Y specifies the y-axis value of the XY signal.
	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.
	position info specifies the position information of the input XY signal. positions [s] specifies the locations of the samples, in seconds. samples/rev specifies the number of samples in one revolution.
	pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
	error in describes error conditions that occur before this node runs. The default is no error. If an error occurred before this node runs, the node passes the error in value to error out. This node runs normally only if no error occurred before this node runs. If an error occurs while this node 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. 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 node ran or FALSE (checkmark) to indicate a warning or that no error occurred before this node 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 node that produced the error or warning. The default is an empty string.
	segment settings specifies the settings for dividing the input XY signal into segments. The scale type you specified in x-axis selection determines the unit of segment settings. start specifies the start value. The default is 0. In creating even-speed segments, if you set start to 0.00, this VI sets the actual start speed value as the start value for run-down test. end specifies the end value. The default is 0.00. If you set end to 0, this VI uses positive infinity as the end value for time or speed in run-up test or uses 0 as the end value for speed in run-down test. step size specifies the interval between two segments. The default is 0.00. In creating even-time segments, step size must be greater than 0. This VI uses 0.1 as the step size if you set step size to the default value. In creating even-speed segments, this VI uses 50 as the step size if you set step size to the default value.
	view info specifies the measurement information of the XY signals. dB on? specifies whether the XY signals is in decibels. The default is FALSE. unwrap phase? specifies whether the phase is unwrapped if the XY signals is a phase input. The default is TRUE. unit in degree? specifies whether the phase is in degrees or in radians when the XY signals is a phase input. The default is TRUE.
	XY signals out returns the XY signals segments. X returns the x-axis value of the XY signal. Y returns the y-axis value of the XY signal.
	position info out returns the position information of XY signals out. positions [s] returns the locations of the samples, in seconds. samples/rev returns the number of samples in one revolution.
	end reached? indicates whether the output segment reaches the end time or speed value you specified in segment settings.
	error out contains error information. If error in indicates that an error occurred before this node ran, error out contains the same error information. Otherwise, it describes the error status that this node 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 node that produced the error or warning.
	actual segment settings returns the segment settings that this VI used to divide the input XY signal into segments. actual start returns the start value this VI used to divide the input XY signal into segments. actual end returns the end value this VI used to divide the input XY signal into segments. actual step size returns the actual interval between two segments.

OAT Even Time or Speed Segment (XY, 2D Array)

	phase input? specifies whether the input XY signal is a phase input. The default is FALSE.
	reset? specifies the initialization of the internal states. If reset? is TRUE, or when the VI first runs, 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.
	x-axis selection specifies the scale type to use for the x-axis of the output XY graph. 0 Time 1 Revolution 2 RPM (Default)
	XY signals specifies the XY signals to divide into segments. X specifies the x-axis value of the XY signal. Y specifies the y-axis value of the XY signal.
	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.
	position info specifies the position information of the input XY signal. positions [s] specifies the locations of the samples, in seconds. samples/rev specifies the number of samples in one revolution.
	pulse/revolution specifies the number of pulses the tachometer generates during each revolution. The default is 1.
	error in describes error conditions that occur before this node runs. The default is no error. If an error occurred before this node runs, the node passes the error in value to error out. This node runs normally only if no error occurred before this node runs. If an error occurs while this node 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. 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 node ran or FALSE (checkmark) to indicate a warning or that no error occurred before this node 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 node that produced the error or warning. The default is an empty string.
	segment settings specifies the settings for dividing the input XY signal into segments. The scale type you specified in x-axis selection determines the unit of segment settings. start specifies the start value. The default is 0. In creating even-speed segments, if you set start to 0.00, this VI sets the actual start speed value as the start value for run-down test. end specifies the end value. The default is 0.00. If you set end to 0, this VI uses positive infinity as the end value for time or speed in run-up test or uses 0 as the end value for speed in run-down test. step size specifies the interval between two segments. The default is 0.00. In creating even-time segments, step size must be greater than 0. This VI uses 0.1 as the step size if you set step size to the default value. In creating even-speed segments, this VI uses 50 as the step size if you set step size to the default value.
	view info specifies the measurement information of the XY signals. dB on? specifies whether the XY signals is in decibels. The default is FALSE. unwrap phase? specifies whether the phase is unwrapped if the XY signals is a phase input. The default is TRUE. unit in degree? specifies whether the phase is in degrees or in radians when the XY signals is a phase input. The default is TRUE.
	XY signals out returns XY signals segments. X returns the x-axis value of the XY signal. Y returns the y-axis value of the XY signal.
	position info out returns the position information of XY signals out. positions [s] returns the locations of the samples, in seconds. samples/rev returns the number of samples in one revolution.
	end reached? indicates whether the output segment reaches the end time or speed value you specified in segment settings.
	error out contains error information. If error in indicates that an error occurred before this node ran, error out contains the same error information. Otherwise, it describes the error status that this node 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 node that produced the error or warning.
	actual segment settings returns the segment settings that this VI used to divide the input XY signal into segments. actual start returns the start value this VI used to divide the input XY signal into segments. actual end returns the end value this VI used to divide the input XY signal into segments. actual step size returns the actual interval between two segments.