VectorStar™ MS4640A SeriesMicrowave Vector Network Analyzer : SCPI Commands : :CALCulate{1-16}:EXTRaction Subsystem - Network Extraction
 
:CALCulate{1-16}:EXTRaction Subsystem - Network Extraction
The :CALCulate{1-16}:EXTRaction subsystem commands provide configuration control and execution for network extraction functions during an instrument calibration.
Calibration Option Subsystems
Related calibration option configuration and control subsystems are:
• :CALCulate{1-16}:CORRection Subsystem - Adapters/Merge Calibration
• :CALCulate{1-16}:EXTRaction Subsystem - Network Extraction
• :CALCulate{1-16}:NXN Subsystem
• :SENSe{1-16}:CORRection:COLLect:FLEXible Subsystem
• :SENSe{1-16}:CORRection:COLLect:HYBRid Subsystem
General Parameters
The general command parameters are:
• [:METHod]:A refers to Extraction Method Type A which extracts one 2-port network using the adapter extraction method. Available on 2-Port and 4-Port VNA instruments.
• [:METHod]:B refers to Extraction Method Type B which extracts one 2-port network using a two-tier calibration. Available on 2-Port and 4-Port VNA instruments.
• [:METHod]:C refers to Extraction Method Type C which extracts two 2-port networks using inner and outer calibrations. Available on 2-Port and 4-Port VNA instruments.
• [:METHod]:D refers to Extraction Method Type D which extracts two Two-Port networks using outer calibrations only using the divide-by-two method. Available on 2-Port and 4-Port VNA instruments.
• [:METHod]:E refers to Extraction Method Type E which extracts four Two-Port networks using inner and outer calibrations. Only available on 4-Port VNA instruments.
• [:METHod]:F refers to Extraction Method Type F which extracts four Two-Port networks with outer calibrations only using the divide-by-two method. Only available on 4-Port VNA instruments.
• [:METHod]:G refers to Extraction Method Type G which extracts two Four-Port networks with outer calibrations only using the divide-by-two method. Only available on 4-Port VNA instruments.
 
:CALCulate{1-16}:EXTRaction
Description
The command performs the network extraction after using the network extraction setup commands below. This is the same as :CALCulate{1-16}:EXTRaction[:METHod]:C described below.
No query.
Cmd Parameters
NA
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR
 
:CALCulate{1-16}:EXTRaction:CALibration[:CALa]:FILe <string>
:CALCulate{1-16}:EXTRaction:CALibration[:CALa]:FILe?
Description
Assigns the Calibration A filename to be used in Network Extraction on the indicated channel.
Returns the Calibration A filename that is to be used in Network Extraction on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.chx’ where x:\directory\filename.chx must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.chx
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:CAL ‘C:\directory\cala.chx’
:CALC1:EXTR:CAL:CAL?
C:\directory\cala.chx
 
:CALCulate{1-16}:EXTRaction:CALibration[:CALa]:PORT <char1>
:CALCulate{1-16}:EXTRaction:CALibration[:CALa]:PORT?
Description
Assigns the Calibration A port to be used in Network Extraction on the indicated channel. The use of Port 3 or Port 4 requires a 4-Port VNA instrument.
Returns the Calibration A Port to be used in the Network Extraction on the indicated channel.
Cmd Parameters
<char1> Filename and path in the form: ’x:\directory\filename.chx’ where x:\directory\filename.chx must exist.
Query Parameters
NA
Query Output:
<char1> PORT1 | PORT2 | PORT3 | PORT4
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:CAL:PORT PORT3
:CALC1:EXTR:CAL:CAL:PORT?
PORT3
 
:CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe <string>
:CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe?
Description
This command requires a 4-Port VNA instrument. Assigns the Calibration B filename to be used in Network Extraction on the indicated channel.
Returns the Calibration B filename to be used in Network Extraction on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.chx’ where x:\directory\filename.chx must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.chx
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:CALB ‘C:\directory\filename.chx’
:CALC1:EXTR:CAL:CALB?
C:\directory\filename.chx
 
