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.77907 1.245658350e-01
Also see
(on page 11-205)