Sense:Correction:Collect:Guided Commands

SENSe:CORRection:COLLect:GUIDed:

ABORt

ACQuire

ADAPter

     | COUNt

          | ZERO

     | CREate?

     | DELay

     | DESCription

     | PATHs

CHANnel:MODE

CKIT

     | CATalog?

     | PORT

          | CATalog?

          | [SELect]

CONNector

     | CATalog?

     | PORT

          | [SELect]

DATA

    | CATalog?

DESCription

ECal

     | ACQuire

     | SELect

ETERms

     | COMPute

     | LOAD[:CSET]

INITiate

ISOLation

     | AVERage

          | INCRement

     | PATHs

ITERations

     | COUNt?

     | MINimum?

     | RESet

LIST

     | COUNt?

     | STEP

          | COUNt?

          | DESCription?

          | LABel?

          | PORTs?

          | STANdard

                  | LABel?

                  | PORTs?

                  | STYPe?

                  | TPORts?

          | STYPe?

          | TPORts?

METHod

PACQuire

PATH

     | CMEThod

     | TMEThod

PORTs?

PREFerence

     | SLIDingload

PSENsor - More commands

SAVE

     | CSET

SMC - More commands

STEPS?

THRU

Applicable Models: All

(Write-only) Aborts the acquiring of a guided calibration that has been INITialized but has not yet been concluded using the SAVE command.  If at least one Cal standard has already been measured, and the Calibration Window is being displayed, this command also closes the Calibration Window and re-tiles the other measurement windows.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

Examples

SENS:CORR:COLL:GUID:ABOR
sense2:correction:collect:guided:abort

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Initiates the measurement of the specified calibration standard. Executing this command with an unnecessary standard has no affect.

The measured data is stored and used for subsequent calculations of error correction coefficients. All standards must be measured before a calibration can be completed.  Any measurement can be repeated until the SENS:CORR:COLL:GUID:SAVE command is executed.

Query the user prompt description using SENS:CORR:COLL:GUID:DESC?

Query the required calibration steps using SENS:CORR:COLL:GUID:STEP?

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

STAN<n>

Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration.

Note: You do not necessarily have to invoke these connection steps in sequential order, but you must issue this command for all of the steps to be able to complete the calibration.

[sync]

Optional argument. Choose from:

SYNChronous - blocks SCPI commands during standard measurement (default behavior).

ASYNchronous - does NOT block SCPI commands during standard measurement.

Learn more about this argument

Examples

SENS:CORR:COLL:GUID STAN1
sense2:correction:collect:guided:acquire stan1

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-only) Specifies the use of a THRU adapter to be used during the Guided Cal Unknown THRU and Adapter Removal Cal. Returns an adapter index <n> which is used to refer to the adapter in several related commands. See Cal Thru Methods. While the choice of which end of the adapter is <conn1> and <conn2> is arbitrary, it is necessary to remember which will be used on each test port.

The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<conn1>

Adapter port 1 connector type. Use SENS:CORR:COLL:GUID:CONN:CAT? to return a list of valid connector types.

<conn2>

Adapter port 2 connector type.

Examples

See example using this command.

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-Only)  Returns the number of THRU adapters that have been created for this calibration using SENS:CORR:COLL:GUID:ADAP:CREate.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

Examples

See example using this command.

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Write-only) Removes all adapters that have been defined for calibrations on the specified channel using SENS:CORR:COLL:GUID:ADAP:CREate.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

Examples

SENS:CORR:COLL:GUID:ADAP:COUNt:ZERO
sense2:correction:collect:guided:adapter:count:zero

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Specifies the adapter delay. and optionally waveguide delay and optional phase offset (degrees) of adapter <n>.

The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<n>

Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate?

<coax>

Delay value of coax adapter <n> in seconds. If the adapter has no coax connector, enter 0.

<wphase>

Waveguide phase offset in degrees. If the adapter has no waveguide connector, do not enter a value.

<wdelay>

Waveguide delay in seconds. If the adapter has no waveguide connector, do not enter a value.

Examples

See example using this command.

Default

Not Applicable

Applicable Models: All

(Write-only) Specifies the adapter description for use as the guided cal connection prompts.

The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<n>

Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate?

<string>

Adapter description.

Examples

See example using this command.

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Specifies the port pairs for which the adapter will be used for a THRU connection.

For example, for a 3-port cal on channel 1 using ports 1,2,and 3), to use adapter 1 between the ports (1 to 2) and (1 to 3) the following command is used: SENS1:CORR:COLL:GUID:ADAP1:PATH 1,2,1,3.

The adapter must have the same DUT connectors as the ports that are already specified for these ports.

The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<n>

Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate?

<port pair>

Ports for which the adapter will be used. The orientation is not critical, as the VNA will align the connector types as necessary. The minimum number of Thru connections required is the number of ports to calibrated -1.