:CALCulate{1-16}:EXTRaction:CALibration:CALB:PORT <char1>
:CALCulate{1-16}:EXTRaction:CALibration:CALB:PORT?
Description
This command requires a 4-Port VNA instrument. Assigns the Calibration B port to be used in Network Extraction on the indicated channel.
Returns the Calibration B port to be used in the Network Extraction on the indicated channel.
Cmd Parameters
<char1> PORT1 | PORT2 | PORT3 | PORT4
Query Parameters
NA
Query Output:
<char1> PORT1 | PORT2 | PORT3 | PORT4
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:CALB:PORT PORT4
:CALC1:EXTR:CAL:CALB:PORT?
PORT4
 
:CALCulate{1-16}:EXTRaction:CALibration:INNer <string>
:CALCulate{1-16}:EXTRaction:CALibration:INNer?
Description
The command assigns the inner calibration filename to be used in network extraction on the indicated channel.
The query outputs the inner calibration filename to be used in network extraction on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.chx’ where x:\directory\filename.chx must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.chx
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:CAL:INN ’C:\filename.chx’
:CALC1:EXTR:CAL:CAL:INN?
c:\filename.chx
 
:CALCulate{1-16}:EXTRaction:CALibration:OUTer <string>
:CALCulate{1-16}:EXTRaction:CALibration:OUTer?
Description
The command assigns the outer calibration filename to be used in network extraction on the indicated channel.
The query outputs the outer calibration filename to be used in network extraction on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’X:\directory\filename.chx’ where x:\directory\filename.chx must exist.
Query Parameters:
<char1> Filename and path in the form: X:\directory\filename.chx
Range
NA
Default Value
NA
Syntax Example
:CALC1:EXTR:CAL:OUT ’C:\directory\filename.chx’
:CALC1:EXTR:CAL:OUT?
C:\Directory\filename.chx
 
:CALCulate{1-16}:EXTRaction:ELL1:LENGth <NRf>
:CALCulate{1-16}:EXTRaction:ELL1:LENGth?
Description
Sets the electric length 1 of the given network to be used in Network Extraction on the indicated channel.
Outputs the length 1 of the given network to be used in Network Extraction on the indicated channel.
The ELL1 value is used in the following extraction methods:
• Type A = Extract one 2-port network, with adapter extraction
• Type B = Extract one 2-port network, with two tier calibration
• Type D = Extract two 2-port networks, with outer calibration only, using divide-by-two method
• Type E = Extract four 2-port networks, with inner and outer calibrations available
• Type F = Extract four 2-port networks, with outer calibration only, using divide-by-two method
• Type G = Extract two 4-port networks, with outer calibration only, using divide-by-two method
Cmd Parameters
<NRf> The input parameter is in Meters.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Meters.
Range
NA
Default
0
Syntax Example
:CALC1:EXTR:ELL1:LENG 2.5E-10
:CALC1:EXTR:ELL1:LENG?
2.5E-10
 
:CALCulate{1-16}:EXTRaction:ELL2:LENGth <NRf>
:CALCulate{1-16}:EXTRaction:ELL2:LENGth?
Description
Sets the electric length 2 of the given network to be used in Network Extraction on the indicated channel.
Outputs the length 2 of the given network to be used in Network Extraction on the indicated channel.
The ELL2 value is used in the following extraction methods:
• Type A - Extract one 2-port network, with adapter extraction
• Type E - Extract four 2-port networks, with inner and outer calibrations available
• Type F - Extract four 2-port networks, with outer calibration only, using divide-by-two method
Cmd Parameters
<NRf> The input parameter is in Meters.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Meters.
Range
MPND
Default
0
Syntax Example
:CALC1:EXTR:ELL2:LENG 2.5E-10
:CALC1:EXTR:ELL2:LENG?
2.5E-10
 
:CALCulate{1-16}:EXTRaction:ELL3:LENGth <NRf>
:CALCulate{1-16}:EXTRaction:ELL3:LENGth?
Description
Sets the electric length 3 of the given network to be used in Network Extraction on the indicated channel.
Outputs the length 3 of the given network to be used in Network Extraction on the indicated channel description.
The ELL3 value is used in the following extraction methods:
• Type E - Extract four 2-port networks, with inner and outer calibrations available
Cmd Parameters
<NRf> The input parameter is in Meters.
Query Parameters
NA
Query Output
<NR3> The output parameter is in Meters.
Range
MPND
Default
0
Syntax Example
:CALC1:EXTR:ELL3:LENG 2.5E-10
:CALC1:EXTR:ELL3:LENG?
2.5E-10
 
