Keithley 2601 Reference Manual page 304

Section 12: Instrument Control Library
Usage
There are multiple ways to use this function, the use depends on the number of tables
or reading buffer subtables that are specified:
printbuffer(start_index, end_index, st_1)
printbuffer(start_index, end_index, st_1, st_2)
printbuffer(start_index, end_index, st_1, st_2, ..., st_n)
start_index
end_index
st_1, st_2, ... st_n
Remarks • Correct usage when there are no outstanding overlapped commands to acquire data:
• 1 <= start_index <= end_index <= n
Where
•
If
• end_index < start_index or n < start_index, no data will be printed. If
start_index < 1, 1 will be used as the first index. If n < end_index, n will be used
as the last index.
• When any of the given reading buffers are being used in overlapped commands that
have not yet completed at least to the desired index, this function will return 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 will have after all the measurements have completed.
• If you do not specify a specific subtable in a reading buffer, then the default subtable
named readings is automatically used.
• At least one table or subtable must be specified.
• This command generates a single response message that contains all data. The
response message is stored in the output queue.
• The format.data attribute controls the format of the response message.
Also see format.data,
Example This example prints
another buffer
format.data = format.ASCII
printbuffer(1, rb1.n, rb1.timestamps, rb1, rb2)
Example of returned data (timestamps, rb1.readings, rb2.readings):
1.02345E-04, 8.76542E-04, 5.29372E-01, 1.02445E-04, 8.66543E-04,
5.24242E-01, 1.02545E-04, 8.56547E-04, 5.19756E-01, 1.02645E-04,
8.44546E-04, 5.14346E-01
printnumber
Function Prints numbers using the format selected for printing reading buffers.
Usage
There are multiple ways to use this function, depending on how many numbers are to
be printed:
printnumber(v1)
printnumber(v1 ,v2)
printnumber(v1 ,v2, ..., vn)
v1, v2, ..., vn
Remarks • This function will print the given numbers using the data format specified by
format.data and other associated attributes.
• At least one number must be given. There is an upper limit that is dictated by the output
format and the maximum output message length. All values will be written in a single
message. Care must be taken not to exceed the maximum output message length.
Also see printbuffer,
Example
Prints three measurements that were previously performed:
format.data = format.ASCII
printnumber(i, v, t)
Example of returned data (i, v, t):
1.02345E-04, 8.76542E-02, 5.29372E-01
12-44
refers to the index of the last entry in the tables to be printed.
n
printnumber
all time stamps and readings in one buffer and all readings from
, where n is 4:
format.data
Return to
Series 2600 System SourceMeter® Instruments Reference Manual
Starting index of values to print.
Ending index of values to print.
Tables or reading buffer subtables from which
to print values.
Numbers to print.
Section Topics 2600S-901-01 Rev. C / January 2008