2470 High Voltage SourceMeter Instrument Reference Manual
Section 14: TSP command reference
2470-901-01 Rev. A /
May
2019
14-43
extraDigits
The number of digits to use for the second measurement; the selections are the same as
displayDigits
(only valid for buffer style
WRITABLE_FULL
); if not specified, uses the
value for
displayDigits
Details
This command is valid when the buffer style is writable or full writable.
Defines the units and the number of digits that are reported for the data. This command affects how
the data is shown in the reading buffer and what is shown on the front-panel Home, Histogram,
Reading Table, and Graph screens.
Example 1
extBuffer = buffer.make(100, buffer.STYLE_WRITABLE)
buffer.write.format(extBuffer, buffer.UNIT_WATT, buffer.DIGITS_3_5)
buffer.write.reading(extBuffer, 1)
buffer.write.reading(extBuffer, 2)
buffer.write.reading(extBuffer, 3)
buffer.write.reading(extBuffer, 4)
buffer.write.reading(extBuffer, 5)
buffer.write.reading(extBuffer, 6)
printbuffer(1, 6, extBuffer.readings, extBuffer.units)
Creates a 100-point reading buffer named
extBuffer
. Style is writable.
Set the data format to show units of watts with 3½ digit resolution.
Write 6 pieces of data into the buffer.
Print the buffer, including the readings and units.
Read the buffer.
Output:
1.000000, Watt DC, 2.000000, Watt DC, 3.000000, Watt DC,
4.000000, Watt DC, 5.000000, Watt DC, 6.000000, Watt DC
Example 2
extBuffer = buffer.make(100, buffer.STYLE_WRITABLE_FULL)
buffer.write.format(extBuffer, buffer.UNIT_WATT, buffer.DIGITS_3_5,
buffer.UNIT_WATT, buffer.DIGITS_3_5)
buffer.write.reading(extBuffer, 1, 7)
buffer.write.reading(extBuffer, 2, 8)
buffer.write.reading(extBuffer, 3, 9)
buffer.write.reading(extBuffer, 4, 10)
buffer.write.reading(extBuffer, 5, 11)
buffer.write.reading(extBuffer, 6, 12)
printbuffer(1, 6, extBuffer.readings, extBuffer.units, extBuffer.extravalues,
extBuffer.units)
Creates a 100-point reading buffer named
extBuffer
. Style is full writable.
Set the data format to show units of watts with 3½ digit resolution for the first value and for the second value in
the buffer index.
Write 12 pieces of data into the buffer.
Print the buffer, including the readings and units.
Read the buffer.
Output:
1, Watt DC, 7, Watt DC, 2, Watt DC, 8, Watt DC, 3, Watt DC, 9, Watt DC, 4, Watt DC,
10, Watt DC, 5, Watt DC, 11, Watt DC, 6, Watt DC, 12, Watt DC