VectorStar™ MS4640A SeriesMicrowave Vector Network Analyzer : SCPI Commands : :CALCulate{1-16}:PARameter and :PARameter{1-16} Subsystem
 
:CALCulate{1-16}:PARameter and :PARameter{1-16} Subsystem
The :CALCulate{1-16}:PARameter subsystem commands control and report on the number of traces on the indicated channel. The :CALCulate{1-16}:PARameter{1-16} subsystem commands configure the types of parameters used and how they are displayed on each trace.
Trace Subsystems
Related trace and display subsystems are:
:CALCulate{1-16}:PARameter and :PARameter{1-16} Subsystem
:CALCulate{1-16}:PARameter{1-16}:MSTatistics Subsystem
:CALCulate{1-16}:PARameter{1-16}:SELect Subsystem
:CALCulate{1-16}:POLar Subsystem
:CALCulate{1-16}:PROCessing:ORDer Subsystem
:CALCulate{1-16}[:SELected]:CONVersion Subsystem
:CALCulate{1-16}[:SELected]:DATA Subsystem
:CALCulate{1-16}[:SELected]:FORmat Subsystem
:CALCulate{1-16}[:SELected]:MATH Subsystem
:CALCulate{1-16}[:SELected]:MDATA Subsystem
:CALCulate{1-16}[:SELected]:SMITh Subsystem
:CALCulate{1-16}[:SELected]:SMOothing Subsystem
:CALCulate{1-16}[:SELected]:TDATA Subsystem
:DISPlay Subsystem
 
:CALCulate{1-16}:PARameter:COUNt <NRf>
:CALCulate{1-16}:PARameter:COUNt?
Description
The command sets the number of traces on the specified channel. The query outputs the number of traces on the specified channel.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
<NR1> The output parameter is an integer.
Range
1 to 16
Default Value
4
Syntax Example
:CALC1:PAR:COUN 4
:CALC1:PAR:COUN?
 
:CALCulate{1-16}:PARameter:SELect?
Description
Query only. The query outputs the number of the active trace number on the indicated channel. Use :CALCulate{1-16}:PARameter{1-16}:SELect to select the active trace.
Cmd Parameters:
NA
Query Parameters
<NR1> The output parameter is an integer.
Range
1 to 16
Default Value
1
Syntax Example
:CALC2:PAR5:SEL
:CALC2:PAR:SEL?
5
 
