LeCroy WaveRunner Xi series Operator's Manual page 188

W R X S
AVE UNNER I
endData = InResult.Samples
LastPoint = endData - 1 ' because the last point is invisible.
ReDim newArray(InResult.Samples) ' to store the results
unscaledData = InResult.DataArray(True)
' InResult.DataArray(False) provides
' integer data from -32768 to 32767.
' InResult.DataArray(True) provides real data
' in the same unit as the vertical scale of the trace.
Total = 0
For i = 0 To LastPoint
Total = Total + (unscaledData(i)) ^ 2
Next
NewArray(0) = Sqr (Total / (LastPoint + 1)) Place the result in the zeroth element.
OutResult.ValueArray(True) = newArray ' integer data output
T
HE DEFAULT WAVEFORM FUNCTION SCRIPT
InResult.Samples is the number of points in the incoming waveform.
InResult.DataArray(Boolean) (or InResult1.DataArray or InResult2.DataArray) is the array of input data. If the
Boolean is True you get scaled real data in the units of the trace. If the Boolean is false you get unscaled integer
data in the range -32768 to + 32767.
The value of InResult.Samples is the total number of data in a trace. It is two more than the nominal value given
on the screen. The first point DataArray(0), coincides with the left edge of the screen, apart from the wobble
caused by the trigger-to-sample clock difference. If the trace length is nominally 500, the right edge of the screen
coincides with DataArray(500), which is the 501
screen, and is never seen. That is why the loop in the script runs only to endData - 1.
OutResult.Samples is the number of data in the output trace, and is set to be the same as the number of data in
the input trace. If you set
made of zeroes. If you try to set the output values to something illegal, you may find that a part of the trace reta
the values from a previous acquisition.
If you try to set something ou
or you ask for something impo
the problem. Other types of error may not be given t
omitted, because VBS does not know where it should have been.
UnscaledData is simply a copy of the input data set.
ReDim newDataArray(OutResult.Samples) defines an array of data for use as a scratch pad. Dim is short for
Dimension, which is used in Visual Basic to declare a variable (even if it only has one element, in which case you
omit the size of the array).
InResult.DataArray(False) means that the data
Boolean value applying to the property Scaled. Scaled data are specified in the units of the vertical scale, such as
volts. You get these by putting "True" instead of "False". If you want to make a section of the output trace
invisible, you simply set the data values to full scale or bigger, top or bottom.
You can start with the unscaled data (False) as input, and then set the output data to scaled data (True), and you
can go from scaled to unscaled. Using scaled data, an overflow will make a picture like this:
188
ERIES
:
EXPLANATORY NOTES
st
the output length less than the input length, you get a shorter trace, the remainder being
tside the bounds of an array, or you make some other error, or something overflows,
ssible, such as log(-13), the instrument tells you the line number, and the nature of
are signed integers in the range -32768 to 32767. False is a
point. The last point, number 502, is just off the right of the
he correct line number, for example, if "Next" or "End If" is
ins
WRXi-OM-E Rev C