Keysight Pathwave 89600 VSA .NET API
AutoRange() Method
See Also 
Agilent.SA.Vsa.Interfaces Assembly > Agilent.SA.Vsa Namespace > Analog Class > AutoRange Method : AutoRange() Method


Glossary Item Box

Performs a one-shot default auto-range operation on all channels.

Syntax

Visual Basic (Declaration) 
Public Overloads MustOverride Sub AutoRange() 
C# 
public abstract void AutoRange()
C++/CLI 
public:
abstract void AutoRange(); 

Remarks

New behavior with version 14.0: Now the AutoRange method includes a Measurement.Restart so that, with an auto-range, a new measurement is always done. Previously, if the AutoRange method was called while the measurement was paused, the AutoRange function would not be performed until the next measurement was initiated.

If the measurement is in single mode when AutoRange is called then only one measurement is done and the measurement is again paused. If the measurement is in continuous mode when AutoRange is called then continuous measurements are started.

The StatusBits.Ranging bit can be checked to determine when AutoRange is finished. When using single mode then the Measurement.WaitForMeasurementDone method may also be used to determine when the AutoRange measurement has completed.

Do not make additional API calls that might affect the measurement until the AutoRange measurement is done otherwise the AutoRange measurement may be aborted.

Good programming practice for using the AutoRange method in your code is as follows:

1. Put the measurement in single sweep mode. See IsContinuous.

2. Setup measurement parameters in a change group. See NewChangeGroup.

3. Outside the change group, call AutoRange.

4. Call Measurement.WaitForMeasurementDone (or check the Ranging or MeasurementDone StatusBits) to wait for the auto range measurement to finish before making other API calls.

There is no need to call Measurement.Restart since the AutoRange method will restart the measurement.

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

See Also