VNA Master™Programming Manual : VNA Commands : [:SENSe]:CORRection:COLLect Subsystem
 
[:SENSe]:CORRection:COLLect Subsystem
This subsystem controls the system calibration. To properly perform a calibration, several parameters must be set. The table below lists all of the required commands. First, use the :MEDium and :CONNector subcommands to specify the calibration line type and the DUT port setup. Then use the :METHod and :TYPE subcommands to specify the calibration method and the calibration type. Then use the :ACQUire subcommand to specify the calibration components to be measured. Finally, use the :SAVe subcommand to calculate, save, and finish the calibration. Note that the calibration components do not need to be measured in any specific order.
Calibration Abort
[:SENSe]:CORRection:COLLect:ABORt:ALL
Description
Aborts the calibration measurement and restarts the current sweep or measurement, or both.
Syntax
[:SENSe]:CORRection:COLLect:ABORt:ALL
Cmd Parameter
NA
Query Response
NA (no query)
Front Panel Access
NA
 
Calibration Steps
[:SENSe]:CORRection:COLLect[:ACQUire]
Description
Performs a measurement of the given steps. <cal steps> is the calibration step to be performed and must be one of the following values:
OPEN|SHORT|SHORT1|SHORT2|SHORT3|LOAD|
THRU|ISOLation
<port_no> is the port number, 1, 2, or 3. For calibration step OPEN, SHORT, SHORT1, SHORT2, SHORT3, and LOAD, valid port number is 1 or 2. For calibration step THRU and ISOLation, valid port number is 1 for Fwd, 2 for Rev, and 3 for Fwd and Rev.
Note that the calibration step must be valid for the given calibration type and calibration method. Refer to Table: SOLT Calibration Method, Table: SSLT Calibration Method, and Table: SSST Calibration Method for a list of valid calibration steps for each type and method.
The query version of this command returns a string that consists of the last calibration step measurement that was performed followed by the port number. The calibration step and port number are delimited by a comma. Note that if no calibration step has been processed, then this command returns the string “NONE, 0”.
Syntax
[:SENSe]:CORRection:COLLect[:ACQUire] <cal steps>,<port_no>
[:SENSe]:CORRection:COLLect[:ACQUire]?
Cmd Parameter
<char> <cal steps>,<port_no>
Query Parameter
<char> <cal steps>,<port_no>
Query Response
<string>
Front Panel Access
Shift‑2 (Calibrate), Start Cal
 
Calibration Steps and Calibration Types:
For each calibration Type, the following tables (Table: SOLT Calibration Method, Table: SSLT Calibration Method, and Table: SSST Calibration Method) list the allowable calibration steps and port_no to be used in command [:SENSe]:CORRection:COLLect[:ACQUire] <cal steps>,<port_no>. The calibration steps are different for each calibration Method, and the port_no is different for each calibration Type. For example, for calibration Type RFP1 and calibration Method SOLT, the allowable <cal steps>,<port_no> settings are “OPEN,1”, “SHORT,1”, and “LOAD,1”. The steps that are not allowed are indicated by “—”.
SOLT Calibration Method
Calibration Type
OPEN
SHORT
LOAD
THRU
ISOL
RF2P (Full 2 Port – S11, S21, S12, S22)
1 , 2
1 , 2
1 , 2
3
3
RFP1 (Full S11 - Port 1)
1
1
1
RFP2 (Full S22 - Port 2)
2
2
2
RFBP (Full S11 & S22 - Both Ports)
1 , 2
1 , 2
1 , 2
TRFP (Response S21 - Trans Response Fwd Path)
1
1
TRRP (Response S12 - Trans Response Rev Path)
2
2
TRBP (Response S21 & S12 - Trans Resp Both Paths)
3
3
RRP1 (Response S11 - Reflection Response Port 1)
1
1
1
RRP2 (Response S22 - Reflection Response Port 2)
2
2
2
RRBP (Response S11 & S22 - Reflection Response Both Ports)
1 , 2
1 , 2
1 , 2
2PFP (1P2P S11, S21 - 1 Path 2 Port Fwd Path)
1
1
1
1
1
2PRP (1P2P S22, S12 - 1 Path 2 Port Rev Path)
2
2
2
2
2
 