Examples

See example using this command.

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-Write) Determines whether or not to honor the channel <ch> argument in guided calibration SCPI commands.

Parameters

<bool>

OFF (0)   Honor all <ch> arguments. This means the <ch> channel is calibrated regardless of which channel is currently active.

ON (1)  Legacy behavior. Behavior is specified by the following table:

Learn about Standard vs Application channels.

Examples

SENS:CORR:COLL:GUID:CHAN:MODE 0

sense:correction:collect:guided:channel:mode ON

Query Syntax

SENSe:CORRection:COLLect:GUIDed:CHANnel:MODE?

Return Type

Boolean

Default

OFF - This is the default beginning with A.09.50

ON - Default before A.09.50

Applicable Models: All

(Read-only) This command replaces SENS:CORR:COLL:GUID:CKIT:PORT:CAT?

Returns a comma-separated list of valid kits that use the specified connector type. This includes mechanical cal kits, applicable characterizations found within ECal modules currently connected to the VNA, and all user characterizations stored in VNA disk memory. For ECal modules, the returned list includes the serial numbers.  See ECal User Characterization commands.

Use items in the list to select the kit to be used with the SENS:CORR:COLL:GUID:CKIT:PORT  and SENSe<ch>:CORRection:COLLect:GUIDed:PSENsor<pnum>:CKIT  commands.

Parameters

<conn>

String. Connector type. Use SENS:CORR:COLL:GUID:CONN:CAT? to return a list of valid connector types.

Examples

SENSe:CORR:COLL:GUID:CKIT:CAT? "Type N (50) male"

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) This command is replaced by SENSe:CORR:COLL:GUID:CKIT:CAT?.

Returns a comma-separated list of valid kits for the specified VNA port. In addition to mechanical calibration kits, this will include applicable characterizations found within ECal modules currently connected to the VNA.

Use items in the list to select the kit to be used with the SENS:CORR:COLL:GUID:CKIT:PORT command.

Note: The serial number is returned for ALL ECal modules that are connected with the connector type of the specified port. Previously, the returned list would include the serial numbers to distinguish the ECal modules only when two or more identical ECal models were connected to the VNA.

Parameters

<pnum>

Any existing port number.  If unspecified, value is set to 1

Examples

SENS:CORR:COLL:GUID:CKIT:PORT1:CAT?
'When "Type N (50) male" is specified for connector type, returns:

"85054D, 85032F"

'When two identical ECal modules are connected for the connector type,
'the return string includes serial numbers

"85092-60010 ECal 10675, 85092-60010 ECal 00758"

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-Write) Specifies the calibration kit (mechanical or ECal) for each port to be used during a guided calibration. An unused port does NOT need to have a specified Cal Kit.

1. Specify the connector type for the port with SENS:CORR:COLL:GUID:CONN:PORT.

2. Query the valid available kits for the connector on each port with SENS:CORR:COLL:GUID:CKIT:PORT:CAT?

3. Specify the kit using this command.

4. Perform a query of this command. If the <kit> parameter was incorrectly entered, an error will be returned.

When using this command to specify the cal kit for the output of a VMC calibration mixer, specify port 3. If port 3 is already used for the output of the DUT mixer, then specify port 4. Learn more.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<pnum>

Any existing port number. If unspecified, value is set to 1

<kit>

Calibration kit to be used for the specified port. Case-sensitive.

When using an ECal module, include the characterization name in the <kit> string. Use SENSe:CORR:COLL:GUID:CKIT:CAT? to read the list of characterizations available in the module and in VNA disk memory.

If two or more identical ECal modules are connected to the VNA, the serial number must be included to distinguish the ECal modules.

Examples

'Note: All of the following examples specify port 1 only

' Mechanical Cal kit

SENS:CORR:COLL:GUID:CKIT:PORT1 '85055A'

 ' Standard ECal modules

SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 ECal"

' Non-factory ECal characterizations are specified as follows:

SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 User 1 ECal"

' When two or more ECal modules with the same model number are

' connected, also specify the serial number as follows:

SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 ECal 01234"

' When Disk Memory ECal user characterizations are used,

' specify both the User char and the serial number as follows:

SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 MyDskChar ECal 01234"

Query Syntax

SENSe:CORRection:COLLect:GUIDed:CKIT:PORT<pnum>[:SELect]?

Return Type

String - If the <kit> parameter was incorrectly entered while writing, an error will be returned.

Default

Not Applicable

Applicable Models: All

(Read only) Returns a list of valid connectors based on the connector descriptions of the available cal kits. Use an item from the returned list to specify a connector for SENS:CORR:COLL:GUID:CONN:PORT

Here are the more common connector types:

Examples

SENS:CORR:COLL:GUID:CONN:CAT?
Returns:

