: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.
Use of Port 3 or Port 4 requires a four-port instrument.
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 <char> 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.
• AGAin = Noise Figure Available Gain trace response; no other <char> parameters are required (valid only with Option 48).
• EXT1 = External analog input; <char4> is also required to define the port number.
• EXT2 = External analog input; <char4> is also required to define the port number.
• IGAin = Noise Figure Insertion Gain trace response; no other <char> parameters are required (valid only with Option 48).
• MIXed = Response Mixed Mode; no other <char> parameters are required.
• NFIG = Noise Figure trace response; no other <char> parameters are required. (valid only with Option 41 or Option 48)
• NPOW = Noise Power trace response; no other <char> parameters are required. (valid only with Option 41 or Option 48)
• NTEMP = Noise Temperature trace response; no other <char> parameters are required. (valid only with Option 41 or Option 48)
• OPWR1 = Optical Power; <char4> is also required to define the power source port number.
• OPWR2 = Optical Power; <char4> is also required to define the power source 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.
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, NTEMP, AGAin, or IGAin parameters are selected for <char>:
• 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 <char4> 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.
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, A3, 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, A3, 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:
Returns 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,AGAin, IGAin, 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 <char4> 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 OPWR1 or OPWR2
If the command sets power source port OPWR1 or OPWR2:
• The output parameters are <char1> OPWR1 | OPWR2 and <char4> PORT1 | PORT2 | PORT3 | PORT4
• The query outputs the power source port value and the associated port.
• For example, the command and query below return the following:
:CALC1:PAR1:DEF OPWR1,PORT2
:CALC1:PAR1:DEF?
OPWR1,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
Range
NA
Default Value
The command and query default values depend on the which parameter was selected for <char1>:
• 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
• SADMLC = Smith (G + jB) Admittance L/C
• SCOMPlex = Smith (R + jX) Impedance Real/Imaginary
• SIMPLC = Smith (R + jX) Impedance L/C
• SLINear = Smith (R + jX) Impedance Linear/Phase
• SLOGarithmic = Smith (R + jX) Impedance Log/Phase
• SMITh = Smith (R + jX) Impedance
• SWR = SWR
• ZCAPacitance = Impedance Capacitance
• ZCOMPlex = Impedance Real and Imaginary
• ZIMAGinary = Impedance Imaginary
• ZINDuctance = Impedance Inductance
• ZMAGNitude = Impedance Magnitude
• ZREAL = Impedance Real
Returns the display format of the indicated trace on the indicated channel. See Programming the VectorStar Series VNA for more information and a complete listing of trace graph types, default settings, and available ranges.
Sets the X offset location of the Marker Data Display for the given trace on the indicated channel. This command requires Marker Data Display Location to be set to ‘Custom’.
Returns the X Offset location of the Marker Data Display for the given trace on the indicated channel.
The location is the top left corner of the trace display area. A value in the range of 0-100 can be set which can suitably get coerced based on the display size of the trace.
Cmd Parameters
<NR3> The input parameter is a unitless number between 0-100.
Query Parameters
NA
Query Output
<NR3> The output is a unitless number value between 0-100.
Sets the Y offset location of the Marker Data Display for the given trace on the indicated channel. This command requires Marker Data Display Location to be set to ‘Custom’.
Returns the Y Offset location of the Marker Data Display for the given trace on the indicated channel.
The location is the top left corner of the trace display area. A value in the range of 0-100 can be set which can suitably get coerced based on the display size of the trace.
Cmd Parameters
<NR3> The input parameter is a unitless value between 0-100.
Query Parameters
NA
Query Output
<NR3> The output is a unitless value between 0-100.
Range
0-100
Default Value
0
Syntax Example
:CALC1:PAR1:MLOC:Y 1.0E1
:CALC1:PAR1:MLOC:Y?
:CALCulate{1-16}:PARameter:SELect?
Description
Query only.
Returns the number of the active trace number on the indicated channel.