2600S-901-01 Rev. C / January 2008 Return to Section Topics 12-65
Series 2600 System SourceMeter® Instruments Reference Manual Section 12: Instrument Control Library
smuX.measure.Y
smuX.measure.iv
X = SMU channel (a or b)
Y = SMU measure function (v, i, r or p) 
where: v = voltage, i = current, r = resistance, p = power
Function Performs one or more measurements.
Usage There are three ways to use this function:
reading = smuX.measure.Y()
reading = smuX.measure.Y(rbuffer)
reading = smuX.measure.iv(ibuffer, vbuffer)
reading   Returns the last reading of the measurement  
 
process.
rbuffer  A reading buffer object where all the reading(s)  
  will be stored.
ibuffer  A reading buffer object where current reading(s)  
  will be stored.
vbuffer  A reading buffer object where voltage reading(s)  
 
will be stored.
Remarks • This function returns only the last actual measurement as reading. 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 will be returned as reading
.
• The smuX.measure.iv function stores both current and voltage readings in respective 
buffers (current and then voltage are stored in separate buffers).
• The smuX.measure.count attribute determines how many measurements are 
performed. When using a buffer, it also determines the number of readings to 
store in the buffer. 
Details See “Reading buffers” in Section 7.
Also see smuX.nvbufferY, smuX.nvbufferY
Example Performs ten voltage measurements using SMU A and stores them in a buffer:
smua.measure.count = 10
smua.measure.v(smua.nvbuffer1) 
smuX.measureYandstep
smuX.measureivandstep
X = SMU channel (a or b)
Y = SMU measure function (v, i, iv, r or p)where: 
v = voltage, i = current, r = resistance, p = power
Function Performs one or two measurements and then steps the source.
Usage This function can be used in two ways:
reading = smuX.measureYandstep(sourcevalue)
readings = smuX.measureivandstep(sourcevalue)
reading  Returns the measured reading before stepping  
the source.
readings  Returns the two measured readings before  
stepping the source.
sourcevalue  Source value to be set after the measurement is  
made.
Remarks • The smuX.measureYandstep function performs a measurement and then sets the 
source to sourcevalue. The smuX.measureivandstep function is similar, but 
performs two measurements; one for current (i) and one for voltage (v).
• The specified source value should be appropriate for the selected source function. For 
example, if the source voltage function is selected, then sourcevalue is expected to be 
a new voltage level.
• Both source and measure auto range must be disabled before using this function.
• This function is provided for very fast execution of source-measure loops. The 
measurement will be made prior to stepping the source. Prior to using this function, and 
before any loop this function may be used in, the source value should be set to its initial 
level.
Also see  smuX.measure.Y