Owning Palette: Utility VIs

Requires: Electrical Power Toolkit

Detects crossing of limits for the measurement that you specify and returns triggers if occur.

This VI supports measuring single-line and multiple-line systems except the DBL instance. Use the DBL instance to measure one channel on one line at one time.

Details

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

Add to the block diagram Find on the palette

Trigger Detector (DBL)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
data in specifies the input data for trigger detection. You pass the input data to this VI point-by-point.
trigger definition specifies trigger configuration.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about the trigger that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected trigger.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (1D DBL Array)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
data in specifies the input data for trigger detection. Each element of data in corresponds to one measurement or one channel. You pass the input data to this VI point-by-point.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
data index specifies the index of the data for which this VI detects triggers.
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Waveform)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
waveforms specifies the input waveforms for trigger detection.
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.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
channel index specifies the channel index of the waveform for which this VI detects triggers.
waveform parameter specifies the waveform parameter for which you want to perform trigger detection.
0Peak (default)€”Detects trigger for the waveform peak value.
1Rate of rise (d/dt)€”Detects trigger for the waveform derivation.
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (XY)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
data in specifies input XY data for trigger detection.
timestamps specifies the timestamp of the input value.
values specifies the input value.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
data index specifies the index of the data for which this VI detects triggers.
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Power Values)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
power values specifies power values for trigger detection.
active power specifies the active power value in watts. Each element of active power corresponds to one channel.
reactive power specifies the reactive power value in volt-ampere reactives. Each element of reactive power corresponds to one channel.
apparent power specifies the apparent power value in volt-amperes. Each element of apparent power corresponds to one channel.
fundamental active power specifies the fundamental active power value in watts. Each element of fundamental active power corresponds to one channel.
fundamental reactive power specifies the fundamental reactive power value in volt-ampere reactives. Each element of fundamental reactive power corresponds to one channel.
cosine specifies the fundamental power factor. Each element of cosine corresponds to one channel.
power factor specifies the power factor value. Each element of power factor corresponds to one channel.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
power value selection specifies the power value for which this VI detects triggers.
0Active power (default)
1Reactive power
2Apparent power
3Fundamental active power
4Fundamental reactive power
5Cosine
6Power factor
power value index specifies the index of the selected power value for which this VI detects triggers.
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Symmetrical Components)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
symmetrical components specifies the symmetrical components data for trigger detection. All the symmetrical components have the following array order.
0Zero sequence symmetrical component
1Positive sequence symmetrical component
2Negative sequence symmetrical component
voltage specifies voltage symmetrical components.
fundamental voltage specifies fundamental voltage symmetrical components.
current specifies current symmetrical components.
fundamental current specifies fundamental current symmetrical components.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
component selection specifies the symmetrical component for which this VI detects triggers.
0Voltage (default)
1Fundamental voltage
2Current
3Fundamental current
component index specifies the index of the selected symmetrical component for which this VI detects triggers. All the symmetrical components have the following array order.
IndexComponent
0Zero sequence symmetrical component
1Positive sequence symmetrical component
2Negative sequence symmetrical component
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Power Symmetrical Components)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
power symmetrical components specifies the power symmetrical components for trigger detection. All the symmetrical components have the following array order.
0Zero sequence symmetrical component
1Positive sequence symmetrical component
2Negative sequence symmetrical component
active power specifies active power symmetrical components.
fundamental active power specifies fundamental active power symmetrical components.
fundamental reactive power specifies fundamental reactive power symmetrical components.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
component selection specifies the power symmetrical component for which this VI detects triggers.
0Active power (default)
1Fundamental active power
2Fundamental reactive power
component index specifies the index of the selected power symmetrical component for which this VI detects triggers. All the symmetrical components have the following array order.
IndexComponent
0Zero sequence symmetrical component
1Positive sequence symmetrical component
2Negative sequence symmetrical component
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Unbalance)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
unbalance specifies the unbalance data for trigger detection. The first element of each array is the negative sequence unbalance, which is represented as sequence symmetrical component/positive sequence symmetrical component. The second element of each array is zero sequence unbalance, which is represented as zero sequence symmetrical component/positive sequence symmetrical component.
voltage specifies negative sequence and zero sequence voltage unbalance in percentages.
fundamental voltage specifies negative sequence and zero sequence fundamental voltage unbalance in percentages.
current specifies negative sequence and zero sequence current unbalance in percentages.
fundamental current specifies negative sequence and zero sequence fundamental current unbalance in percentages.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
unbalance selection specifies the unbalance data for which this VI detects triggers.
0Voltage (default)
1Fundamental voltage
2Current
3Fundamental current
unbalance index specifies the index of the selected unbalance data for which this VI detects triggers. The following table lists the index and the corresponding unbalance data.
IndexUnbalance
0Negative sequence unbalance
1Zero sequence unbalance
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector (Complex Spectra)

reset? specifies whether to reset the calculation process. The default is FALSE. When you run this VI for the first time, the calculation process resets automatically.
complex spectra specifies the input complex spectra for trigger detection.
f0 specifies the start frequency of the spectrum.
df specifies the frequency resolution of the spectrum.
vectors specifies the spectrum in vectors.
triggers definition specifies trigger configurations.
trigger ID specifies a unique identifier for the trigger configuration. This VI uses trigger ID for each event detected so that you can find the origin of the event in further analysis.
spectra index specifies the index of the spectra for which this VI detects triggers.
vector index specifies the index of the vector for which this VI detects triggers.
vector part specifies the part of the vector for which this VI detects triggers.
0Real (default)
1Imaginary
2R
3Theta
low limit specifies the value of the low limit for trigger detection.
high limit specifies the value of the high limit for trigger detection.
direction specifies the direction of limit cross that causes a trigger.
0Out of limits (default)€”This VI generates a trigger only when the value leaves the limits.
1Back to limits€”This VI generates a trigger only when the value goes back into the limits.
2Both€”This VI generates a trigger each time the value cross the limits.
hysteresis type specifies the type the hysteresis and how this VI uses the hysteresis value that you specify.
0Level (default)€”Applies hysteresis on the data value. This VI generates a trigger when the value crosses a limit plus hysteresis value or crosses a limit minus hysteresis value.
1Time€”Apply hysteresis on the time value. This VI generates a trigger when the value crosses a limit and stays above/below the limit for the time equal or longer than the hysteresis value.
hysteresis specifies the hysteresis value. This VI uses hysteresis for trigger hysteresis evaluation according the hysteresis type. If hysteresis type is Level, hysteresis value has the same unit as the input data. If hysteresis type is Time, hysteresis value is in seconds.
data timestamp specifies the timestamp of the input data.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
triggers returns information about triggers that this VI detects.
trigger timestamp returns the timestamp of the trigger that this VI detects.
trigger ID returns the identifier of the detected trigger.
limit returns the limit value that is crossed during the trigger detection.
cross direction returns the direction of the limit cross that generates the trigger.
0Over limit
1Below limit
actual trigger state returns the state of the detected triggers.
error out contains error information. This output provides standard error out functionality.

Trigger Detector Details

Related Information Line and Bus Configurations