:CALCulate{1-16}:EXTRaction:ELL4:LENGth <NRf>
:CALCulate{1-16}:EXTRaction:ELL4:LENGth?
Description
Sets the electric length 4 of the given Network to be used in Network Extraction on the indicated channel.
Outputs the length 4 of the given Network to be used in Network Extraction on the indicated channel description.
The ELL4 value is used in the following extraction methods:
• Type E - Extract four 2-port networks, with inner and outer calibrations available
Cmd Parameters
<NRf> The input parameter is in Meters.
Query Parameters
NA
Query Output
<NR3> The input parameter is in Meters.
Range
MPND
Default
0
Syntax Example
:CALC1:EXTR:ELL4:LENG
:CALC1:EXTR:ELL4:LENG?
 
:CALCulate{1-16}:EXTRaction:S2P1filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S2P1filename:FILe?
Description
Assigns the S2P file 1 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Description
Outputs the S2P file 1 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.s2p’ where x:\directory\ must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s2p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S2P1:FIL ’C:\directory\filename.s2p’
:CALC1:EXTR:S2P1:FIL?
C:\directory\filename.s2p
 
:CALCulate{1-16}:EXTRaction:S2P2filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S2P2filename:FILe?
Description
Assigns the S2P file 2 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Outputs the S2P file 2 name which receives the Extracted Network S2P data for the indicated port 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 VNAs, Notational Conventions for more information.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s2p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S2P2:FIL ’C:\directory\filename.s2p’
:CALC1:EXTR:S2P2:FIL?
C:\directory\filename.s2p
 
:CALCulate{1-16}:EXTRaction:S2P3filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S2P3filename:FILe?
Description
Assigns the S2P file 3 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Outputs the S2P file 3 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.s2p’ where x:\directory\ must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s2p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S2P3:FIL ’C:\directory\filename.s2p’
:CALC1:EXTR:S2P3:FIL?
C:\directory\filename.s2p
 
:CALCulate{1-16}:EXTRaction:S2P4filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S2P4filename:FILe?
Description
Assigns the S2P file 4 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Outputs the S2P file 4 name which receives the Extracted Network S2P data for the indicated port on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.s2p’ where x:\directory\ must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s2p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S2P4:FIL ’C:\directory\filename.s2p’
:CALC1:EXTR:S2P4:FIL?
C:\directory\filename.s2p
 
:CALCulate{1-16}:EXTRaction:S4P1filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S4P1filename:FILe?
Description
Assigns the S4P file 1 name which receives the Extracted Network S4P data for the indicated port on the indicated channel.
Outputs the S4P file 1 name which receives the Extracted Network S4P data for the indicated port on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.s4p’ where x:\directory\ must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s4p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S4P1:FIL ’C:\directory\filename.s4p’
:CALC1:EXTR:S4P1:FIL?
C:\directory\filename.s4p
 
:CALCulate{1-16}:EXTRaction:S4P2filename:FILe <string>
:CALCulate{1-16}:EXTRaction:S4P2filename:FILe?
Description
Assigns the S4P file 2 name which receives the Extracted Network S4P data for the indicated port on the indicated channel.
Outputs the S4P file 2 name which receives the Extracted Network S4P data for the indicated port on the indicated channel.
Cmd Parameters
<string> Filename and path in the form: ’x:\directory\filename.s4p’ where x:\directory\ must exist.
Query Parameters
NA
Query Output:
<char1> Filename and path in the form: x:\directory\filename.s4p.
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:S4P2:FIL ’C:\directory\filename.s4p’
:CALC1:EXTR:S4P2:FIL?
C:\directory\filename.s4p
 
:CALCulate{1-16}:EXTRaction:SXPPortpair:PORT <char1>
:CALCulate{1-16}:EXTRaction:SXPPortpair:PORT?
Description
Assigns the data port set to use when creating an S2P or S4P data file on the indicated channel. The use of Port 3 and/or Port 4 requires a 4-Port VNA instrument. Outputs the data port set assigned to use when creating an S2P or S4P data file on the indicated.
Cmd Parameters
<char1>: PORT12 | PORT13 | PORT14 | PORT23 | PORT24 | PORT34
Query Parameters
NA
Query Output
<char1>: PORT12 | PORT13 | PORT14 | PORT23 | PORT24 | PORT34
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:SXPP:PORT23
:CALC1:EXTR:SXPP:PORT?
PORT23
 
