Calculate:Parameter Commands


Lists, creates, selects, and deletes measurements.

For application measurements, use Calc:Custom commands.

CALCulate:PARameter:

CATalog

       | EXTended

COUNt

DEFine

       | EXTended

DELete

       | ALL

MNUMber

       | [SELect]

MODify

       | EXTended

SELect

TAG

       | NEXT?

TNUMber?

WNUMber?

Click on a keyword to view the command details.

Blue commands are superseded.

See Also

Critical Note: CALCulate commands act on the selected measurement. You can select one measurement for each channel using Calc:Par:MNUM or Calc:Par:Select. Learn more.


CALCulate<cnum>:PARameter:CATalog:EXTended? <enum>

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"


CALCulate<cnum>:PARameter:COUNt <numOfTraces>,[<measClass>]

Applicable Models: All

(Read-Write) Sets or gets the number of traces of selected channel.

 

Requirements:

  • Requires that window [n] exist. So to use the command properly you need to create window [n] before this command can succeed.

  • If window[n] exists but is already occupied by another channel’s measurement, an error is returned “Duplicate trace number”.

  • If window[n] does not exist, an error is returned: “Window number not found”.

  • If the command succeeds, it will always delete measurements. 
    calc[n]:par:count <m> will delete existing measurements in channel [n] and create <m> copies of S11 in window [n].

 

Parameters

 

<cnum>

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

<measClass>

Measurement class name.

<numOfTraces>

Number of traces on the selected channel. Varies depending on the upper limit setting for the channel/trace number.

Note: This command always deletes existing measurements and replaces them with S11.

Examples

'Create a standard S-parameter channel with one trace
disp:wind4:state on
calc4:par:count 1

'Create a Gain Compression channel with one trace
disp:wind4:state on
calc4:par:count 1,"Gain Compression"

Query Syntax

Numeric

Default

1


CALCulate<cnum>:PARameter[:DEFine]:EXTended <Mname>,<param>

Applicable Models: All

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.

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


CALCulate<cnum>:PARameter:DELete[:NAME] <Mname>

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


CALCulate:PARameter:DELete:ALL

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


CALCulate<cnum>:PARameter:MNUMber[:SELect] <n>[,fast]

Applicable Models: All

(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)


CALCulate<cnum>:PARameter:MODify <param>  Superseded

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


CALCulate<cnum>:PARameter:MODify:EXTended <param>

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

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


CALCulate<cnum>:PARameter:SELect <Mname>[,fast]

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

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

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)


CALCulate<cnum>:PARameter:TAG:NEXT?

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


CALCulate<cnum>:PARameter:TNUMber?

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


CALCulate<cnum>:PARameter:WNUMber?

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