Tektronix Keithley SourceMeter 2470, Reference Manual

Page: 740 / 995

Section 14: TSP command reference 2470 High Voltage SourceMeter Instrument Reference Manual
14-100 2470-901-01 Rev. A /
May
2019
printbuffer()
This function prints data from tables or reading buffer subtables.
Type TSP-Link accessible Affected by Where saved Default value
Function No
Usage
printbuffer( startIndex , endIndex , bufferVar)
printbuffer( startIndex , endIndex , bufferVar , bufferVar2 )
printbuffer( startIndex , endIndex , bufferVar , ..., bufferVarN )
startIndex Beginning index of the buffer to print; this must be more than one and less than
endIndex
endIndex
Ending index of the buffer to print; this must be more than
startIndex
and less
than the index of the last entry in the tables
bufferVar
Name of first table or reading buffer subtable to print; may be a default buffer
(
defbuffer1
or
defbuffer2
) or a user-defined buffer
bufferVar2
Second table or reading buffer subtable to print; may be a default buffer
(
defbuffer1
or
defbuffer2
) or a user-defined buffer
bufferVarN The last table or reading buffer subtable to print; may be a default buffer
(
defbuffer1
or
defbuffer2
) or a user-defined buffer
... One or more tables or reading buffer subtables separated with commas
Details
If
startIndex
is set to less than 1 or if
endIndex
is more than the size of the index, 9.37
is returned for each value outside the allowed index and an event is generated.
If overlapped commands use the specified reading buffers and the commands are not complete (at
least to the specified index), this function outputs data as it becomes available.
When there are outstanding overlapped commands to acquire data,
n
refers to the index that the last
entry in the table has after all the readings have completed.
If you pass a reading buffer instead of a reading buffer subtable, the default subtable for that reading
buffer is used.
This command generates a single response message that contains all data.
The output of
printbuffer()
is affected by the data format selected by
format.data
. If you set
format.data
to
format.REAL32
or
format.REAL64
, you have fewer options for buffer elements.
With these formats, the only buffer elements available are
readings
,
relativetimestamps
, and
extravalues
. If you request a buffer element that is not permitted for the selected data format, the
instrument returns 9.91e37.
You can use the
bufferVar
attributes that are listed in the following table with the print buffer
command. For example, if
testData
is the buffer, you can use
testData.dates
attribute to print
the date of each reading in the
testData
buffer.