Calculate:Parameter Commands

CALCulate:PARameter:

CATalog

       | EXTended

COUNt

DEFine

       | EXTended

DELete

       | ALL

MNUMber

       | [SELect]

MODify

       | EXTended

SELect

TAG

       | NEXT?

TNUMber?

WNUMber?

Applicable Models: All

Note: This command is replaced with CALC:PAR:CAT:EXTended? which lists parameters with "_" instead of "," allowing the list to be parsed easily. This command will continue to work.

(Read-only) Returns the names and parameters of existing measurements for the specified channel.

Note: For Balanced Measurements: CALC:PAR:CAT? may have an unexpected behavior. Learn more.

See Critical Note

Parameters

<cnum>

Channel number of the measurements to be listed. If unspecified, <cnum> is set to 1.

<enum>

Choose from:

NORMal - This is the default if no parameter is specified. If a trace title is defined in a standard channel, then the "name" returned is the same as the trace title. For non standard channels, the "name" returned is the underlying parameter name, regardless of whether the user has turned on a trace title or not.

DISPlay - If a trace title is defined, then the "name" returned is the same as the trace title.

DEFine - The "name" returned is always the same as the underlying parameter name, regardless of whether the trace title is turned on or not.

Examples

CALC:PAR:CAT? DISP
calculate2:parameter:catalog?

Return Type

String - "<measurement name>,<parameter>,[<measurement name>,<parameter>...]"

Default

"CH1_S11_1,S11"

Applicable Models: All

(Read-only) Returns the names and parameters of existing measurements for the specified channel.  This command lists receiver parameters with "_" such that R1,1 is reported as R1_1. This makes the returned string a true "comma-delimited" list all the time.

The returned string of this command is easily parsed and used to create measurements using the CALC:PAR:EXT command.

Parameters

<cnum>

Channel number of the measurements to be listed. If unspecified, <cnum> is set to 1.

<enum>

Choose from:

NORMal - This is the default if no parameter is specified. If a trace title is defined in a standard channel, then the "name" returned is the same as the trace title. For non standard channels, the "name" returned is the underlying parameter name, regardless of whether the user has turned on a trace title or not.

DISPlay - If a trace title is defined, then the "name" returned is the same as the trace title.

DEFine - The "name" returned is always the same as the underlying parameter name, regardless of whether the trace title is turned on or not.

Examples

CALC:PAR:CAT:EXT? DEF

calculate2:parameter:catalog:extended?

Return Type

String - "<measurement name>,<parameter>,[<measurement name>,<parameter>...]"

Default

"CH1_S11_1,S11"

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command is replaced with CALC:PAR:DEFine:EXTended. This command will continue to work for up to 4-port parameters.

(Write-only)  Creates a measurement but does NOT display it.

There is no limit to the number of measurements that can be created. However, there is a limit to the number of measurements that can be displayed. See Traces, Channels, and Windows on the VNA.

• Use DISP:WIND:STATe to create a window if it doesn't already exist.

• Use DISP:WIND<wnum>:TRAC<tnum>:FEED <Mname> to display the measurement.

For Application Measurements see CALC:CUST:DEF

You must select the measurement (CALC<cnum>:PAR:SEL <mname>) before making additional settings.

See Critical Note

Parameters

<cnum>

Channel number of the new measurement. If unspecified, value is set to 1.

<Mname>

Name of the measurement. Any non-empty, unique string, enclosed in quotes.

<param>

Parameter to be measured. Quotes are optional.

For S-parameters:

Any S-parameter available in the VNA

For ratioed measurements:

Any two receivers that are available in the VNA. (See the block diagram showing the receivers in YOUR VNA.)

For example: AR1 (this means A/R1)

For non-ratioed measurements:

Any receiver that is available in the VNA. (See the block diagram showing the receivers in YOUR VNA.)

For example: A

For Balanced Measurements:

First create an S-parameter measurement, then change the measurement using CALC:FSIM:BAL commands. See an example.

For Applications see CALC:CUST:DEF.

[port]

Optional argument;

For multi-port reflection S-parameter measurements:  specifies the VNA port which will provide the load for the calibration. This argument is ignored if a transmission S-parameter is specified.

For all non S-parameter measurements: specifies the source port for the measurement.

Examples

CALC4:PAR 'ch4_S33',S33,2 'Defines an S33 measurement with a load on port2 of the analyzer.

calculate2:parameter:define 'ch1_a', a, 1 'unratioed meas

calculate2:parameter:define 'ch1_a', ar1,1 'ratioed meas

Query Syntax

Not Applicable; see Calc:Par:Cat?

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command replaces CALC:PAR:DEF as it allows the creating of measurements using external multiport testsets.

(Write-only) Creates a measurement but does NOT display it.

There is no limit to the number of measurements that can be created. However, there is a limit to the number of measurements that can be displayed. See Traces, Channels, and Windows on the VNA.

• Use DISP:WIND:STATe to create a window if it doesn't already exist.

• Use DISP:WIND<wnum>:TRAC<tnum>:FEED <Mname> to display the measurement.

Note: For Application Measurements see CALC:CUST:DEF

You must select the measurement using CALC:PAR:SELect before making additional settings.

See Critical Note

Parameters

<cnum>

Channel number of the new measurement. If unspecified, value is set to 1.

<Mname>

(String) Name of the measurement. Any non-empty, unique string, enclosed in quotes.

<param>

(String ) Measurement Parameter to create. Case sensitive.

For S-parameters:

Any S-parameter available in the 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 VNA physical receivers separated by forward slash '/' followed by comma and source port.

For example: "A/R1, 3"

Learn more about ratioed measurements

See a block diagram showing the receivers in YOUR VNA.

For non-ratioed measurements:

Any VNA physical receiver followed by comma and source port.

For example: "A, 4"

Learn more about unratioed measurements.

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

First create an S-parameter measurement, then change the measurement using CALC:FSIM:BAL "define" commands. See an example.

Note: For Application Measurements see CALC:CUST:DEF

Examples

CALC4:PAR:EXT 'ch4_S33', 'S33' 'Defines an S33 measurement

calculate2:parameter:define:extended 'ch1_a', 'b9, 1' 'logical receiver notation for unratioed meas of test port 9 receiver with source port 1.

calculate2:parameter:define:extended 'ch1_a', 'b9/a10,1' 'logical receiver notation for ratioed meas of test port 9 receiver divided by the reference receiver for port 10 using source port 1

Query Syntax

Not Applicable; see Calc:Par:Cat?

Default

Not Applicable

Applicable Models: All

(Write-only) Deletes the specified measurement.

See Critical Note

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<Mname>

String - Name of the measurement

Examples

CALC:PAR:DEL 'TEST'
calculate2:parameter:delete 'test'

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Deletes all measurements on the VNA.

See Critical Note

Parameters

Examples

CALC:PAR:DEL:ALL

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets and returns the selected measurement for the channel using the Tr#. Most CALC: commands require that this, or CALC:PAR:SEL, be sent before a setting change is made to that measurement. Each channel can have one selected measurement.

Parameters

<cnum>

Channel number of the measurement to be selected. If unspecified, <cnum> is set to 1.

<n>

Numeric - Measurement number. These are the same numbers you see in the “Tr1”, “Tr2”  annotation next to the parameter name on the VNA screen.

[fast]

Optional. The VNA display is NOT updated. Therefore, do not use this argument when an operator is using the VNA display. Otherwise, sending this argument results in much faster sweep speeds. There is NO other reason to NOT send this argument.

Examples

CALC:PAR:MNUM 2

calculate2:parameter:mnumber:select 3,fast

Query Syntax

CALCulate<cnum>:PARameter:MNUMber[:SELect]?

There is NO query available to determine if the FAST argument has been set.