Calibration Steps and Calibration Types (continued):
SSLT Calibration Method
Calibration Type
SHORT1
SHORT2
LOAD
THRU
ISOL
RF2P (Full 2 Port – S11, S21, S12, S22)
1 , 2
1 , 2
1 , 2
3
3
RFP1 (Full S11 - Port 1)
1
1
1
RFP2 (Full S22 - Port 2)
2
2
2
RFBP (Full S11 & S22 - Both Ports)
1 , 2
1 , 2
1 , 2
TRFP (Response S21 - Trans Response Fwd Path)
1
1
TRRP (Response S12 - Trans Response Rev Path)
2
2
TRBP (Response S21 & S12 - Trans Resp Both Paths)
3
3
RRP1 (Response S11 - Reflection Response Port 1)
1
1
RRP2 (Response S22 - Reflection Response Port 2)
2
2
RRBP (Response S11 & S22 - Reflection Response Both Ports)
1 , 2
1 , 2
2PFP (1P2P S11, S21 - 1 Path 2 Port Fwd Path)
1
1
1
1
1
2PRP (1P2P S22, S12 - 1 Path 2 Port Rev Path)
2
2
2
2
2
 
Calibration Steps and Calibration Types (continued):
SSST Calibration Method
Calibration Type
SHORT1
SHORT2
SHORT3
THRU
ISOL
RF2P (Full 2 Port – S11, S21, S12, S22)
1 , 2
1 , 2
1 , 2
3
3
RFP1 (Full S11 - Port 1)
1
1
1
RFP2 (Full S22 - Port 2)
2
2
2
RFBP (Full S11 & S22 - Both Ports)
1 , 2
1 , 2
1 , 2
TRFP (Response S21 - Trans Response Fwd Path)
1
1
TRRP (Response S12 - Trans Response Rev Path)
2
2
TRBP (Response S21 & S12 - Trans Resp Both Paths)
3
3
RRP1 (Response S11 - Reflection Response Port 1)
1
RRP2 (Response S22 - Reflection Response Port 2)
2
RRBP (Response S11 & S22 - Reflection Response Both Ports)
1 , 2
2PFP (1P2P S11, S21 - 1 Path 2 Port Fwd Path)
1
1
1
1
1
2PRP (1P2P S22, S12 - 1 Path 2 Port Rev Path)
2
2
2
2
2
 
Calibration Step Status
[:SENSe]:CORRection:COLLect:ACQUire:STATus?
Description
This command requests information about the current calibration step or the specified calibration step. If no calibration step is specified, then it returns a 1 if the current calibration step has completed, otherwise it returns a 0. <cal steps> is the calibration step to be performed and must be one of the following values:
OPEN|SHORT|SHORT1|SHORT2|SHORT3|LOAD|THRU|ISOLation
<port_no> is the port number, 1, 2, or 3. For   step OPEN, SHORT, SHORT1, SHORT2, SHORT3, and LOAD, valid port number is 1 or 2. For calibration step THRU and ISOLation, valid port number is 1 for Fwd, 2 for Rev, and 3 for Fwd and Rev.
Syntax
[:SENSe]:CORRection:COLLect:ACQUire:STATus? [<cal steps>,<port_no>]
Cmd Parameter
NA (query only)
Query Parameter
<char> [<cal steps>,<port_no>]
Query Response
<NR1> <integer>
Front Panel Access
NA
 