Type N (50) female, Type N (50) male, APC 7 (50), 3.5 mm (50) male, 3.5 mm (50) female, User Connector A

Return Type

Comma separated string values

Default

Not Applicable

Applicable Models: All

(Read-Write) Specifies a DUT connector type for every port during the Guided Calibration procedure. Valid DUT connector names are stored within calibration kits. Some cal kits may include both male and female DUT connectors. Therefore, specifying the DUT connector gender may be required.

The VNA remembers previous Guided Cal settings. Therefore, for completeness, unused ports can either be defined as "Not used" or use the SENS:CORR:COLL:GUID:ABORt command to clear all ports. The ABORt command is a more thorough approach and more convenient. See Guided Cal examples.

• A single port with a valid <conn> name indicates  a 1-Port calibration will be performed.  

• Two ports with valid <conn> names indicate either a 2-Port SOLT or TRL calibration will be performed depending on the standards definition found within the cal kit and the capability of the VNA.

• Three ports with valid <conn> names indicate a 3-Port calibration will be performed, and so forth.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<pnum>

Any existing port number. If unspecified, value is set to 1.

<conn>

String - DUT connector type to connect with VNA port <pnum>. Case-sensitive.

Examples

'Specifying a 2-port cal (1 & 2) on a 4-port VNA

SENS:CORR:COLL:GUID:CONN:PORT1 'Type N (50) female'
SENS:CORR:COLL:GUID:CONN:PORT2 'Type N (50) male'
SENS:CORR:COLL:GUID:CONN:PORT3 'Not used'
SENS:CORR:COLL:GUID:CONN:PORT4 'Not used'

Query Syntax

SENSe:CORRection:COLLect:GUIDed:CONNector:PORT<pnum>[:SELect]?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-Write) Sets and returns the measurement data for a specified measurement parameter of a particular step of a guided cal (and for a specific state of an ECal if the step is an ECal step). The measurement data is complex real-and-imaginary pairs where the number of points is the current number of points on the channel, and is in ASCII or binary format as dictated by the current setting of the FORMat:DATA command.

Note: This command only applies to cals of standard S-parameter channels.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

STAN<n>

Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration.

Note: You do not necessarily have to invoke these connection steps in sequential order.

<meas parameter>

Measurement parameters for standard S-parameter channels.

[<ECal state num>]

ECal state number.

Examples

See an example that uses this command.

Query Syntax

SENSe:CORRection:COLLect:GUIDed::DATA? STAN<n>, <meas parameter>, [<ECal state num>]

Return Type

Depends on FORMat:DATA

Default

Not Applicable

Applicable Models: All

(Read-only) Returns a comma-delimited string of measurement parameters that have to be measured in the specified step number of a guided calibration.

Note: This command only applies to cals of standard S-parameter channels.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

STAN<n>

Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration.

Note: You do not necessarily have to invoke these connection steps in sequential order.

Examples

SENS:CORR:COLL:GUID:DATA:CAT? STAN1
See an example that uses this command.

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the connection description for the specified calibration step.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<step>

A number from 1 to the number of steps required to complete the calibration (Use SENS:CORR:COLL:GUID:STEP? to query the number of steps )

Examples

SENS:CORR:COLL:GUID:DESC? 10

'Returns:
Connect APC 7 Open to port3

Return Type

String

Default

Not Applicable

(Write only) Execute the Ecal calibration with specified Ecal using SENS:CORR:COLL:GUID:ECAL:SEL. If ECal module is not specified, the first Ecal in the list is used. One item that we discussed is that this command needs to be overlapped. That's because it can be quite slow to finish an ecal, and slow operations need to be implemented using overlapped SCPI. Otherwise, the client will time out and will be unable to poll for completion. So, the command must be followed with either a *OPC? or a *OPC and serial poll.

Parameters

<ch>

Channel to be calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<cal method>

String  Calibration Method.

SOLT: using defined through

SOLR: using undefined through

ERESponse: Enhanced Response

<port list>

Array  Port number to be calibrated. If enhanced response (ERESponse) is selected, the first port number is the stimulus port and the second port number is the response port.

[calset]

Optional argument. Cal Set name

If NOT specified, behavior depends on the SENS:CORR:PREFerence:CSET:SAVE setting.

If specified, choose an existing Cal Set, either by name or by GUID.

• By Cal Set name: include quotes.

• Query all Cal Set GUIDs with SENS:CORR:CSET:CAT?

An error is reported if the Cal Set is not found.

The Cal Set is either supplemented or overwritten depending on the method, connectors, and ports selected. Learn more about Cal Sets.

Examples

' Full 2 port cal with defined through for ports 2 and 3

SENS:CORR:COLL:GUID:ECAL:ACQ SOLT,2,3

' Enhance Response Cal for ports 4 (Stimulus) and 1 (Response)

SENS:CORR:COLL:GUID:ECAL:ACQ ERES,4,1