Return Type

Numeric

Default

1 (Trace number when factory preset is performed)

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command is replaced with CALC:PAR:MOD:EXT. This command will continue to work for up to 4 port parameters. 

(Write-only) Modifies a standard measurement using the same arguments as CALC:PAR:DEF.  To modify an FCA measurement, use CALC:CUST:MOD.

See Critical Note

Parameters

<cnum>

Channel number of the measurement. The selected measurement on that channel will be changed. If unspecified, <cnum> is set to 1.

<param>

Measurement parameter to change to. Use the same <param> arguments as CALC:PAR:DEF.

Examples

SYST:PRESET

CALC:PAR:DEF "MyMeas", S11

CALC:PAR:SEL "MyMeas"

CALC:PAR:MOD AR1 'changes the selected S11 measurement to an A/R1 measurement

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command replaces CALC:PAR:MOD as it allows modification of measurements using external multiport testsets.

(Write-only) Modifies a standard measurement using the same arguments as CALC:PAR:DEF:EXT.  

To modify an Application measurement, use CALC:CUST:MOD.

See Critical Note

Parameters

<cnum>

Channel number of the measurement. The selected measurement on that channel will be changed. If unspecified, <cnum> is set to 1.

<param>

(String) New measurement parameter. Use the same <param> arguments as CALC:PAR:DEF:EXT.

Examples

SYST:PRESET

CALC:PAR:DEF:EXT "MyMeas", "S10_1"

CALC:PAR:SEL "MyMeas"

CALC:PAR:MOD:EXT "a4b4,1" 'changes the selected S10_1 measurement to an a4/b4 measurement with source port 1

Query Syntax

Not Applicable

Default

Not Applicable

(Read-only)

Parameters

<cnum>

Channel number of the measurement. The selected measurement on that channel will be changed. If unspecified, <cnum> is set to 1.

Examples

CALC:PAR:TAG:NEXT

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-Write) Sets the selected measurement. Most CALC: commands require that this command be sent before a setting change is made. One measurement on each channel can be selected at the same time.

• Use CALC:PAR:MNUM to select a measurement by Tr# number. Learn more.

• To obtain a list of currently named measurements, use CALC:PAR:CAT?

Parameters

<cnum>

Channel number of the measurement to be selected. If unspecified, <cnum> is set to 1.

<Mname>

String - Name of the measurement. CASE-SENSITIVE. Do NOT include the parameter name that is returned with Calc:Par:Cat?

[fast]

Optional. The VNA display is NOT updated. Therefore, do not use this argument when an operator is using the VNA display. Otherwise, sending this argument results in much faster sweep speeds. There is NO other reason to NOT send this argument.

Examples

CALC:PAR:SEL 'TEST'

calculate2:parameter:select 'test',fast

Query Syntax

CALCulate:PARameter:SELect?

There is NO query available to determine if the FAST argument has been set.

Return Type

String

Default

"CH1_S11_1" (Trace name when factory preset is performed)

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-only) Returns a string that is guaranteed to be unique and valid for use with CALC:PAR:DEF.

Parameters

<cnum>

Channel number of the trace. If unspecified, <cnum> is set to 1.

Examples

CALC:PAR:TAG:NEXT?
calculate2:parameter:tag:next?

Return Type

String

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-only) Returns the trace number of the selected trace. Select a trace using Calc:Par:Select.

Parameters

<cnum>

Channel number of the trace. If unspecified, <cnum> is set to 1.

Examples

CALC:PAR:TNUM?
calculate2:parameter:tnumber?

Return Type

Numeric

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

(Read-only) Returns the window number of the selected trace. Select a trace using Calc:Par:Select.

Parameters

<cnum>

Channel number of the selected trace. If unspecified, <cnum> is set to 1.

Examples

CALC:PAR:WNUM?
calculate2:parameter:wnumber?

Return Type

Numeric

Default

Not Applicable