DUT Port Setup
[:SENSe]:CORRection:COLLect:CONNector<port_no>
Description
Sets the connector family for the given port number. <port_no> is the port number, 1 or 2. <connector> defines the connector family and can be given in either long or short form. [connector-name] is a string that defines the name that is associated with the given <connector> and is optional. [connector-name] must be enclosed by parentheses.
Note that the connector must be valid for the current calibration line type.
The tables below list the connector and valid connector name that are associated with the calibration line type COAX. Note that User cal kit and Waveguide do not have a calibration name associated with them.
COAX <connector>
[connector-name]
Description
NMALe
OSLN50
N-Conn(M)
Cal Kit: OSLN50.
If no connector-name is given, then connector will be set to this.
Query Response string: “NMAL”
NMALe
SLN50A or OSLN50A-8 or OSLN50A-18
N-Conn(M)
Cal Kit: OSLN50A-8 or OSLN50A-18
Query Response string: “NMAL(OSLN50A-8 or OSLN50A-18)”
NMALe
TOSLN50A or TOSLN50A-8 or TOSLN50A-18
N-Conn(M)
Cal Kit: TOSLN50A-8 or TOSLN50A-18
Query Response string: “NMAL(TOSLN50A-8 or TOSLN50A-18)
NFEMale
OSLNF50
N-Conn(F)
Cal Kit: OSLNF50.
If no connector name is given, then connector will be set to this.
Query Response string: “NFEM”
NFEMale
OSLNF50A or OSLNF50A-8 or OSLNF50A-18
N-Conn(F)
Cal Kit: OSLNF50A-8 or OSLNF50A-18
Query Response string: “NFEM(OSLNF50A-8 or OSLNF50A-18)”
NFEMale
TOSLNF50A or TOSLNF50A-8 or TOSLNF50A-18
N-Conn(F)
Cal Kit: TOSLNF50A-8 or TOSLNF50A-18
Query Response string: “NFEM(TOSLNF50A-8 or TOSLNF50A-18)”
KMALe
OSLK50
K-Conn(M)
Cal Kit: OSLK50.
If no connector name is given, then connector will be set to this.
Query response string: “KMAL”
KMALe
TOSLK50A or TOSLK50A-20
K-Conn(M)
Cal Kit: TOSLK50A-20
Query Response string: “KMAL(TOSLK50A-20)”
KFEMale
OSLKF50
K-Conn(F)
Cal Kit: OSLKF50
If no connector-name is given, then connector will be set to this.
Query response string: “KFEM”
KFEMale
TOSLKF50A or TOSLKF50A-20
K-Conn(F)
Cal Kit: TOSLKF50A-20
Query Response string: “KFEM(TOSLKF50A-20)”
716Male
2000-767
7/16(M)
Cal Kit: 2000-767.
If no connector-name is given, then connector will be set to this.
Query response string: “716M”
716Male
2000-1618 or 2000-1618-R
7/16(M)
Cal Kit: 2000-1618-R
Query Response string: “716M(2000-1618-R)”
716Female
2000-768
7/16(F)
Cal Kit: 2000-768
If no connector name is given, then connector will be set to this.
Query response string: “716F”
716Female
2000-1619 or 2000-1619-R
7/16(F)
Cal Kit: 2000-1619-R
Query Response string: “716F(2000-1619-R)”
TNCMale
 
TNC(M)
Cal Kit: 1091-5x & 1015-55.
If no connector-name is given, then connector will be set to this.
Query response string: “TNCM”.
TNCFemale
 
TNC(F)
Cal Kit: 1091-5x & 1015-54
If no connector-name is given, then connector will be set to this.
Query response string: “TNCF”
SMAMale
3650
SMA(M)
Cal Kit: 3650
If no connector-name is given, then connector will be set to this.
Query response string: “SMAM”
SMAFemale
3650
SMA(F)
Cal Kit: 3650
If no connector-name is given, then connector will be set to this.
Query response string: “SMAF”
USR1
 
Query response string: “USR1”
USR2
 
Query response string: “USR2”
USR3
 
Query response string: “USR3”
USR4
 
Query response string: “USR4”
WAVEGUIDE <connector>
Description
WG11
WG11A/WR229/R40
Cal Kit: xxUM40
Query Response string: “WG11”
WG12
WG12/WR187/R48
Cal Kit: xxUM48 or xxUA187
Query Response string: “WG12”
WG13
WG13/WR159/R58
Cal Kit: xxUM58
Query Response string: “WG13”
WG14
WG14/WR137/R70
Cal Kit: xxUM70 or xxUA137
Query Response string: “WG14”
WG15
WG15/WR112/R84
Cal Kit: xxUM84 or xxUA11
Query Response string: “WG15”
WG16
WG16/WR90/R100
Cal Kit: xxUM100 or xxUA90
Query Response string: “WG16”
WG17
WG17/WR75/R120
Cal Kit: xxUM120
Query Response string: “WG17”
WG18
WG18/WR62/R140
Cal Kit: xxUM140 or xxUA62
Query Response string: “WG18”
WG20
WG20/WR42/R22
Cal Kit: xxUM220 or xxUA42
Query Response string: “WG20”
USR1
Query response string: “USR1”
USR2
Query response string: “USR2”
USR3
Query response string: “USR3”
USR4
Query response string: “USR4”
Syntax
[:SENSe]:CORRection:COLLect:CONNector<port_no> <connector>, [connector-name string]
[:SENSe]:CORRection:COLLect:CONNector<port_no>?
Cmd Parameter
<char> <connector>, [connector-name string]
Query Response
<char> <connector><(connector-name string)>
(connector is returned in short form only)
Default Value
NMAL (KMAL, if Option 11 is installed)
Example
To set the DUT connector for port 1 to K-Conn(M) Cal Kit: OSLK50.
:SENS:CORR:COLL:CONN1 KMAL, "OSLK50"
or
:SENS:CORR:COLL:CONN1 KMAL
To query for the DUT connector for port 1:
:SENS:CORR:COLL:CONN1?
For the example above the query response is: KMAL
To set the DUT connector for port 1 to K-Conn(M) Cal Kit: TOSLK50A-20
:SENS:CORR:COLL:CONN1 KMAL, "TOSLK50A"
or
:SENS:CORR:COLL:CONN1 KMAL, "TOSLK50A-20"
The query response would return the following:
KMAL(TOSLK50A-20)
Front Panel Access
Shift‑2 (Calibrate), DUT Port Setup, DUT Port 1/2
 
