Series 3700 System Switch/Multimeter Reference Manual
Section 6
:
Buffer: Data Storage and Retrieval
Document Number: 3700S-901-01 Rev. A / August 2007
6-7
Similarly, the following command line returns 100 Channel values from "readingbuffer1:"
printbuffer(1, 100, readingbuffer1.channels)
The default buffer reading attribute is
readings
which can be omitted. Thus, the following
command line also returns 100 readings from "readingbuffer1:"
printbuffer(1, 100, readingbuffer1)
Buffer recall attributes
Attributes that control which elements are recalled from the buffer are listed in the following
table.
NOTE
The default attribute is
readings
and can be omitted. For example,
readingbuffer1
and
readingbuffer1.readings
will both return readings from
the buffer named "readingbuffer1."
Recall attribute
Description
channels
An array (a Lua table) of strings indicating the channel or channel
pattern associated with the measurement.
The returned value will provide different information based on what was
opened/closed when the reading was acquired:
If no channel or channel pattern is closed when the reading was
acquired, "None" is returned.
If only a single channel or backplane relay was closed, the channel
number is returned (for example, 5003 or 5915).
If a channel or backplane relay plus another backplane relay or
other channel is closed, then the channel number will be displayed
followed by a + sign (for example, 3005+ or 3915+). The channel
will be in the image unless the last close operation involved only
backplane relays. If the last close operation involved only
backplane relays, it will list the first one.
If multiple channels and/or backplane relays were closed in a
channel list, the last channel specified will be returned. However, if
only multiple backplane relays are specified, then the first one will
be specified.
If a channel pattern was closed, then the first 8 characters of the
channel pattern name are returned (for example, mypattern1 is
shown as mypatter).
dates
An array (a Lua table) of dates, indicating the date of the reading
formatted in month, day and year.
formattedreadings
An array (a Lua table) of strings indicating the formatted reading as
viewed on the display.
readings
An array (a Lua table) of the readings stored in the reading buffer. This
array holds the same data that is returned when the reading buffer is
accessed directly, in other words,
rb[2]
and
rb.readings[2]
are
the same value.