Models 707B and 708B Switching Matrix Reference Manual
Section 7: Command reference
707B-901-01 Rev. A / August 2010
7-49
channel.setlabelrow()
This function assigns a label to a row.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function Yes
System
reset
Channel reset
Create
configuration script
Empty string or blank
Usage
channel.setlabelrow(channel, label)
channel
A string that specifies the channel that contains the row to which to apply a label
label
A string that lists the label for the channel row, up to eight characters
Details
A row label can be applied to columns of a matrix card. The label is then used on the display and can be
accessed in a channel list (see
(on page 5-5)). For
channel
, you can specify any
channel in the row. You cannot specify a channel pattern.
The row and column
label
parameters must be unique. In addition, they cannot be the same as the name of a
channel pattern.
You can only set labels for slots and channels that are installed in the instrument.
After defining a row label, you can use it to specify a channel instead of the default channel designation.
On the crosspoint display, the first four characters of the label are displayed. On the bottom display, the full label
is displayed.
Labels can only be set for matrix cards.
NOTE
Since a row label is common to all channels in that row, you only need to assign the row label to one
channel.
Example 1
channel.setlabelrow("1B01", "SMU2")
channel.setlabelcolumn("1B02", "DUT2")
channel.close("SMU2+DUT2")
print(channel.getclose("allslots"))
Sets the label for the slot 1, row 2 to "SMU2"
and slot 1, column 2 to "DUT2".
Use the labels to close a channel.
Output:
1B02
Example 2
channel.setlabelrow("1A01", "")
Clears the label for row 1 on slot 1 back to
default.
Example 3
channel.setlabelrow("1A01", " ")
Also clears the label for row 1 on slot 1 back to
default.