Configure Calibration Type
[:SENSe]:CORRection:COLLect:CTYPe
Description
Configures the calibration types. <cal type1> specifies the type of calibration (1‑port, 2‑port, response, etc) and must be one of the following values:
RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP|
|2PFP|2PRP
Refer to the table of calibration types at [:SENSe]:CORRection:COLLect:TYPE. Command [:SENSe]:CORRection:COLLect:TYPe has been kept for backward compatibility.
This command, [:SENSe]:CORRection:COLLect:CTYPe, allows you to specify whether the cal is Standard or Flex in addition to the Cal type.
<cal type2> specifies if the instrument performs a standard or flex type calibration, and must use one of the following values:
FLEX|STANdard
Syntax
[:SENSe]:CORRection:COLLect:CTYPe <cal type> FLEX|STANdard
[:SENSe]:CORRection:COLLect:CTYPE?
Cmd Parameter
<char> RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP|2PFP|2PRP, FLEX|STANdard
Query Response
<char> RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP|2PFP|2PRP, FLEX|STAN
Default Value
RF2P, STAN
Example
To set the cal type to Full S11, Flex:
:SENS:CORR:COLL:CTYP RFP1, FLEX
To query for the current cal type:
:SENS:CORR:COLL:CTYP?
The response would be:  RFP1, FLEX
Front Panel Access
Shift‑2 (Calibrate), Cal Type
 
Calibration Type
[:SENSe]:CORRection:COLLect:TYPE
Description
Compare with [:SENSe]:CORRection:COLLect:CTYPe, which has more functions than this command. This command is being kept for backwards compatibility. It configures the calibrate type. <cal type> is the calibration type and must be one of the following values:
RF2P|RFP1|RFP2|RFBP|TRFP|TRRP|TRBP|RRP1|RRP2|RRBP|2PFP|2PRP
CAL TYPE
DESCRIPTION
RF2P
Full 2 Port
RFP1
Full Port 1
RFP2
Full Port 2
RFBP
Full Both Ports
TRFP
Trans Response Fwd Path
TRRP
Trans Response Rev Path
TRBP
Trans Response Both Paths
RRP1
Reflection Response Port 1
RRP2
Reflection Response Port 2
RRBP
Reflection Response Both Ports
2PFP
1 Path 2 Port Fwd Path
2PRP
1 Path 2 Port Rev Path
Syntax
[:SENSe]:CORRection:COLLect:TYPE <cal type>
[:SENSe]:CORRection:COLLect:TYPE?
Cmd Parameter
<char> <cal type>
Query Response
<char> <cal type>
Default Value
RF2P
Front Panel Access
Shift‑2 (Calibrate), Cal Type
 
Calibration Thru Line Length
[SENSe:]CORRection:COLLect:EDELay:DISTance
Description
Set the Calibration Thru Line Length. <line length> is in distance.
Syntax
[SENSe:]CORRection:COLLect:EDELay:DISTance <line length>
[:SENSe]:CORRection:COLLect:EDELay:DISTance?
Cmd Parameter
<NRf> <line length>
Query Response
<NR3> <line length> (returned in millimeters)
Default Value
0
Default Unit
Meter (m) when setting, millimeters (mm) for query.
Example
To set to 10 meter:
SENS:CORR:COLL:EDEL:DIST 10m
or
SENS:CORR:COLL:EDEL:DIST 10
To query for line length:
:SENS:CORR:COLL:EDEL:DIST?
The response would be:  10000.00
Front Panel Access
Shift‑2 (Calibrate), Cal Line Setup, Line Length (Air)
 
