Section 7: Command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual
7-206 2651A-901-01 Rev. A / March 2011
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)
reading
Returned value of the last (or only) reading of the measurement process
X
Source-measure unit (SMU) channel (for example, smua.measure.v() applies to
SMU channel A)
Y
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
readingBuffer
A reading buffer object where all readings will be stored
iReading
The last reading of the current measurement process
vReading
The last reading of the voltage measurement process.
iReadingBuffer
A reading buffer object where current readings will be stored.
vReadingBuffer
A reading buffer object where voltage readings will be stored.
Details
This function (without specifying a reading buffer) will only make one measurement and return that measurement
as reading. To use the additional information 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 will be available in readingBuffer, but only the last
measurement will be 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 will ignore the smuX.measure.count attribute and only make one measurement.
The readingBuffer will be cleared before taking 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.
Also see
smuX.measure.count (on page 7-194)
smuX.measure.overlappedY()
(on page 7-201)
smuX.nvbufferY
(on page 7-208)
Reading buffer overview
(see "Reading buffers" on page 3-6)