Syntax

Set or return the number of traces averaged together to form the measurement result on the selected channel.

Attribute Tree Node: \Boonton55xxx\Instrument Specific\Channel\Average

Declaration: Btn55xxx.h

Implementation: Btn55xxx.dll

Parameters

Vi

The ViSession handle that you obtain from the IviDriver_init or IviDriver_InitWithOptions function. The handle identifies a particular instrument session.

RepCapIdentifier

A physical or virtual repeated capability identifier. For valid values, see the Channel repeated capability.

AttributeID

Must be BTN55XXX_ATTR_AVERAGE.

AttributeValue (GetAttribute)

Returns the current value of the attribute. The user must specify the address of a variable that has the same data type as the attribute.

AttributeValue (SetAttribute)

The value to which to set the attribute.

Remarks

Averaging can be used to reduce display noise on both the visible trace, and on marker and automatic pulse measurements. Trace averaging is a continuous process in which the measurement points from each sweep are weighted (multiplied) by a appropriate factor, and averaged into the existing trace data points. In this way, the most recent data will always have the greatest effect on the trace shape, and older measurements will be decayed at a rate determined by the averaging setting and trigger rate. Note that for timebase settings of 500 ns/div and faster, the power meter acquires samples using a technique called equivalent time or interleaved sampling. In this mode, not every pixel on the trace gets updated on each sweep, and the total number of sweeps needed to satisfy the AVERage setting will be increased by the sample interleave ratio of that particular timebase.

Instrument Command

SENSe{Channel}:AVERage {value}

SENSe{Channel}:AVERage?

Range

1 ≤ value ≤ 16384

Requirements

Supported Models

All supported

See Also

Reference

Channel

Btn55xxx

Copyright 2013-16 Boonton. All rights reserved.