
Model 2657A High Power System SourceMeter® Instrument Reference Manual
Section 7: TSP command reference
2657A-901-01 Rev. B/December 2012
7-177
smuX.buffer.getstats()
This function returns a specified reading buffer's statistics.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
statistics
= smu
X
.buffer.getstats(
bufferVar
)
statistics
The statistical data about the data in the reading buffer
X
Source-measure unit (SMU) channel (for example,
smua.buffer.getstats()
specifies SMU channel A)
bufferVar
The reading buffer to process
Details
This function returns a table with statistical data about the data that is placed in the buffer.
The SMU automatically updates reading buffer statistics as data is added to the reading buffer. When the
reading buffer is configured to wrap around and overwrite older data with new data, the buffer statistics include
the data that was overwritten.
The table returned from this function is a snapshot. Although the SMU continues to update the statistics, the
table returned is not updated. To get fresh statistics, call this function again.
The
statistics
parameter has the attributes described in the following table.
Attribute When
returned
Description
n
Always
The number of data points on which the statistics are based
mean
When
n
> 0
The average of all readings added to the buffer
stddev
When
n
> 1
The standard deviation of all readings (samples) added to the buffer
min
When
n
> 0
A table containing data about the minimum reading value added to the buffer
max
When
n
> 0
A table containing data about the maximum reading value added to the buffer
If
n
equals zero (0), all other attributes are
nil
. If
n
equals 1, the
stddev
attribute is
nil
because the standard
deviation of a sample size of 1 is undefined.
The
min
and
max
entries each have the attributes defined in the following table.
Attribute Description
measurefunction
String indicating the function that was measured for the reading (current, voltage,
ohms or watts)
measurerange
The full-scale range value for the measurement range used when the measurement
was made
reading
The reading value
sourcefunction
String indicating the source function at the time of the measurement (current or
voltage)
sourceoutputstate
String indicating the state of the source (off or on)
sourcerange
Full-scale range value for the source range used when the measurement was made
sourcevalue
If
bufferVar
.collectsourcevalues
is enabled, the sourced value in effect at
the time of the reading
status
Status value for the reading; the status value is a floating-point number that encodes
the status value into a floating-point value
timestamp
If
bufferVar
.collecttimestamps
is enabled, the timestamp, in seconds,
between when the reading was acquired and when the first reading in the buffer was
acquired; adding this value to the base timestamp will give the actual time the
measurement was acquired
Содержание 2657A
Страница 3: ......