Description

Adds a Measurement to the collection.

Note: This command is supported ONLY in a standard measurement channel.

Measurements can be added to ALL measurement class types using  CreateCustomMeasurementEx Method.

VB Syntax

meas.Add channel,param,source[,window]

meas

A Measurements collection (object)

channel

(long) - Channel number of the new measurement.

param

(string) - New parameter. Case insensitive.

For S-parameters:

Any S-parameter that can be measured by your PNA.

Single-digit port numbers can be separated by "_" (underscore). For example: "S21" or "S2_1"

Double-digit port numbers MUST be separated by underscore. For example: "S10_1"

For Ratioed measurements:

Any two receivers in your PNA separated by "/". For example: "A/R1"

See the block diagram showing the receivers in YOUR PNA.

For Unratioed (absolute power) measurements:

Any receiver in the PNA. For example: "A"

See the block diagram showing the receivers in YOUR PNA

With PNA Rev 6.2, Ratioed and Unratioed measurements can also use logical receiver notation to refer to receivers. This notation makes it easy to refer to receivers with an external test set connected to the PNA. You do not need to know which physical receiver is used for each test port. Learn more.

For ADC measurements

Any ADC receiver in the PNA followed by a comma, then the source port.

For example: "AI1_2" indicates the Analog Input1 with source port of 2.

Learn more about ADC receiver measurements.

For Balanced S-parameter measurements:

"topology:Sabxy"

topology -  Choose from:

1. • sbal - single-ended to balanced

   • ssb - single-ended / single-ended to balanced

   • bbal - balanced to balanced

Sabxy -

Where

a - device output (receive) mode

b - device input (source) mode

(choose from the following for both a and b:)

1. 1. • d - differential

      • c - common

      • s - single ended

x - device output (receive) logical port number

y - device input (source) logical port number

For example:"sbal:sdd42"

See an example program

For Imbalance and Common Mode Rejection measurements:

"topology:parameter" Choose from:

source

(long integer) - Source port number; if unspecified, value is set to 1. Only used for non-s-parameter measurements; ignored if s-parameter.

window

(long integer) - Optional argument. Window number of the new measurement. If unspecified, the S-Parameter will be created in the Active Window. Choose between 1and the maximum number of windows allowed on the PNA.. If unspecified, the measurement will be created in the Active Window.

See also Traces, Channels, and Windows on the PNA

Return Type

None

Default

None

Examples

meass.Add 3,"A/R1",1,1 'Adds A/R1 measurement to channel 3 in window 1

C++ Syntax

HRESULT Add(long ChannelNum, BSTR strParameter, long srcPort, VARIANT_BOOL bNewWindow)

Interface

IMeasurements

13-Jan-2012

Added std cha note

9/12/06

MQ Added logical receiver notation and number of windows.