Smux.measure.y() - Keithley 2601B Reference Manual

Series 2600B System SourceMeter® Instrument Reference Manual

smuX.measure.Y()

This function makes one or more measurements.
Type TSP-Link accessible
Function Yes
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
X
Y
readingBuffer
iReading
vReading
iReadingBuffer
vReadingBuffer
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)
2600BS-901-01 Rev. B / May 2013
Affected by
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
Section 7: TSP command reference
Where saved Default value
Performs ten voltage measurements using SMU
channel A and stores them in a buffer.
7-213