Performs limit testing on waveform or cluster input data. The VI compares signal in with upper limit and lower limit and ignores any limit input that is not wired. You can wire output values to a graph to view the limits, signal, and failures. Wire data to the signal in input to determine the polymorphic instance to use or manually select the instance.


icon

Inputs/Outputs

  • cu32.png output t0 —

    output t0 determines the source of start time, t0, of the waveforms for output values.

    0t0 = limit x0 (default)—Starts with upper limit start time if you define the upper and lower limits.
    1t0 = signal in t0—Starts with signal in start time.
  • cmsdt.png signal in —

    signal in specifies the waveform to test to make sure it lies in the envelope bounded by the upper and lower limits.

  • ccclst.png upper limit —

    upper limit specifies the upper boundary of the envelope. The default is Inf.

  • cdbl.png x0 —

    x0 specifies the minimum value of the x-axis.

  • cdbl.png dx —

    dx specifies the x-axis interval between points in the input data.

  • c1ddbl.png Y —

    Y specifies the y-axis values for the limit.

  • ccclst.png lower limit —

    lower limit specifies the lower boundary of the envelope. The default is –Inf.

  • cdbl.png x0 —

    x0 specifies the minimum value of the x-axis.

  • cdbl.png dx —

    dx specifies the x-axis interval between points in the input data.

  • c1ddbl.png Y —

    Y specifies the y-axis values for the limit.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • ccclst.png limit test config —

    limit test config specifies the limit-test pass region and whether the limit values are included.

  • ci32.png pass region —

    pass region specifies whether you want the test to pass where the signal points fall inside the limits or outside the limits.

    0Inside limits—lower limit < signal in < upper limit.
    1Outside limits—signal in does not fall within the area defined by lower limit and upper limit.
  • cbool.png include UL —

    include UL specifies whether you want the test to pass where the signal points fall on upper limit. The default is TRUE.

  • cbool.png include LL —

    include LL specifies whether you want the test to pass where the signal points fall on lower limit. The default is TRUE.

  • icclst.png failures —

    failures returns the locations of failed test points.

  • i1ddbl.png x values —

    x values returns the x-value locations of failed test points.

  • i1ddbl.png y values —

    y values returns the y-value locations of failed test points.

  • ibool.png test passed? —

    test passed? indicates the result of limit mask testing. If TRUE, the signal is less than or equal to upper limit and greater than or equal to lower limit and the limit testing passed. If FALSE, the limit testing did not pass.

  • i1dbool.png test results —

    test results returns the results of the limit testing at each data point. The VI returns TRUE if the data point is less than or equal to upper limit and greater than or equal to lower limit.

  • i1dmsdt.png output values —

    output values contains the upper limit and lower limit, the signal, and the failures. You can wire this output to a graph to view the values.

    The first element in the array is the input signal. The x0 and dx values in this waveform are changed so that it can be easily plotted with the upper and lower limits. The second element in the array is the failure waveform. The failure waveform contains NaN at points where the limit test passes and contains the input signal where the limit test fails. The third and fourth elements of the array are the upper and lower boundaries, respectively.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

  • inclst.png clearance —

    clearance returns distance measures between signal in and upper limit and lower limit.

  • idbl.png clearance UL —

    clearance UL is the minimum distance between signal in and upper limit (UL). If the signal points fail at any point along upper limit, clearance UL is set to zero. When clearance UL returns Inf, upper limit was not defined, so the signal was not tested against it. You can interpret Inf as passing upper limit with maximum clearance.

  • idbl.png clearance LL —

    clearance LL is the minimum distance between signal in and lower limit (LL). If the signal points fail at any point along lower limit, clearance LL is set to zero. When clearance LL returns Inf, lower limit was not defined, so the signal was not tested against it. You can interpret Inf as passing lower limit with maximum clearance.

  • idbl.png min clearance —

    min clearance is the minimum, overall distance between signal in and the limits. min clearance is the minimum of clearance UL and clearance LL. If the signal fails the limit test at any point, min clearance is set to zero. When min clearance returns Inf, neither upper limit nor lower limit were defined, so the signal was not tested against them. You can interpret Inf as passing both upper limit and lower limit with maximum clearance.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Signal Processing\Waveform Measurements\Limit Testing Measurement.vi
    • labview\examples\Signal Processing\Waveform Measurements\Limit Testing for Unevenly Sampled Data.vi