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 = smuX.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
To Next Page
Loading...
