Write-only

Add (measurement) Method


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

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 VNA separated by "/". For example: "A/R1"

See the block diagram showing the receivers in YOUR VNA.

For Unratioed (absolute power) measurements:

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

See the block diagram showing the receivers in YOUR VNA

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 VNA. 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 VNA 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:

    • 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:)

      • 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:

Choose this:

To get this:

 

Topology

Parameter

"SBAL:IMBSB"

single-ended to balanced

imbalance

"SBAL:CMRRSB1"

single-ended to balanced

common mode rejection

(Sds21/Scs21)

"SBAL:CMRRSB2"

single-ended to balanced

common mode rejection

(Ssd12/Ssc12)

"SSB:IMB1SSB"

single-ended / single-ended to balanced

imbalance 1

"SSB:IMB2SSB"

single-ended / single-ended to balanced

imbalance 2

"SSB:CMRRSSB1"

single-ended / single-ended to balanced

common mode rejection

(Sds31/Scs31)

"SSB:CMRRSSB2"

single-ended / single-ended to balanced

common mode rejection

(Sds32/Scs32)

"BBAL:IMB1BB"

balanced to balanced

imbalance 1

"BBAL:IMB2BB"

balanced to balanced

imbalance 2

"BBAL:CMRRBB"

balanced to balanced

common mode rejection

(Sdd21/Scc21)

 

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 VNA.. If unspecified, the measurement will be created in the Active Window.

See also Traces, Channels, and Windows on the VNA

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