VectorStar™ MS464xB Series Microwave Vector Network Analyzer Programming Manual : SCPI Commands : :CALCulate{1-16}:FSIMulator:NETWork Subsystem – Simulation
 
:CALCulate{1-16}:FSIMulator:NETWork Subsystem – Simulation
The :CALCulate{1-16}:FSIMulator:NETWork subsystem commands use existing calibration files with a simulated network of various types to evaluate predicted performance. The commands apply to the active network.
Calibration Simulation Subsystems
These subsystems are used to create a calibrated state in the instrument which is followed by adding the required error correction coefficients for the required calibration type. If this approach is used, each error correction coefficient is entered by separate commands. Simulated calibration subsystems are:
:CALCulate{1-16}:FSIMulator:NETWork Subsystem – Simulation
:CALCulate{1-16}:FSIMulator:NETWork {1-50} Subsystem – Simulation
:SENSe{1-16}:CORRection:COEFficient:PORT Subsystem – Simulation
:SENSe{1-16}:CORRection:COEFficient Subsystem – Simulation
:CALCulate{1-16}:FSIMulator:NETWork:ADD
Description
Adds a blank network to be defined on the indicated channel.
No query.
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:FSIM:NETW:ADD
:CALCulate{1-16}:FSIMulator:NETWork:C <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:C?
Description
Sets the current LC network capacitance value on the indicated channel.
Returns the current LC network capacitance value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Farads.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Farads.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:C 3.0E-12
:CALC1:FSIM:NETW:C?
:CALCulate{1-16}:FSIMulator:NETWork:CLEar
Description
Clears all networks on the indicated channel.
No query.
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:FSIM:NETW:CLE
 
