System SourceMeter® Instrument Reference Manual Section 7:
2600BS-901-01 Rev. B / May 2013 7-213
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.