Calibration Thru Line Length
[SENSe:]CORRection:COLLect:EDELay:TIME
Description
Sets the Calibration Thru Line Delay in units of time.
Syntax
[SENSe:]CORRection:COLLect:EDELay:TIME <line delay>
[:SENSe]:CORRection:COLLect:EDELay:TIME?
Cmd Parameter
<NRf> <line delay>
Query Response
<NR3> <line delay> (time returned in nanoseconds)
Range
–100 ms to +100 ms
Default Value
0
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query.
Example
To set the line delay to 12 millisecond:
SENS:CORR:COLL:EDEL:TIME 12ms
To query for line delay:
:SENS:CORR:COLL:EDEL:TIME?
The response would be:  12000000.000
Front Panel Access
Shift‑2 (Calibrate), Cal Line Setup, Line Delay
 
Calibration Interpolation
[:SENSe]:CORRection:COLLect:INTerpolation[:STATe]
Description
Turns the calibration interpolation ON or OFF. Note that interpolation automatically turns On after a flex cal.
Syntax
[:SENSe]:CORRection:COLLect:INTerpolation[:STATe] OFF|ON
[:SENSe]:CORRection:COLLect:INTerpolation[:STATe]?
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
0
Example
To set interpolation to ON:
:SENS:CORR:COLLect:INT:STAT ON
or
:CORR:COLLect:INT 1
Front Panel Access
Shift‑2 (Calibrate), Interpolation
 
Calibration Line Type
[:SENSe]:CORRection:COLLect:MEDium
Description
Sets the calibration line type.
Syntax
[:SENSe]:CORRection:COLLect:MEDium COAX|WGUide
[:SENSe]:CORRection:COLLect:MEDium?
Cmd Parameter
<char> COAX|WGUide
Query Response
<char> COAX|WGU
Default Value
COAX
Front Panel Access
Shift‑2 (Calibrate), Line Type
 
Calibration Method
[:SENSe]:CORRection:COLLect:METHod
Description
Sets the calibration method.
Syntax
[:SENSe]:CORRection:COLLect:METHod SOLT|SSLT|SSST
[:SENSe]:CORRection:COLLect:METHod?
Parameter
SOLT|SSLT|SSST
Cmd Parameter
<char> SOLT|SSLT|SSST
Query Response
<char> SOLT|SSLT|SSST
Default Value
SOLT
Front Panel Access
Shift‑2 (Calibrate), Cal Method
 
Calculate Calibration Data
[:SENSe]:CORRection:COLLect:SAVe
Description
Calculates the calibration data according to the calibration method that is selected and the steps that are performed and then stores the result. This command is similar to the “calculate and finish” on the front panel of the list of calibration steps.
Syntax
[:SENSe]:CORRection:COLLect:SAVe
Cmd Parameter
NA
Query Response
NA (no query)
Front Panel Access
NA
 
Calibration Status
[:SENSe]:CORRection:COLLect:STATus?
Description
This command requests information about the calibration status. The command returns 0 if none,if calibration has already started,if calibration has been aborted,if a calibration is currently calculating, andif a calibration has been completed.
Syntax
[:SENSe]:CORRection:COLLect:STATus?
Cmd Parameter
NA (query only)
Query Response
<NR1> (integer)
 0 = none
 1 = started
 2 = aborted
 3 = calculating
 4 = completed
Front Panel Access
NA
 
Calibration Accuracy Status
[:SENSe]:CORRection:COLLect:STATus:ACCuracy?
Description
This command requests information about the calibration accuracy status. The command returns 0 when no calibration is available (CAL off),when the calibration accuracy is high (OK: Accuracy High),when the accuracy is moderate due to a change in power level (?P: Accuracy Moderate),when the accuracy is moderate due to a change in temperature level by more than 5 deg C (?T: Accuracy Moderate), andwhen the accuracy is low due to a change in temperature level by more than 10 deg C (X: Accuracy Low).
Syntax
[:SENSe]:CORRection:COLLect:STATus:ACCuracy?
Cmd Parameter
NA (query only)
Query Response
<NR1> (integer)
 0 = CAL off
 1 = OK: Accuracy High
 2 = ?P: Accuracy Moderate
 3 = ?T: Accuracy Moderate
 4 =  X: Accuracy Low
Front Panel Access
Shift2 (Calibrate), Existing Cal Info
 
Calibration Type
[:SENSe]:CORRection:COLLect:TYPE
Refer to [:SENSe]:CORRection:COLLect:TYPE. The command was moved to enable easier comparison with [:SENSe]:CORRection:COLLect:CTYPe.