:CALCulate{1-16}:FSIMulator:NETWork:COUNt?
Description
Query only.
Returns the number of embedding/de-embedding networks on the indicated channel.
Cmd Parameters:
NA
Query Parameters
NA
Query Output
<NR1> The output parameter is an integer.
Range
NA
Default Value
0
Syntax Example
:CALC1:FSIM:NETW:COUN?
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric?
Description
Sets the current T-Line network other dielectric value on the indicated channel.
Returns the current T-Line network other dielectric value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
NA
Query Output
<NR3> The output parameter is a unitless number.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:DIEL 2.5
:CALC1:FSIM:NETW:DIEL?
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric:EVEN <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric:EVEN?
Description
Sets the current network other dielectric even value on the indicated channel.
Returns the current network dielectric even value on the indicated channel.
For the purposes of entering line information, the MS4640B VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled line pair can be driven in phase (the even mode) or 180 degrees out of phase (the odd mode) or any combination of those modes. The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
NA
Query Output
<NR3> The output parameter is a unitless number.
Range
MPND
Default
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:DIEL:EVEN 1.2E0
:CALC1:FSIM:NETW:DIEL:EVEN?
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric:ODD <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:DIELectric:ODD?
Description
Sets the current network other dielectric odd value on the indicated channel.
Returns the current network dielectric odd value on the indicated channel.
For the purposes of entering line information, the MS4640B VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled line pair can be driven in phase (the even mode) or 180 degrees out of phase (the odd mode) or any combination of those modes. The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
NA
Query Output
<NR3> The output parameter is a unitless number.
Range
MPND
Default
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:DIEL:ODD 1.2E0
:CALC1:FSIM:NETW:DIEL:ODD?
:CALCulate{1-16}:FSIMulator:NETWork:FREQuency <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:FREQuency?
Description
Sets the current T-Line network line loss frequency value on the indicated channel.
Returns the current T-Line network line loss frequency value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Hertz.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Hertz.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:FREQ 1E7
:CALC1:FSIM:NETW:FREQ?
:CALCulate{1-16}:FSIMulator:NETWork:L <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:L?
Description
Sets the current LC network inductance value on the indicated channel.
Returns the current LC network inductance value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Henrys.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Henrys.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:L 3.0E-9
:CALC1:FSIM:NETW:L?
:CALCulate{1-16}:FSIMulator:NETWork:LENGth <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:LENGth?
Description
Sets the current T-Line network line length value on the indicated channel.
Returns the current T-Line network line length value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Meters.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Meters.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:LENG 2.5E-2
:CALC1:FSIM:NETW:LENG?
:CALCulate{1-16}:FSIMulator:NETWork:LOSS <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:LOSS?
Description
Sets the current T-Line network line loss value on the indicated channel.
Returns the current T-Line network line loss value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB/mm.
Query Parameters
NA
Query Output
<NR3> The output parameter is in dB/mm.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:LOSS 3.0E0
:CALC1:FSIM:NETW:LOSS?
:CALCulate{1-16}:FSIMulator:NETWork:LOSS:EVEN <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:LOSS:EVEN?
Description
Sets the current network line loss even value on the indicated channel.
Returns the current network line loss even value on the indicated channel.
For the purposes of entering line information, the MS4640B VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled line pair can be driven in phase (the even mode) or 180 degrees out of phase (the odd mode) or any combination of those modes. The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is in dB/mm.
Query Parameters
NA
Query Output
<NR3> The output parameter is in dB/mm.
Range
MPND
Default
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:LOSS:EVEN 3.0E0
:CALC1:FSIM:NETW:LOSS:EVEN?
:CALCulate{1-16}:FSIMulator:NETWork:LOSS:ODD <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:LOSS:ODD?
Description
Set the current network line loss odd value on the indicated channel.
Returns the current network line loss odd value on the indicated channel.
For the purposes of entering line information, the MS4640B VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled-line pair can be driven:
In phase (the even mode, also called common-mode) or
180 degrees out of phase (the odd mode, also called differential-mode) or
Any combination of those modes.
The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is in dB/mm.
Query Parameters
NA
Query Output
<NR3> The output parameter is in dB/mm.
Range
MPND
Default
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:LOSS:ODD 3.0E0
:CALC1:FSIM:NETW:LOSS:ODD?
:CALCulate{1-16}:FSIMulator:NETWork:MODe <char>
:CALCulate{1-16}:FSIMulator:NETWork:MODe?
Description
Sets the current network embed/de-embed mode on the indicated channel.
Returns the current network embed/de-embed mode on the indicated channel.
Cmd Parameters
<char> EMBed | DEEMbed
Query Parameters
NA
Query Output
<char> EMB | DEEM
Range
NA
Default Value
EMB
Syntax Example
:CALC1:FSIM:NETW:MOD EMB
:CALC1:FSIM:NETW:MOD?
:CALCulate{1-16}:FSIMulator:NETWork:PORT <char>
:CALCulate{1-16}:FSIMulator:NETWork:PORT?
Description
The use of Port 3 and/or Port 4 requires a 4-port VNA instrument.
Sets the current network port number on the indicated channel.
Returns the current network port number on the indicated channel.
Cmd Parameters
<char> PORT1 | PORT2 | PORT3 | PORT4 | PORT12 | PORT13 | PORT14 | PORT23 | PORT24 | PORT34
Query Parameters
NA
Query Output
<char> PORT1 | PORT2 | PORT3 | PORT4 | PORT12 | PORT13 | PORT14 | PORT23 | PORT24 | PORT34
Range
NA
Default Value
PORT1
Syntax Example
:CALC1:FSIM:NETW:PORT PORT1
:CALC1:FSIM:NETW:PORT?
:CALCulate{1-16}:FSIMulator:NETWork:R <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:R?
Description
Sets the current R network resistance value on the indicated channel.
Returns the current R network resistance value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Ohms.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Ohms.
Range
MPND
Default Value
0.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:R 7.5E1
:CALC1:FSIM:NETW:R?
:CALCulate{1-16}:FSIMulator:NETWork:S2P <string>
:CALCulate{1-16}:FSIMulator:NETWork:S2P?
Description
Sets the current network S2P filename on the indicated channel.
Returns the current network S2P filename on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: 'x:\directory\filename.s2p', where
x:\directory must exist. See Programming the VectorStar Series VNA, Notational Conventions for more information.
Query Parameters
NA
Query Output
<char> Filename and path in the form: x:\directory\filename.s2p.
Range
NA
Default Value
NA
Syntax Example
:CALC1:FSIM:NETW:S2P 'C:\filename.s2p'
:CALC1:FSIM:NETW:S2P?
:CALCulate{1-16}:FSIMulator:NETWork:S4P <string>
:CALCulate{1-16}:FSIMulator:NETWork:S4P?
Description
Set the current network S4P Filename on the indicated channel.
Returns the current network S4P Filename on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: 'x:\directory\filename.s4p', where
x:\directory\filename.s2p must exist. See Programming the VectorStar Series VNA, Notational Conventions for more information.
Query Parameters
NA
Query Output
<string>
Range
NA
Default Value
NA
Syntax Example
:CALC1:FSIM:NETW:S4P 'C:\filename.s4p'
:CALC1:FSIM:NETW:S4P?
:CALCulate{1-16}:FSIMulator:NETWork:S4P:PORTs <char1>, <char2>, <char3>, <char4>
:CALCulate{1-16}:FSIMulator:NETWork:S4P:PORTs?
Description
This command requires a 4-port VNA instrument.
Sets the port assignments for the current S4P network to be embedded/de-embedded on the channel indicated.
Returns the port assignments for the current S4P network to be embedded/de-embedded on the channel indicated.
The port assignments are set by four <char> values where:
The <char1> value sets the Port 1 assignment.
The <char2> value sets the Port 2 assignment.
The <char3> value sets the Port 3 assignment.
The <char4> value sets the Port 4 assignment.
When considered as a set, the value of each <char> must be unique.
Cmd Parameters
<char1> PORT1 | PORT2 | PORT3 | PORT4
<char2> PORT1 | PORT2 | PORT3 | PORT4
<char3> PORT1 | PORT2 | PORT3 | PORT4
<char4> PORT1 | PORT2 | PORT3 | PORT4
Query Parameters
NA
Query Output
<char> PORT1 | PORT2 | PORT3 | PORT4
Syntax Example
:CALC1:FSIM:NETW:S4P:PORT PORT1, PORT4, PORT3, PORT2
:CALC1:FSIM:NETW:S4P:PORT?
:CALCulate{1-16}:FSIMulator:NETWork:S4P:TERM:IGNore <char1>, {<char2>, ..., <charn>}
:CALCulate{1-16}:FSIMulator:NETWork:S4P:TERM:IGNore?
Description
This command requires a 4-port VNA instrument.
Sets one or more S-Parameter terms to ignore from the current S4P network to be embedded/de-embedded on the channel indicated. At least one S-Parameter must be specified. Up to 16 S-parameters can be specified.
Returns the S-Parameter terms to ignore from the current S4P network to be embedded/de-embedded on the channel indicated.
Cmd Parameters
<char> S11 | S12 | S21 | S22 | S13 | S31 | S23 | S32 | S33 | S14 | S24 | S34 | S41 | S42 | S43 | S44
Query Parameters
NA
Query Output
<char> S11 | S12 | S21 | S22 | S13 | S31 | S23 | S32 | S33 | S14 | S24 | S34 | S41 | S42 | S43 | S44
Range
NA
Default
NA
Syntax Example
:CALC1:FSIM:NETW:S4P:TERM:IGN S11, S22, S33, S44
:CALC1:FSIM:NETW:S4P:TERM:IGN?
:CALCulate{1-16}:FSIMulator:NETWork:S4P:TRANsmission:TERM <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:S4P:TRANsmission:TERM?
Description
This command requires a 4-port VNA instrument.
Sets the current network S4P transmission terms value to 1 (one) or 0 (zero) on the indicated channel.
Returns the current network S4P transmission term set value on the indicated channel.
Cmd Parameters
<NRf> Input parameter is unitless number either 1 or 0.
Query Parameters
NA
Query Output
<NR1> Output parameter is a unitless number.
Range
0 or 1
Default Value
0
Syntax Example
:CALC1:FSIM:NETW:S4P:TRAN:TERM
:CALC1:FSIM:NETW:S4P:TRAN:TERM?
:CALCulate{1-16}:FSIMulator:NETWork:SWAPs2p <char>
:CALCulate{1-16}:FSIMulator:NETWork:SWAPs2p?
Description
Sets the current network swap S2P file data flag on the indicated channel.
Returns the current network swap S2P file data flag on the indicated channel.
Cmd Parameters
<char> TRUE | FALSe | 1 | 0
Query Parameters
NA
Query Output
<char> 1 | 0
Range
NA
Default Value
FALS
Syntax Example
:CALC1:FSIM:NETW:SWAP TRUE
:CALC1:FSIM:NETW:SWAP?
:CALCulate{1-16}:FSIMulator:NETWork:TYPe <char>
:CALCulate{1-16}:FSIMulator:NETWork:TYPe?
Description
Sets the current network type on the indicated channel.
Returns the current network type on the indicated channel.
The available network choices depend on whether the instrument is in 2-port or 4-port VNA mode. All 2-port networks are available for 4-port VNAs.
The following network types are available:
Types Available for 2-Port VNA Instruments
If the instrument is in two-port mode, the following types are available:
LS = 2-port or 4-port VNAs. Series inductance
LP = 2-port or 4-port VNAs. Parallel inductance
CS = 2-port or 4-port VNAs. Series capacitance
CP = 2-port or 4-port VNAs. Parallel capacitance
RS = 2-port or 4-port VNAs. Resistive series network.
RP = 2-port or 4-port VNAs. Resistive parallel network.
TLine = 2-port or 4-port VNAs. A defined transmission line with specifications for Impedance (Ohms), Length (Meters), Loss (dB/mm), @ Frequency (GHz), and Dielectric Value. Note that programmatically, length is entered in Meters. From the user interface, length is usually entered in millimeters.
S2Pfile = 2-port or 4-port VNAs. Allows an S2P calibration file to be used.
Types Available for 4-Port VNA Instruments
If the instrument is in four-port mode, all of the network types above are available with the addition of the following network types:
S4Pfile = 4-port VNAs only. Allows an S4P calibration file to be used.
LCKTFour = 4-port VNAs only. A four-node inductance L circuit. Port assignments are defined in separate commands.
CCKTFour = 4-port VNAs only. A four-node capacitance C circuit. Port assignments are defined in separate commands.
TLINEFour = 4-port VNAs only. Allows two separate through (“thru”) lines to be used. In separate commands, each line is defined by Length (Meters), @ Frequency (GHz), Z0-Odd (Ohms), Loss-Odd (dB/mm), Dielectric Odd (unitless number), Z0Even (Ohms), Loss-Even (dB/mm), and Dielectric Even (unitless number). Note that programmatically, length is entered in Meters. From the user interface, length is usually entered in millimeters.
RCKTFour = 4-port VNAs only. A four-node resistive R circuit. Port assignments are defined in separate commands.
Cmd Parameters
<char> LS | LP | CS | CP | RS | RP | TLine | S2Pfile | S4Pfile | LCKTFour | CCKTFour | TLINEFour | RCKTFour
Query Parameters
NA
Query Output
<char> LS | LP | CS | CP | RS | RP | TL | S2P | S4P | LCKTF | CCKTF | TLINEF | RCKTF
Range
NA
Default Value
S4Pfile
Syntax Example
:CALC1:FSIM:NETW:TYP S4PFILE
:CALC1:FSIM:NETW:TYP?
:CALCulate{1-16}:FSIMulator:NETWork:Z0 <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:Z0?
Description
Sets the current T-Line network impedance Z0 (Z zero) value on the indicated channel.
Returns the current T-Line network impedance value on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in Ohms.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Ohms.
Range
MPND
Default Value
50.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:Z0 7.5E1
:CALC1:FSIM:NETW:Z0?
:CALCulate{1-16}:FSIMulator:NETWork:Z0:EVEN <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:Z0:EVEN?
Description
Sets the current network impedance Z0 (Z zero) even value on the indicated channel.
Returns the current network impedance even value on the indicated channel.
For the purposes of entering line information, the MS463xA/MS464xA Series VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled line pair can be driven in phase (the even mode) or 180 degrees out of phase (the odd mode) or any combination of those modes. The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is in Ohms.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Ohms.
Range
MPND
Default
50.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:Z0:EVEN 7.5E1
:CALC1:FSIM:NETW:Z0:EVEN?
:CALCulate{1-16}:FSIMulator:NETWork:Z0:ODD <NRf>
:CALCulate{1-16}:FSIMulator:NETWork:Z0:ODD?
Description
Sets the current network impedance odd value on the indicated channel.
Returns the current network impedance odd value on the indicated channel.
For the purposes of entering line information, the MS463xA/MS464xA Series VNAs use an even/odd mode formalism as is consistent with many circuit simulators. The central concept is that a coupled line pair can be driven in phase (the even mode) or 180 degrees out of phase (the odd mode) or any combination of those modes. The term “common-mode” is also used for even mode. The term “differential-mode” is also used for odd mode. In the case of very weak coupling where Cx is close to 0, these modes see the same impedances, same losses, and same phase velocities so there is no need to use this mode separation. As the coupling increases, at the very least, the impedances seen by these two modes diverge requiring two impedance entries where the effective capacitances seen by the conductors in the two modes are clearly different. That is the end of changes for symmetric TEM systems, where this approach will work for common coax, stripline, and some microstrip cases.
Cmd Parameters
<NRf> The input parameter is in Ohms.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Ohms.
Range
MPND
Default
50.00000000000E+000
Syntax Example
:CALC1:FSIM:NETW:Z0:ODD 7.5E1
:CALC1:FSIM:NETW:Z0:ODD?
:CALCulate{1-16}:FSIMulator:NETWork[:STATe] <char>
:CALCulate{1-16}:FSIMulator:NETWork[:STATe]?
Description
Sets the network embedding/de-embedding function on/off state on the indicated channel.
Returns the network embedding/de-embedding function on/off state on the indicated channel.
Cmd Parameters
<char> 1 | 0 | ON | OFF
Query Parameters
<char> 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:FSIM:NETW ON
:CALC1:FSIM:NETW?