:CALCulate{1-16}:EXTRaction:ZERo:MATCh[:STATe] <char1>
:CALCulate{1-16}:EXTRaction:ZERo:MATCh[:STATe]?
Description
Sets the true/false state of the zero match terms flag on the indicated channel. Outputs the true/false state of the zero match terms flag on the given channel.
Cmd Parameters
<char1>: 1 | 0 | ON | OFF
Query Parameters
NA
Query Output
<char1>: 1 | 0
Range
NA
Default Value
0
Syntax Example
:CALC1:EXTR:ZER:MATC 1
:CALC1:EXTR:ZER:MATC?
 
:CALCulate{1-16}:EXTRaction[:METHod]:A
Description
Performs the Network Extraction using Method A on the given channel. Method Type A extracts one 2-port network using the adapter extraction method. Available on 2-Port and 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method A:
• :CALCulate{1-16}:EXTRaction:CALibration:CALa:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALa:PORT(?)
• :CALCulate{1-16}:EXTRaction:CALB:PORT(?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:A
 
:CALCulate{1-16}:EXTRaction[:METHod]:B
Description
Performs the Network Extraction using Method B on the given channel. Method Type B extracts one 2-port network using a two-tier calibration. Available on 2-Port and 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method B:
• :CALCulate{1-16}:EXTRaction:CALibration:CALa:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALibration:CALa:PORT(?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:B
 
:CALCulate{1-16}:EXTRaction[:METHod]:C
Description
Performs the Network Extraction using Method C on the given channel. Method Type C extracts two 2-port networks using inner and outer calibrations. Available on 2-Port and 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method C:
• :CALCulate{1-16}:EXTRaction:CALibration:CALa:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe(?)
• :CALCulate{1-16}:EXTRaction:SXPPortpair:PORT(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P2filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:C
 
:CALCulate{1-16}:EXTRaction[:METHod]:D
Description
Performs the Network Extraction using Method D on the given channel. Method Type D extracts two Two-Port networks using outer calibrations only using the divide-by-two method. Available on 2-Port and 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method D:
• :CALCulate{1-16}:EXTRaction:ZERO:MATCh[:STATe](?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:SXPPortpair:PORT(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P2filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:D
 
:CALCulate{1-16}:EXTRaction[:METHod]:E
Description
Performs the Network Extraction using Method E on the given channel. Method Type E extracts four Two-Port networks using inner and outer calibrations. Only available on 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method E:
• :CALCulate{1-16}:EXTRaction:CALibration:CALa:FILe(?)
• :CALCulate{1-16}:EXTRaction:CALibration:CALB:FILe(?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:ELL2:LENGth(?)
• :CALCulate{1-16}:EXTRaction:ELL3:LENGth(?)
• :CALCulate{1-16}:EXTRaction:ELL4:LENGth(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P2filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P3filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P4filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Outputs
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:E
 
:CALCulate{1-16}:EXTRaction[:METHod]:F
Description
Performs the Network Extraction using Method F on the given channel. Method Type F extracts four Two-Port networks with outer calibrations only using the divide-by-two method. Only available on 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method F:
• :CALCulate{1-16}:EXTRaction:ZERO:MATCh[:STATe](?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:ELL2:LENGth(?)
• :CALCulate{1-16}:EXTRaction:S2P1filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P2filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P3filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S2P4filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:F
 
:CALCulate{1-16}:EXTRaction[:METHod]:G
Description
Performs the Network Extraction using Method G on the given channel. Method Type G extracts two four-port networks with outer calibrations only using the divide-by-two method. Only available on 4-Port VNA instruments.
No query.
The following commands must be sent before performing network extraction Method G:
• :CALCulate{1-16}:EXTRaction:ZERO:MATCh[:STATe](?)
• :CALCulate{1-16}:EXTRaction:ELL1:LENGth(?)
• :CALCulate{1-16}:EXTRaction:SXPPortpair:PORT(?)
• :CALCulate{1-16}:EXTRaction:S4P1filename:FILe(?)
• :CALCulate{1-16}:EXTRaction:S4P2filename:FILe(?)
Cmd Parameters
NA
Query Parameters
NA
Query Output
NA
Query Output
NA
Range
NA
Default
NA
Syntax Example
:CALC1:EXTR:METH:G