Scan.addimagestep() - Keithley 3700A Series Reference Manual

Series 3700A System Switch/Multimeter Reference Manual

scan.addimagestep()

This function allows you to include multiple channels in a single scan step.
Type TSP-Link accessible
Function Yes
Usage
scan.addimagestep("channelList")
scan.addimagestep("channelList", "dmmConfig")
channelList
dmmConfig
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")
scan.addimagestep("1001, 1911", "dcvolts")
3700AS-901-01 Rev. D/June 2018
Affected by Where saved
String specifying a list of channels
String specifying a DMM configuration
Section 11: TSP command reference
Default value
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).
Adds a single step that closes channels 1001
and 1911, and then takes a DC voltage
measurement.
11-311