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
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).