Calculate:Parameter Commands

Lists, creates, selects, and deletes measurements.

For application measurements, use Calc:Custom commands.

CALCulate:PARameter:

MNUMber

TAG

Click on a keyword to view the command details.

Blue commands are superseded.

See Also

Example Programs
Learn about Measurement Parameters
Synchronizing the Analyzer and Controller
SCPI Command Tree

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

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

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