
Series 3700A System Switch/Multimeter Reference Manual
Section 11: TSP command reference
3700AS-901-01 Rev. D/June 2018
11-311
scan.addimagestep()
This function allows you to include multiple channels in a single scan step.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
scan.addimagestep("
channelList
")
scan.addimagestep("
channelList
", "
dmmConfig
")
channelList
String specifying a list of channels
dmmConfig
String specifying a DMM configuration
Details
This function adds a list of channels to be closed simultaneously in a single step of a scan. An
optional DMM configuration can be added to force the scan to take a measurement during the same
step.
This function is an advanced command; the
channelList
parameter must specify appropriate
relays to support the requested DMM configuration, or an invalid measurement will result.
Unlike
scan.add()
, the paired channels and backplanes necessary for measurement are not
automatically added to the step. Use the
channel.setpole()
command to indicate if the paired
channel should be added or not. Backplanes assigned to channels by the
channel.setbackplane()
command are not added to the image step automatically. For example,
if a measurement is taken on a 4-wire ohms configuration without designating 4-pole with the
channel.setpole()
command, the corresponding paired channels and backplanes will not be
added, and the specified
dmmConfig
will not cause additional relay closures as it normally would.
If you have changed the pole setting on any of the channels in the list (using
channel.setpole()
),
an additional paired channel is added or removed, as appropriate. For example, to ensure that the
proper channels close to enable a 4-wire measurement, set the pole setting in addition to using the 4-
wire ohms DMM configuration.
When a DMM configuration (other than
"nofunction"
) is specified, the instrument will take the
appropriate measurement based on the function set in the configuration; if no DMM configuration is
specified with the command, no measurement will be taken.
Example
scan.addimagestep("1001", "dcvolts")
Adds a single step that closes channel 1001
and takes a DC voltage measurement. Note
that the voltage measurement will be
inaccurate if this is the only step in the scan
(because the backplane channels are not
closed).
scan.addimagestep("1001, 1911", "dcvolts")
Adds a single step that closes channels 1001
and 1911, and then takes a DC voltage
measurement.