:CALCulate{1-16}:PARameter{1-16}:DEFine <char1> | <char1>,<char2> | <char1>,<char2>,<char3>,<char4>
:CALCulate{1-16}:PARameter{1-16}:DEFine?
Description
The command sets the measurement parameter of the indicated trace. Additional command parameters (<char2>, <char3>, and <char4>) may be required depending on the selection of the first <char1> parameter. If multiple command parameters are required, each additional parameter is separated by a comma. Spaces between command parameters are ignored. The use of these parameters requires a 4-Port instrument: A3 | A4 | B3 | B4 | S13 | S23 | S33 | S31 | S32 | S14 | S24 | S34 | S41 | S42 | S43 | S44 | PORT3 | PORT4.
Available Measurement Parameters
The first parameter <char1> defines which S-Parameter, external analog input, or user-defined S-Parameter is measured. The available selections are:
S11 = No other <char> parameters are required.
S12 = No other <char> parameters are required.
S13 = No other <char> parameters are required.
S14 = No other <char> parameters are required.
S21 = No other <char> parameters are required.
S22 = No other <char> parameters are required.
S23 = No other <char> parameters are required.
S24 = No other <char> parameters are required.
S31 = No other <char> parameters are required.
S32 = No other <char> parameters are required.
S33 = No other <char> parameters are required.
S34 = No other <char> parameters are required.
S41 = No other <char> parameters are required.
S42 = No other <char> parameters are required.
S43 = No other <char> parameters are required.
S44 = No other <char> parameters are required.
EXT1 = External <char2> is also required to define the Port number.
EXT2 = <char2> is also required to define the Port number.
USR = <char2> is also required to define the numerator,<char3> is also required to define the denominator, and <char4> is also required to define the Port number.
MIXed = Response Mixed Mode, no other <char> parameters are required.
NFIG = Noise Figure trace response, no other <char> parameters are required.
NPOW = Noise Power trace response, no other <char> parameters are required.
NTEMP = Noise Temperature trace response, no other <char> parameters are required.
Command Parameter Requirements when S11, S12, S21, or S22 is Selected
If the S11, S12, S21, S22, S13, S23, S33, S31, S32, S14, S24, S34, S41, S42, S43, S44, MIXed, NFIG, NPOW, or NTEMP parameters are selected for <char1>:
No additional command parameters are required.
The use of Port 3 or Port 4 require a 4-Port instrument.
For example, :CALC1:PAR1:DEF S11 sets the input-reflection coefficient measurement.
The command syntax for S-Parameters:
:CALCulate{1-16}:PARameter{1-16}:DEFine <char1>
Command Parameters Requirements when EXT1 or EXT2 is Selected
If an external analog input of EXT1 or EXT2 is selected for <char1>:
An additional parameter of <char2> is required to define the power source port as PORT1, PORT2, PORT3, PORT4, L1, or L2.
L1 is the same as Port 1 and L2 is the same as Port 2; both use Lightning 37xxxX syntax.
The use of Port 3 or Port 4 require a 4-Port instrument.
The command syntax for external analog input:
:CALCulate{1-16}:PARameter{1-16}:DEFine <char1>,<char2>
Command Parameter Requirements when USR is Selected
If the user-defined S-Parameter of USR is selected for <char1>:
Three additional command parameters are required as <char2>, <char3>, and <char4>.
The use of Port 3 or Port 4 require a 4-Port instrument.
The second additional parameter <char2> represents the numerator. The numerator values are selected from values of A1, A2, A, A4, B1, B2, B3, B4, or 1 (one).
The third additional parameter <char3> represents the denominator and is also selected from values of A1, A2, A, A4, B1, B2, B3, B4, or 1.
The fourth additional parameter <char4> defines the power source port and is selected from PORT1, PORT2, PORT3, PORT4, L1, or L2.
For example, the command :CALC1:PAR1:DEF USR,A1,B1,PORT1 sets a user-defined S-Parameter value of A1/B1 for Port1.
The USR parameter is provided for users who want to deviate from standard S-Parameter measurements. A typical application of the USR parameter would be to remove external effects from antenna analysis where a test antenna is compared to a reference antenna by using a ratio such as B2/A2.
The command syntax for user-defined S-Parameters:
:CALCulate{1-16}:PARameter{1-16}:DEFine <char1>,<char2>, <char3>,<char4>
Query Outputs
The query outputs vary depending on the command parameters that were set in the command string.
Query Output for S-Parameters, Mixed-Mode Parameters, or Noise Figure Parameters
If the command sets S11, S12, S21, S22, S13, S23, S33, S31, S32, S14, S24, S34, S41, S42, S43, S44, MIXed, NFIG, NPOW, or NTEMP:
The query outputs only the selected parameter.
For example, with a command setting S11, the query returns the following:
:CALC1:PAR1:DEF S11
:CALC1:PAR1:DEF?
S11
Query Output for EXT1 or EXT2
If the command sets external analog inputs EXT1 or EXT2:
The output parameters are <char1> EXT1 | EXT2 and <char2> PORT1 | PORT2 | PORT3 | PORT4 | L1 | L2
The query outputs the external analog input value and the associated port.
For example, the command and query below return the following:
:CALC1:PAR1:DEF EXT1,PORT2
:CALC1:PAR1:DEF?
EXT1,PORT2
Query Output for USR
If the command sets USR for a user-defined S-Parameter, the output parameters are:
<char1> USR
<char2> A1 | A2 | B1 | B2 | 1
<char3> A1 | A2 | B1 | B2 | 1
<char4> PORT1 | PORT2
The query outputs USR, the numerator, denominator, and the associated port. Note that the numerator and denominator are separated by a forward slash (“/”).
For example, the command and query below return the following:
:CALC1:PAR1:DEF USR,A1,B1,PORT1
:CALC1:PAR1:DEF?
USR,A1/B1,PORT1
Cmd Parameters
The required command parameters depend on the first parameter selected:
<char1> S11 | S12 | S21 | S22 | S13 | S23 | S33 | S31 | S32 | S14 | S24 | S34 | S41 | S42 | S43 | S44 | MIXed | NFIG | NPOW | NTEMP | EXT1 | EXT2 | USR
<char2> A1 | A2 | A3 | A4 | B1 | B2 |B31 | B4 | 1
<char3> A1 | A2 | A3 | A4 | B1 | B2 |B31 | B4 | 1
<char4> PORT1 | PORT2 | PORT3 | PORT4 | L1 | L2
Query Parameters
The query parameters returned depend on which S-Parameter was selected for the command:
<char1> S11 | S12 | S21 | S22 | S13 | S23 | S33 | S31 | S32 | S14 | S24 | S34 | S41 | S42 | S43 | S44 | MIX | NFIG | NPOW | NTEMP | EXT1 | EXT2 | USR
<char2> A1 | A2 | A3 | A4 | B1 | B2 |B31 | B4 | 1
<char3> A1 | A2 | A3 | A4 | B1 | B2 |B31 | B4 | 1
<char4> PORT1 | PORT2 | PORT3 | PORT4 | L1 | L2
Output
<char1> | <char1>,<char2> | <char1>,<char2>/<char3>,<char4>
Range
NA
Default Value
The command and query default values depend on the which parameter was selected for <char1>:
S11 for PAR1
S12 for PAR2
S21 for PAR3
S22 for PAR4
S11 for all others
Syntax Example
:CALC1:PAR1:DEF S11
:CALC1:PAR1:DEF?
S11
 