' Full 2 port cal with calset and undefined through for ports 1 to 4

SENS:CORR:COLL:GUID:ECAL:ACQ SOLR,1,2,3,4,"MyCalSet"

Query Syntax

Not Applicable

Default

Not Applicable

(Read-Write) Specifies the Ecal Kit for Ecal Calibration. This is a new command that specifies the ECal kit to be used in the new 1-shot ECal execution command.  If not specified, the 1-shot command will internally select the top one from the connected ECal kits (like the basic cal and start cal dialogs are doing.)

The top ecal kit in the list can be determined in two ways:  by an internal module number that is dependent on the order in which the ecals are enumerated on the USB.  Or it could be an alphabetical sorting by name.  This default selection will allow the user to use generic test code but only if there is only one ECal connected.

Parameters

<ch>

Channel to be calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<ecal kit>

Ecal kit to be used for the specified port. Case-sensitive.

Include the characterization name in the <kit> string. Use SENSe:CORR:COLL:GUID:CKIT:CAT? to read the list of characterizations available in the module and in VNA disk memory.

If two or more identical ECal modules are connected to the VNA, the serial number must be included to distinguish the ECal modules.

Examples

 ' Standard ECal modules

SENS:CORR:COLL:GUID:ECAL "N4691-60004 ECal"

' Non-factory ECal characterizations are specified as follows:

SENS:CORR:COLL:GUID:ECAL "N4691-60004 User 1 ECal"

' When two or more ECal modules with the same model number are

' connected, also specify the serial number as follows:

SENS:CORR:COLL:GUID:ECAL "N4691-60004 ECal 01234"

' When Disk Memory ECal user characterizations are used,

' specify both the User char and the serial number as follows:

SENS:CORR:COLL:GUID:ECAL "N4691-60004 MyDskChar ECal 01234"

Query Syntax

SENSe:CORRection:COLLect:GUIDed:ECAL[:SELect]?

Return Type

String - If the <kit> parameter was incorrectly entered while writing, an error will be returned.

Default

Not Applicable

Applicable Models: All

(Write-only) Computes the error correction terms, turns Correction ON, and saves the calibration to an existing, specified Cal Set.

The cal acquisition process does not conclude as with the SAVE command. This command leaves the cal acquisition in memory to allow re-measuring/re-computing. To conclude the cal acquisition process, use the SENS:CORR:COLL:GUID:ABOR. command.

Learn all about Cal Sets.

Note: This command is NOT supported for application channels (Gain Compression, SMC/VMC, Noise Figure, IMD and so forth). Use SENS:CORR:COLL:GUID:SAVE and save to a cal register. You can then use SENS:CORR:CSET:COPY to copy the cal register to a named Cal Set.

• Use this command instead of specifying the optional name or GUID argument in SENS:CORR:COLL:GUID:INIT.

• Use SENS:CORRection:CSET commands to get names of existing Cal Sets.

• The cal data is also saved to the channel Cal Register.

• If all of the required standards have not been measured, the calibration will not complete properly.

For Calibrate All Channels

When this command is used during a Cal All session, the <cal set name> argument sets the User Cal Set prefix.  All generated Cal Sets will be preceded with this string name.

• Cal Set prefix can also be set using SYST:CAL:ALL:CSET:PREFix. When the Cal Set prefix has already been set with SYST:CAL:ALL:CSET:PREFix, this command overwrites it.

• When <cal set name> is an empty string, a User Cal Set will not be saved.  Only Cal Registers will be saved.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<cal set name>

String - Name of an existing Cal Set to be overwritten.

See Calibrate All Channels note (above).

Examples

SENS:CORR:COLL:GUID:ETER:COMP "{2B893E7A-971A-11d5-8D6C-00108334AE96}"

sense:correction:collect:guided:eterms:compute "MyCalSet"

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only)  Loads 1-port error terms from a Cal Set into the current Guided Cal sequence. When the Cal steps are recomputed, connection steps are removed due to the loading of the error terms.

This command must be sent after the INIT command. This command was implemented to facilitate calibrating a large matrix of external ports and most users will not need to use this command.

See example of how to use this command.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<cset>

String  Name of User Cal Set in which the error terms reside.

<pnum>

Integer  Port number of the current cal to receive error terms.

[csPort]

Integer  Optional argument. Port number associated with the error terms in the Cal Set. If unspecified, the same port number as <calPort> is used.

Examples

See example

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Initiates a guided calibration.

• The VNA determines the measurements needed to perform the calibration using the settings specified from the SENS:CORR:COLL:GUID:CONN:PORT and SENS:CORR:COLL:GUID:CKIT:PORT commands.

• After this command is executed, subsequent commands can be used to query the number of measurement steps, issue the acquisition commands, query the connection description strings, and subsequently complete a guided calibration. See example calibration programs.

