Keithley 3700 Series User Manual

Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual
11-208 3700AS-901-01 Rev. D/June 2018
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
Affected by
Where saved
Default value
Function
Yes
Usage
reading, seconds, fractional = dmm.measurewithptp()
reading, seconds, fractional = dmm.measurewithptp(bufferVar)
reading
The last reading of the measurement process
seconds
Seconds in PTP format
fractional
Fractional seconds
bufferVar
A previously created reading buffer variable in which all readings are stored
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 1.779155900e+07 1.245658350e-01
Also see
Reading buffers (on page 6-7, on page 6-1)
dmm.makebuffer() (on page 11-196)
dmm.measure() (on page 11-205)
dmm.measurecount (on page 11-206)

Keithley 3700 Series Specifications

General

Brand	Keithley
Model	3700 Series
Category	Multimeter
Language	English