Write-only

About Measurement Parameters

Description

Creates a new measurement.

 VB Syntax

app.CreateMeasurement chanNum,param,lPort[,window]

Variable

(Type) - Description

app

Application (object)

chanNum

(long) - Channel number of the new measurement; can exist or be a new channel

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.

For example: "AI1" indicates the Analog Input1.

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:

lPort

(long)

• Ignored if param is an S-Parameter, balanced, imbalance, or CMRR parameter.

• Source port if param is ratioed or unratioed (including ADC) measurements.

• Use 0 for N5264A.

Note: If the port is defined by a string name, such as an external source, a balanced port, or one of the Source 2 outputs on the 2-port 2-source PNA-x model, then you must use chan.getPortNumber to translate the string into a port number. To learn more see Remotely Specifying a Source Port.

window

(long) Optional argument. Window number of the new measurement. 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

Not Applicable

Default

Not Applicable

Examples

app.CreateMeasurement(1,"A/R1",1,0)

app.CreateMeasurement(1,"a1/b1",1,0)

app.CreateMeasurement(1,"bbal:Sdd21",1)

app.CreateMeasurement(1,"AI2",2)

app.CreateMeasurement(1,"R1",0) ' for N5264A

C++ Syntax

HRESULT CreateMeasurement(long ChannelNum, BSTR strParameter, long lPort, long windowNumber)

Interface

IApplication

23-Oct-2008

Added support for N5264A

24-Apr-2008

Clarify ports with string names

23-Jul-2007

Added source port link

25-Apr-2007

Updated for ADC measurements.

12-Sept-2006

MQ Updated for logical receiver notation.