Parameters

<ch>

Channel to be calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

[string]

Optional argument. Cal Set name or GUID enclosed in quotes.

If NOT specified, behavior depends on the SENS:CORR:PREFerence:CSET:SAVE setting.

If specified, choose an existing Cal Set, either by name or by GUID.

• By Cal Set name: include quotes.

• Query all Cal Set GUIDs with SENS:CORR:CSET:CAT?

An error is reported if the Cal Set is not found.

The Cal Set is either supplemented or overwritten depending on the method, connectors, and ports selected. Learn more about Cal Sets.

[bool]

Optional argument. To set this argument, also set the first optional argument. See example below.

OFF (0)   If Cal Set stimulus settings differ from the existing channel, do not change channel stimulus settings. The Cal Set is saved to the current setting of the SENS:CORR:PREF:CSET:SAVE command. This is the default setting if not specified.

ON (1)  If Cal Set stimulus settings differ from the existing channel, change the channel stimulus settings to match the Cal Set settings.

[char]

Optional argument. To set this argument, also set the first two optional arguments. See example below.

SYNChronous - blocks further SCPI commands while processing this command.. (default setting).

ASYNchronous - does NOT block further SCPI commands while processing this command.

Learn more about this argument

Examples

SENS:CORR:COLL:GUID:INIT

'set first optional argument

SENS:CORR:COLL:GUID:INIT "MyCalSet"

'set two optional arguments

SENS:CORR:COLL:GUID:INIT " ",1

'set all optional arguments

SENS:CORR:COLL:GUID:INIT "MyCalSet",1,ASYN

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-Write) Specifies amount to increment (increase) the channels averaging factor during measurement of isolation standards in a guided calibration.

Note: If the channel has averaging turned OFF and the value of <num> is greater than 1, averaging will be turned ON only during the isolation measurements and with the averaging factor equal to <num>.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<num>

Amount to increment the averaging factor for the isolation measurement. The maximum averaging factor for the channel is  65536 (2^16).

Examples

'Measure isolation on all paths for the cal

SENS:CORR:COLL:GUID:ISOL ALL

'Remove the port pairs 1-to-2 and 1-to-3 from the list of paths on which to measure isolation

sense:correction:collect:guided:isolation:paths REMove,1,2,1,3

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation:AVERage:INCRement?

Return Type

Numeric

Default

8 - If this command is NOT sent, but isolation is measured, then averaging will be turned ON with factor set to 8 during the isolation measurements.

Applicable Models: All

(Read-Write) Specifies the paths (port pairs) to make isolation measurements on during a guided calibration.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<char>

ALL Measure isolation on all pairings of the ports that are to be calibrated.

NONE Do not measure isolation on any pairing of the ports to be calibrated. (Default behavior).

ADD Add one or more specific pairings of ports to the list of port pairings for which isolation will be measured.

REMove Remove one or more specific pairings of ports from the list of port pairings for which isolation will be measured. If many paths are to be measured, it may be easier to first send ALL, then REMove and specify the paths to remove.

<p1a, p2a...>

For use when <char> is ADD or REMove.

Specify Port numbers in pairs:

• For 3-port cals, specify up to 3 pairs.

• For 4-port cals, specify up to 6 pairs.

p1a, p1b  (Path1 - port A and port B)

p2a, p2b  (Path2 - port A and port B)

p3a, p3b  (Path3 - port A and port B)

Examples

'Measure isolation on all paths for the cal

SENS:CORR:COLL:GUID:ISOL ALL

'Remove the port pairs 1-to-2 and 1-to-3 from the list of paths on which to measure isolation

sense:correction:collect:guided:isolation:paths REMove,1,2,1,3

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation:PATHs?

Note: if isolation is not be measured on any of the paths, the query returns 0

Return Type

Numeric

Default

0 - Isolation not measured on any paths.

Applicable Models: All

(Read-only)  Designed to be used for an iterative cal standard such as a sliding load, this command returns the number of iterative measurement acquisitions that has been made for the specified step.

Zero (0) is returned if the step has not yet been measured.

For most cal steps that have already been measured, this command returns 1.

Set SENS:CORR:COLL:GUID:PREF:SLID ITER to count acquisition steps.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<step>

Guided Cal step number for which the acquisition number will be returned.

Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration.

Examples

SENS:CORR:COLL:GUID:ITER:COUN? 4

'Example return:

5

See example program

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-only) Designed to be used for an iterative cal standard such as a sliding load, this command returns the minimum number of required iterative measurement acquisitions for the specified step.

For most connection steps this will return 1, but for an iterative cal standard such as a sliding load, it will return a number such as 5.

Set SENS:CORR:COLL:GUID:PREF:SLID ITER to count acquisition steps.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<step>

Guided Cal step number for which to return the number of iterative measurement acquisitions that have been made. Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration.

