User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-152 3700S-901-01 Rev. C / July 2008
dmm.measurewithtime()
Function
Handles taking measurements on the DMM without using the trigger model and
returns the reading along with time information.
Usage
There are two ways to use this function:
To return the last reading of the measurement process taken and accounted for by
dmm.measurecount:
reading, seconds, fractional = dmm.measurewithtime()
reading: Contains the last reading of the measurement process
seconds: Contains seconds
fractional: Contains fractional seconds
To return the last reading of the measurement process while storing all readings
accounted for by dmm.measurecount:
reading, seconds, fractional =
dmm.measurewithtime(rbuffer)
reading: Contains the last reading of the measurement process
seconds: Contains seconds
fractional: Contains fractional seconds
Remarks
This function returns only the last actual measurement and time information as
reading, seconds, and fractional seconds. To use the additional information acquired
while making a measurement, a reading buffer must be used. If the instrument is
configured to return multiple readings when a measurement is requested, all readings
will be available in rbuffer if one is provided, but only the last measurement and time
information will be returned.
The dmm.measurecount (on page 13-151) attribute determines how many
measurements are performed. When using a buffer, it also determines the number of
readings to store in the buffer.
Also see
dmm.makebuffer() (on page 7-8)
dmm.measure() (on page 13-150)
dmm.measurecount (on page 13-151)
Example
To perform 100 DC voltage measurements and store then in a buffer called mybuff,
and print the last measurement and time information:
mybuff = dmm.makebuffer(100)
dmm.func = "dcvolts"
dmm.measurecount = 100
reading, seconds, fractional = dmm.measurewithtime(mybuff)
print(reading, seconds, fractional) ®
-1.064005867e-002 1.779155900e+007 1.245658350e-001