System SourceMeter® Instrument Reference Manual Section 7:
2600BS-901-01 Rev. C / August 2016 7-229
smuX.measure.Y()
This function makes one or more measurements.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
reading = smuX.measure.Y()
reading = smuX.measure.Y(readingBuffer)
iReading, vReading = smuX.measure.iv()
iReading, vReading = smuX.measure.iv(iReadingBuffer)
iReading, vReading = smuX.measure.iv(iReadingBuffer, vReadingBuffer)
Returned value of the last (or only) reading of the measurement process
Source-measure unit (SMU) channel (for example, smua.measure.v() applies to
SMU channel A)
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
A reading buffer object where all readings will be stored
The last reading of the current measurement process
The last reading of the voltage measurement process
A reading buffer object where current readings will be stored
A reading buffer object where voltage readings will be stored
Details
If you use this function without specifying a reading buffer, it makes one measurement and returns
that measurement as reading. To use the additional information that is acquired while making a
measurement or to return multiple readings, specify a reading buffer. If the instrument is configured to
return multiple readings for a measurement and readingBuffer is specified, all readings are
available in readingBuffer, but only the last measurement is returned as reading.
Measurements are in the following units of measure:
• v = volts
• i = amperes
• r = ohms
• p = watts
The smuX.measure.iv() function returns the last actual current measurement and voltage
measurement as iReading and vReading, respectively. Additionally, it can store current and
voltage readings if buffers are provided (iReadingBuffer and vReadingBuffer ).
The smuX.measure.count attribute determines how many measurements are performed. When
using a reading buffer, it also determines the number of readings to store in the buffer. If a reading
buffer is not specified, the SMU ignores the smuX.measure.count attribute and only makes one
measurement.
The readingBuffer is cleared before making any measurements unless the buffer is configured to
append data.
Example
smua.measure.count = 10
smua.measure.v(smua.nvbuffer1)
Performs ten voltage measurements using SMU
channel A and stores them in a buffer.