:CALC1:PAR1:DEF NFIG
:CALC1:PAR1:DEF?
NFIG
 
:CALC1:PAR1:DEF EXT1,PORT2
:CALC1:PAR1:DEF?
EXT1,PORT2
 
:CALC1:PAR1:DEF EXT1,PORT2
:CALC1:PAR1:DEF?
EXT1,PORT2
 
:CALC1:PAR1:DEF USR A1,B1,PORT1
:CALC1:PAR1:DEF?
USR,A1/B1,PORT1
 
:CALCulate{1-16}:PARameter{1-16}:FORMat <char1>
:CALCulate{1-16}:PARameter{1-16}:FORMat?
Description
The command selects the display format of the indicated trace on the indicated channel. See Programming the VectorStar Series VNAs for more information. The available display types are:
GDELay = Group Delay
IMAGinar = Imaginary
LINPHase = Linear Mag and Phase
LOGPHase = Log Magnitude and Phase
MLINear = Linear Magnitude
MLOGarithmic = Log Magnitude
PHASe = Phase
PLINear = Linear Polar and Linear Phase
PLINCOMPlex = Linear Polar and Real/Imaginary
PLOGarithmic = Log Polar and Log Phase
PLOGCOMPlex = Log Polar and Real/Imaginary
PWRIn = Power In
PWROut = Power Out
REAL = Real
REIMaginary = Real and Imaginary
SADCOMPlex = Smith (G + jB) Admittance Real/Imaginary
SADLINear = Smith (G + jB) Admittance Linear/Phase
SADLOGarithmic = Smith (G + jB) Admittance Log/Phase
SADMittance = Smith (G + jB) Admittance
SCOMPlex = Smith (R + jX) Impedance Real/Imaginary
SLINear = Smith (R + jX) Impedance Linear/Phase
SLOGarithmic = Smith (R + jX) Impedance Log/Phase
SMITh = Smith (R + jX) Impedance
SWR = SWR
ZREAL = Impedance Real
ZCOMPlex = Impedance Real and Imaginary
ZIMAGinary = Impedance Imaginary
ZMAGNitude = Impedance Magnitude
The query outputs the display format of the indicated trace on the indicated channel. See Programming the VectorStar Series VNAs for more information and a complete listing of trace graph types, default settings, and available ranges.
Cmd Parameters
<char1> GDELay | IMAGinary | LINPHase | LOGPHase | MLINear | MLOGarithmic | PHASe | PLINear | PLINCOMPlex | PLOGarithmic | PLOGCOMPlex | PWRIn | PWROut | REAL | REIMaginary | SADCOMPlex | SADLINear | SADLOGarithmic | SADMittance | SCOMPlex | SLINear | SLOGarithmic | SMITh | SWR | ZREAL | ZCOMPlex | ZIMAGinary | ZMAGNitude
Query Parameters:
<char1> GDEL | IMAG | LINPH | LOGPH | MLIN | MLOG | PHAS | PLIN | PLINCOMP | PLOG | PLOGCOMP | PWRI | PWRO | REAL | REIM | SADCOMP | SADLIN | SADLOG | SADM | SCOMP | SLIN | SLOG | SMIT | SWR | ZREAL | ZCOMP | ZIMAG | ZMAGN
Range:
NA
Default Value:
The command/query default values depend on the value of the PARameter keyword as it varies from PAR1 to PAR16 listed below:
SMITh for PAR1 (PARameter1)
LOGPHase for PAR2
LOGPHase for PAR3
SMITh for PAR4
MLOG for PAR5, PAR6, PAR7, PAR8, PAR9, PAR10, PAR11, PAR12, PAR13, PAR14, PAR15, and PAR16.
Output:
<char1>
Syntax Example
:CALC1:PAR1:FORM SADCOMP
:CALC1:PAR1:FORM?
SADCOMP
 
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:AUTOmatic
Description
Calculate and apply the Reference Plane extension delay for the indicated trace on the indicated channel. No query.
Cmd Parameters
NA
Query Parameters
NA
Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:PAR1:REF:EXT:AUTO
 
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:DISTance <NRf>
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:DISTance?
Description
Sets the Reference Plane extension distance in meters for the indicated trace on the indicated channel. Outputs the Reference Plane extension distance in meters for the indicated trace on the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
NA
Default
NA
Syntax Example
:CALC1:PAR1:REF:EXT:DIST <NRf>
:CALC1:PAR1:REF:EXT:DIST?
 
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:LOSS <NRf>
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:LOSS?
Description
Sets the Reference Plane extension loss in dB for the indicated trace on the indicated channel. Outputs the Reference Plane extension loss in dB for the indicated trace on the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
NA
Default
NA
Syntax Example
:CALC1:PAR1:REF:EXT:LOSS <NRf>
:CALC1:PAR1:REF:EXT:LOSS?
 
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:PHAse <NRf>
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:PHAse?
Description
Sets the Reference Plane extension phase offset in degrees for the indicated trace on the indicated channel. Outputs the Reference Plane extension phase offset in degrees for the indicated trace on the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
NA
Default
NA
Syntax Example
:CALC1:PAR1:REF:EXT:PHA <NRf>
:CALC1:PAR1:REF:EXT:PHA?
 
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:TIMe <NRf>
:CALCulate{1-16}:PARameter{1-16}:REFerence:EXTension:TIMe?
Description
Sets the Reference Plane extension time in seconds for the indicated trace on the indicated channel. Outputs the Reference Plane extension time in seconds for the indicated trace on the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Range
NA
Default
NA
Syntax Example
:CALC1:PAR1:REF:EXT:TIM <NRf>
:CALC1:PAR1:REF:EXT:TIM?