Examples

SENS:CORR:COLL:GUID:ITER:MIN? 4

'Example return:

5

See example program

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Write-only) Resets the specified guided cal connection step as unmeasured. This clears all previous measurements made for that step.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<step>

Guided Cal step number to reset. Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration.

Examples

SENS:CORR:COLL:GUID:ITER:RESet? 4

See example program

Return Type

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the number of measurement steps required to complete the current guided calibration. This command is the same as the SENS:CORR:COLL:GUID:STEP command.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

Examples

SENS:CORR:COLL:GUID:LIST:COUN?
sense2:correction:collect:guided:list:count?

Return Type

Numeric

Default

0

Applicable Models: All

(Read-only) Returns the number of standards for step[n]. This is generally 1 unless the standard is an isolation standard or a composite standard.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:COUN?
sense2:correction:collect:guided:list:step1:count?

Return Type

Numeric

Default

1

Applicable Models: All

(Read-only) Returns the step description.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:DESC?
sense2:correction:collect:guided:list:step1:description?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the label for the complete standard used in the step. If the standard is a composite standard, the label is for the composite device.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:LAB?
sense2:correction:collect:guided:list:step1:label?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the number of ports on the standard used in the step. If the standard is a composite standard, the number of ports applies to the composite. So if the composite standard is an offset line connected to a load, the composite device is a 1 port device.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:PORT?
sense2:correction:collect:guided:list:step1:ports?

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the label for the one of the standards used in the step. If the step contains only a single standard, the response to this query is identical to SENS:CORR:COLL:GUID:LIST:STEP:LAB?

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

<StandardCount>

Standard number from 1 to 3.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:STAN:LAB?
sense2:correction:collect:guided:list:step1:standard2:label?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the number of ports on one of the standard used in the step. If the step contains only a single standard, the response to this query is identical to SENS:CORR:COLL:GUID:LIST:STEP:PORT?

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

<StandardCount>

Standard number from 1 to 3.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:STAN:PORT?
sense2:correction:collect:guided:list:step1:standard2:ports?

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the enumeration for the type of standard that describes one of the standard devices used in the step. If the step contains only a single standard, the response to this query is identical to SENS:CORR:COLL:GUID:LIST:STEP:STYP?

The following list of enumerations is currently defined:

OPEN | SHORt | LOAD | REFLection | THRU | LINE | ECAL | ISOLation | COMPosite | SENSor | PHASeref | MIXer

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

<StandardCount>

Standard number from 1 to 3.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:STAN:STYP?
sense2:correction:collect:guided:list:step1:standard2:stype?

Return Type

Enumeration

Default

OPEN

Applicable Models: All

(Read-only) Returns the list of VNA test ports to which one of the standards is attached. If the step contains only a single standard, the response to this query is identical to  SENS:CORR:COLL:GUID:LIST:STEP:TPORts?

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

<StandardCount>

Standard number from 1 to 3.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:STAN:TPOR?
sense2:correction:collect:guided:list:step1:standard2:tports?

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the enumeration for the type of standard device used in the step. 

The following list of enumerations is currently defined:

OPEN | SHORt | LOAD | REFLection | THRU | LINE | ECAL | ISOLation | COMPosite | SENSor | PHASeref | MIXer

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:STYP?
sense2:correction:collect:guided:list:step1:stype?

Return Type

Enumeration

Default

OPEN

Applicable Models: All

(Read-only) Returns the list of VNA test ports to which the standard(s) in this step is attached.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

<ListCount>

Step number from 1 to 1000.

Examples

SENS:CORR:COLL:GUID:LIST:STEP:TPOR?
sense2:correction:collect:guided:list:step1:tports?

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

This command is replaced with SENS:CORR:COLL:GUID:PATH:CMEThod and SENS:CORR:COLL:GUID:PATH:TMEThod.

(Read-Write) Selects from one of several algorithms available for performing the THRU portion of a guided calibration. Learn more about THRU methods.

Parameters

<char>

DEFAULT - Informs guided calibrations to use the default algorithm when computing the number of needed standards acquisition steps. (default selection if omitted.)

ADAP - Use the adapter removal algorithm

FLUSH - Use with insertable devices.

UNKN - Use the Unknown THRU algorithm with calibrations for non-insertable devices.

DEFined  - Use the THRU definition that you stored in the cal kit file, or ECal module.

TRL - Select TRL Cal Type for guided cals.  Valid for "TRL ready" Cal Kits with properly assigned TRL cal classes.

SOLT  - Select SOLT Cal Type for guided cals.  Valid for any kit with properly assigned SOLT cal classes.

Examples

SENS:CORR:COLL:GUID:METH ADAP
sense:correction:collect:guided:method unkn 

Query Syntax

SENSe:CORRection:COLLect:GUIDed:METHod?

Return Type

Character

