Dmm.measurewithptp() - Keithley 3700A Series Reference Manual

Section 11: TSP command reference

dmm.measurewithptp()

This function returns the last actual measurement and time information in PTP format without using the trigger
model. You can also use a reading buffer to store additional information that is acquired while making a
measurement.
Type TSP-Link accessible
Function Yes
Usage
reading, seconds, fractional = dmm.measurewithptp()
reading, seconds, fractional = dmm.measurewithptp(bufferVar)
reading
seconds
fractional
bufferVar
Details
This is not available for "nofunction". If the command is queried when "nofunction" is
selected, nil is returned. If it is written when "nofunction" is selected, an error is returned.
When a reading buffer is used with a command or action that involves taking multiple readings, such
as dmm.measure or scanning, all readings are available in the reading buffer. However, only the last
reading and time information (seconds and fractional seconds) is returned as a reading with the
command.
The dmm.measurecount attribute determines how many measurements are performed. When you
use a buffer, it also determines if the reading buffer has enough room to store the requested
readings. The amount of room is based on readings already stored in the buffer (bufferVar.n), the
capacity of the buffer (bufferVar.capacity), and the append mode of the reading buffer
(bufferVar.appendmode). If the append mode is set to 0, any stored readings in the buffer are
cleared before new ones are stored. If append mode is set to 1, any stored readings remain in the
buffer and new ones are added to the buffer after the stored ones.
Example
DCVbuffer = dmm.makebuffer(100)
dmm.func = "dcvolts"
dmm.measurecount = 100
reading, seconds, fractional = dmm.measurewithptp(DCVbuffer)
print(reading, seconds, fractional)
Create a reading buffer.
Perform 100 DC voltage measurements.
Store the measurements in a buffer called DCVbuffer.
Print the last measurement and time information in PTP format, which will look similar to:
-1.064005867e-02
Also see
Reading buffers
dmm.makebuffer()
dmm.measure()
dmm.measurecount
11-208
Affected by
The last reading of the measurement process
Seconds in PTP format
Fractional seconds
A previously created reading buffer variable in which all readings are stored
1.779155900e+07
(on page 6-7, on page 6-1)
(on page 11-196)
(on page 11-205)
(on page 11-206)
Series 3700A System Switch/Multimeter Reference Manual
Where saved Default value
1.245658350e-01
3700AS-901-01 Rev. D/June 2018