appendmode
Off or on. If off, a new measurement to this buffer will overwrite
the previous contents. If on, the first new measurement will be
stored at what was formerly
rb[n+1]
. This attribute is
initialized to off when the buffer is created.
basetimestamp
The time stamp of when the reading at
rb[1]
was stored, in
seconds, from time of power-up.
capacity
The total number of readings that can be stored in the reading
buffer.
collectsourcevalues
When on, source values will be stored with readings in the
buffer. This requires four extra bytes of storage per reading.
This value, off or on, can only be changed when the buffer is
empty. When the buffer is created, this attribute is initialized to
off.
collecttimestamps
When on, time stamps will be stored with readings in the buffer.
This requires four extra bytes of storage per reading. This
value, off or on, can only be changed when the buffer is empty.
When the buffer is created, this attribute is initialized to off.
n
The number of readings in the reading buffer.
timestampresolution
The time stamp resolution, in seconds. When the buffer is
created, its initial resolution is 0.000001 seconds. At this
resolution, the reading buffer can store unique time stamps for
up to 71 minutes. This value can be increased for very long
tests.
12-6
Return to
2600S-901-01 Rev. C / January 2008
Section 12: Instrument Control Library
Series 2600 System SourceMeter® Instruments Reference Manual
The following values are available per reading, i.e.,
rb.measurefunctions[3]
, as enabled.
Each is actually a nested table. Related entries are stored at the same index as the relevant
measurement.
measurefunctions
An array (TSL table) of strings indicating the function measured
for the reading (Current, Voltage, Ohms or Watts).
measureranges
An array (TSL table) of full scale range values for the
measure range used when the measurement was made.
readings
An array (TSL 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, i.e.,
rb[2]
and
rb.readings[2]
are the same value.
sourcefunctions
An array (TSL table) of strings indicating the source function at
the time of the measurement (Current or Voltage).
sourceoutputstates
An array (TSL table) of strings indicating the state of the source
(Off or On).
sourceranges
An array (TSL table) of full scale range values for the source
range used when the measurement was made.
sourcevalues
If enabled (see
collectsourcevalues
above), an array (TSL
table) of the sourced value in effect at the time of the reading.
statuses
An array (TSL table) of status values for all of the readings in the
buffer. The status values are floating-point numbers that encode
the status value into a floating-point value.
timestamps
An array (TSL table) of time stamps, in seconds, of when each
reading occurred. These can be compared to the base time
stamp for the buffer for time lapsed.
For example, the number of readings the reading buffer can store is accessed as
rb.capacity
.