Default

DEFAULT

Applicable Models: All

(Write-only) Show the Cal Window, and optionally one or more other specific windows before acquiring a Cal standard. This command will cause the Cal Window to display the specific measurements that are to be made for that particular Cal standard to facilitate the connection of standards.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

STAN<n>

Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration.

Note: You do not necessarily have to invoke these connection steps in sequential order.

Examples

SENS:CORR:COLL:GUID:PACQuire STAN2

sense:correction:collect:guided:pacquire STAN5

See an example that uses this command.

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

Note: This command replaces SENS:CORR:COLL:GUID:METH.

(Read-Write) Specifies the calibration method for each port pair.

Note: Sending this command will overwrite the VNAs SmartCal determinations for the most accurate cal method for your connector settings and Cal Kits.  Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic. You can send the query form of this command to learn the cal method determined by SmartCal.

See Thru Pairs Sequence to learn how to send this and other Thru commands.

After sending this command, send the query form to be sure that the command was accepted. If not, then the chosen Cal method is not compatible with the specified Thru method. For example, if the specified Thru method is Unknown Thru, an attempt to set Enhanced Response Cal should be rejected.

Learn more about Thru Methods.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<port1>

First port of the pair to be calibrated.

<port2>

Second port of the pair to be calibrated.

<caltype1[caltype2]>

(String) Cal type for the port pair, enclosed in a single pair of quotes.  NOT case-sensitive.

caltype1 Choose from:

• TRL

• SOLT

• QSOLTN

• EnhRespN

• TransRespN

For the last two arguments, replace N with the port to be used as the source port, which MUST be one of the port pair.

caltype2  Optional argument. Use only when performing an adapter removal cal on the pair. This argument specifies the Cal type on the second port.  Caltype1 then specifies the Cal type of the first port.

Choose from the same arguments as caltype1.

Examples

SENS:CORR:COLL:GUID:PATH:CMEThod 2,3,"QSOLT2"

sense:correction:collect:guided:path:cmethod 2,3,"solt,trl"

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:PATH:CMEThod? <port1>,<port2>

If only one caltype is returned then its NOT adapter removal.

Return Type

String

Default

The most accurate Cal method for the current cal.

Applicable Models: All

Note: This command replaces SENS:CORR:COLL:GUID:METH.

(Read-Write) Specifies the calibration THRU method for each port pair.

Note: Sending this command will overwrite the VNAs SmartCal determination for the thru method.  Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic.  You can send the query form of this command to learn the THRU method determined by SmartCal.

See Thru Pairs Sequence to learn how to send this and other Thru commands.

Learn more about Thru methods.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<port1>

First port of the port pair to be calibrated.

<port2>

Second port of the port pair to be calibrated.

<thruType1[,thruType2]>

(String) Thru methods for port pair, enclosed in a single pair of quotes.  NOT case-sensitive.

thruType1  Calibration Thru method. Choose from:

• Defined Thru  Measures a Thru for which there is a stored definition in the Cal kit of the lowest-numbered port of the pair. For example, if the port pair is 1,2, then the cal kit for port 1 MUST contain a Defined Thru.

• Zero Thru  Measures a Zero length Thru, also known as Flush-Thru.

• Undefined Thru  (Also known as Unknown Thru)  A Thru type for which there is NOT a stored definition in the Cal Kit. Valid ONLY for SOLT cal type.

• Undefined Thru using a Defined Thru  (ECal modules ONLY) Measures the internal Thru as an Unknown Thru.

thruType2  Optional argument. Use ONLY when Adapter Removal Cal is specified for the pair using SENS:CORR:COLL:GUID:PATH:CMEThod. When specifying ThruType2, this is the only valid argument: "Defined Thru, Defined Thru"

Examples

SENS:CORR:COLL:GUID:PATH:TMEThod 2,3,"Zero Thru"
sense:correction:collect:guided:path:tmethod 2,3,"Defined Thru,Defined Thru"

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:PATH:TMEThod? <port1>,<port2>

Always returns two parts:

If the second part of the string is empty, adapter removal is NOT being performed.

If the string is "Defined Thru, Defined Thru", adapter removal IS being performed.

Return Type

String

Default

The most accurate Thru method for the current cal.

Applicable Models: All

(Read-only) Returns the list of ports being calibrated by an active calibration session.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

Examples

SENS:CORR:COLL:GUID:PORT?
sense2:correction:collect:guided:ports?

Return Type

List of numbers

Default

Not Applicable

Applicable Models: All

(Read-Write) Specifies the behavior for guided cal steps that involve a sliding load in a cal that is about to be performed. Send this command BEFORE sending the Guided INIT command.

Although the term 'Preference' is used in the command, this is NOT a VNA preference. This setting does NOT survive instrument preset or reboot. It remains ONLY for the duration of the Guided Cal.

Parameters

