Keithley 2601 Reference Manual page 276

Section 12: Instrument Control Library
Usage
results = dataqueue.add (value, [timeout] )
value
timeout
results
Remarks • You can only use the timeout value while adding data from a local data queue.
• The timeout value is ignored if the data queue is not full.
• The dataqueue.add function returns false if time-out expires before room is available
in the data queue or if the data queue is full and a timeout value is not specified.
• If the value is a table, a duplicate of the table and any subtables is made. The duplicate
table does not contain any references to the original table or to any subtables.
Example
• dataqueue.add (10)
• dataqueue.add(10, 2)
• data_added = dataqueue.add (10, 3)
Use the following code to verify data was added to the data queue.
dataqueue.CAPACITY
Attribute The maximum number of entries that you can store in the data queue.
Usage
capacity = dataqueue.CAPACITY
capacity
Remarks A read only attribute.
Example
print(dataqueue.CAPACITY)
dataqueue.clear
Function Clears the data queue.
Usage
dataqueue.clear()
Remarks • The dataqueue.clear command forces all dataqueue.add commands in progress to
time-out.
• The function deletes all data from the data queue.
dataqueue.count
Attribute Stores the number of entries saved in the data queue.
Usage
count = dataqueue.count
count
Remarks This is a read-only attribute.
dataqueue.next
12-16
The data item to add.
The maximum number of seconds to wait for room in the data queue.
Assigns the value true or false based on the success of the add function.
Replace the word results with the name of the variable that you want to store
as the result indicator.
if not data_added then
print ("timeout error")
end
A custom variable that stores the maximum number of entries in
the data queue.
A custom variable that stores the number of entries in the data queue.
Return to
Series 2600 System SourceMeter® Instruments Reference Manual
Section Topics 2600S-901-01 Rev. C / January 2008