Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference
2601B-PULSE-901-01A April 2020 11-23
bufferVar.collectsourcevalues
This attribute sets whether or not source values are stored with the readings in the buffer.
Usage
state = bufferVar.collectsourcevalues
bufferVar.collectsourcevalues = state
Source value collection status; set to one of the following:
â–ª 0: Source value collection disabled (off)
â–ª 1: Source value collection enabled (on)
The reading buffer; can be a dynamically allocated buffer (user-defined), or a
dedicated reading buffer (such as smua.nvbuffer1)
Details
Assigning a value to this attribute enables or disables the storage of source values. Reading this
attribute returns the state of source value collection. This value can only be changed with an empty
buffer. Empty the buffer using the bufferVar.clear() function.
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the
reading buffer is saved to nonvolatile memory.
When on, source values are stored with readings in the buffer. This requires four extra bytes of
storage for each reading. Turning on additional collection items, such as source values (this attribute)
and timestamps, decreases the capacity of a dedicated reading buffer, but does not change the
capacity of a user-defined dynamically allocated buffer.
You cannot collect source values when smua.trigger.measure.action is set to smua.ASYNC,
so bufferVar.collectsourcevalues must be set to 0 when the measurement action is set to be
asynchronous.
Example
smua.nvbuffer1.collectsourcevalues = 1
Include source values with readings for
dedicated reading buffer 1.
Also see
bufferVar.clear() (on page 11-21)
Reading buffers (on page 5-1)
smua.measure.overlappedY() (on page 11-205)
smua.measure.Y() (on page 11-209)
smua.nvbufferY (on page 11-211)
smua.trigger.measure.action (on page 11-248)
smua.trigger.measure.Y() (on page 11-251)