<char>

Behavior when measurements of sliding load are acquired. Choose from:

DIALog - The Sliding load dialog box appears when the acquire command is received for a sliding load step.  All slide positions are measured (with a user-interface prompt) from a single invocation of the acquire command.

ITERate - Each invocation of the acquire command for a sliding load step measures a single slide position and increments the slide position counter. No Move Sliding Load prompt is presented on the VNA screen.

Examples

SENS:CORR:COLL:GUID:PREF:SLID ITER

See example program

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:PREFerence:SLIDingload?

Return Type

Character

Default

DIALog

Applicable Models: All

(Write-only) Completes the guided cal by computing the error correction terms, turning Correction ON, and saving the calibration to a Cal Set. If all of the required standards have not been measured, the calibration will not complete properly.

Learn all about Cal Sets.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

[bool]

Optional argument. If unspecified, the default behavior is the current VNA preference setting of SENSe:CORRection:PREFerence:CSET:SAVE.

OFF (0)   Save cal data ONLY to a Cal Register.

ON (1)  Save cal data to a Cal Register and a User Cal Set. The filename is automatically generated.

• For application channels (Gain Compression, SMC/VMC, Noise Figure, IMD and so forth), this command saves ONLY to a Cal Register. Use SENS:CORR:CSET:COPY to copy the cal register to a named calset.

• For a Calibrate All Channels session, this argument is ignored.  Instead, use SYST:CAL:ALL:CSET:PREFix.

Examples

SENS:CORR:COLL:GUID:SAVE
sense2:correction:collect:guided:save:immediate 0

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Completes the guided cal by computing the error correction terms, turning Correction ON, and saving the calibration to an existing, specified Cal Set. This command performs the same function as SENSe:CORRection:COLLect:GUIDed:SAVE, except this command allows the name or GUID of the Cal Set to be specified.

Learn all about Cal Sets.

Note: This command is NOT supported for application channels (Gain Compression, SMC/VMC, Noise Figure, IMD and so forth). Use SENS:CORR:COLL:GUID:SAVE and save to a cal register. You can then use SENS:CORR:CSET:COPY to copy the cal register to a named Cal Set.

• Use this command instead of specifying the optional name or GUID argument in SENS:CORR:COLL:GUID:INIT.

• Use SENS:CORRection:CSET commands to get names or GUIDs of existing Cal Sets.

• The cal data is also saved to the channel Cal Register.

• If all of the required standards have not been measured, the calibration will not complete properly.

For Calibrate All Channels

When this command is used during a Cal All session, the <cal set name> argument sets the User Cal Set prefix.  All generated Cal Sets will be preceded with this string name.

• Cal Set prefix can also be set using SYST:CAL:ALL:CSET:PREFix. When the Cal Set prefix has already been set with SYST:CAL:ALL:CSET:PREFix, this command overwrites it.

• When <cal set name> is an empty string, a User Cal Set will not be saved.  Only Cal Registers will be saved.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<cal set name or guid>

String - Name or GUID of an existing Cal Set to be overwritten. If specifying a GUID, curly brackets must be included.

See Calibrate All Channels note (above).

Examples

SENS:CORR:COLL:GUID:SAVE:CSET "{2B893E7A-971A-11d5-8D6C-00108334AE96}"

sense:correction:collect:guided:save:cset "MyCalSet"

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the number of measurement steps required to complete the current guided calibration. This command is sent after the SENS:CORR:COLL:GUID:INIT, SENS:CORR:COLL:GUID:CONN:PORT and SENS:CORR:COLL:GUID:CKIT:PORT commands.

Parameters

<ch>

Any existing channel number. If unspecified, value is set to 1.

Examples

SENS:CORR:COLL:GUID:STEP?
sense2:correction:collect:guided:steps?

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-Write) For calibrating more than 2-ports ONLY. Specifies the port pairs for the Thru connections of the calibration.  Send the query form of this command to learn the Thru pairs determined by SmartCal.

Note: Sending this command will overwrite the VNAs SmartCal determinations for the thru ports.  Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic.

See Thru Pairs Sequence to learn how to send this and other Thru commands.

Parameters

<ch>

Channel being calibrated, depending on the CHAN:MODE setting.  If unspecified, value is set to 1.

<t1a,t1b...>

Always specify port numbers in pairs: For example: 1,2 or 1,2,1,3

• For 3-port cals, specify two or three pairs.

• For 4-port cals, specify from three up to six pairs.

Examples

SENS:CORR:COLL:GUID:THRU:PORT 1,2,1,3,1,4 '4-port measurement

sense:correction:collect:guided:thru:ports 1,2,2,3 '3-port measurement

Query Syntax

SENSe<ch>:CORRection:COLLect:GUIDed:THRU:PORTs?

Return Type

Numeric

Default

Port pairings that were used in the previous cal.