Sense:Correction:Cset Commands

SENSe:CORRection:CSET

ACTivate

CATalog?

COPY

CREate

     | DEFault

DATA

DEACtivate

DELete

DESCription

ETERm

     | CATalog?

     | [DATA]

FLATten

GENerate

     | RECeiver

GUID

ITEM

     | CAT?

     | [:DATA]?

NAME

SAVE

[SELect]

STANdard

STIMulus?

TSET

     | ALLPorts?

     | TYPE?

TYPE

     | CATalog?

Applicable Models: All

This command replaces SENS:CORR:CSET:GUID

(Read-Write) Selects and applies a Cal Set to the specified channel.

Use SENS:CORR:CSET:CAT? to list the Cal Sets.

Parameters

<cnum>

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

<string>

Cal Set to make active. Specify the Cal Set by GUID or Name. Use SENS:CORR:CSET:CAT? to list the available Cal Sets in either format.

<bool>

Should the Cal Set stimulus values be applied to the channel. Choose from:

ON (1)   Apply the Cal Set stimulus values to the channel.

OFF (0)  Do NOT apply the Cal Set stimulus values. If the Cal Set stimulus values do not match the channel stimulus values, then the following will occur:

• If interpolation is ON, then interpolation will be attempted. This may fail if the channel frequency is outside the range of the Cal Set.

• If interpolation is OFF, the selection will be abandoned and an error is returned:

Examples

SENS:CORR:CSET:ACT "My2Port",1

sense:correction:cset:activate? name
'returns
"My2Port"

Query Syntax

SENSe<cnum>:CORRection:CSET:ACTivate? [GUID|NAME]

Returns the name of the Cal Set that is applied to the specified channel. Choose from GUID or NAME to specify which string is returned. If unspecified, the GUID of the Cal Set is returned. If no Cal Set is applied to the specified channel, then "No Calset Selected" is returned.

Return Type

String

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

This command is replaced by CSET:CAT?

(Read-only) Returns a list of Cal Sets.

Parameters

<char>

Optional argument. The list is returned in one of the following formats. Both return comma-separated string lists.

GUID  Cal Sets are listed by GUID (Default if unspecified).

NAME  Cal Sets are listed by Name

Examples

SENS:CORR:CSET:CAT?

'Returns:
{FD6F863E-9719-11d5-8D6C-00108334AE96},{1B03B2CE-971A-11d5-8D6C-00108334AE96}

sense2:correction:cset:catalog? name

Default

Not Applicable

Applicable Models: All

(Write-only) Creates a new Cal Set and copies the current Cal Set data into it.  Use this command to manipulate data on a Cal Set without corrupting the original cal data.

Parameters

<cnum>

Channel number using the Cal Set to be copied. If unspecified, value is set to 1

<string>

Name of the new Cal Set.

Examples

SENS2:CORR:CSET:COPY 'My2Port'

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Creates an empty Cal Set and attaches it to the specified channel. This command is ONLY necessary before remotely filling the Cal Set with error term data. (For Advanced Users).

A Cal Set is automatically created, applied to the channel, and saved at the completion of a guided cal according to the preference setting SENS:CORR:PREF:CSET:SAVE.

Parameters

<cnum>

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

[name]

Optional argument. Name of the Cal Set. Spaces or punctuation are NOT allowed. If unspecified, a unique name is chosen in the form "Calset_N" where N is a unique number.

Examples

SENS:CORR:CSET:CRE 'My2Port'

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Write-only) Creates a unity Cal Set useful for debugging or to quickly test a prototype of automation software.

Parameters

<cnum>

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

[<csetname>]

Optional argument. Name of the Cal Set. Spaces or punctuation are NOT allowed. If unspecified, a unique name is chosen in the form "Calset_N" where N is a unique number.

[<correctiontype>]

Optional argument. Specifies the correction type to use as the default. Use the SENSe:CORRection:TYPE:CATalog? command for a list of correction types.

Examples

'This example applies 2-port error correction as if the system were perfect.
'All error terms will be 1 or 0.
SENS:CORR:CSET:CRE:DEF 'My2Port', 'Full 2P(1,2)'

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-Write)  Read or Write a specific error term from/to the Cal Set currently attached to the specified channel. (For Advanced Users).  The command can be used only for the error terms listed. See SENS:CORR:CSET:ETERM to get and put error term data using a string argument for all error terms.

Parameters

<cnum>

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

<eterm, portA, portB>

Error Term, Port pair of the specified error term.

Although not all error terms use two port numbers, two are required by the VNA in all cases. Each port number must be between 1 and the number of ports on the VNA.

EDIR -  directivity

portA: the port at which directivity is measured.

portB: Not used, but must be a valid VNA port number.

ESRM - source match

portA: the port at which source match is measured.

portB: Not used, but must be a valid VNA port number.

ERFT - reflection tracking

portA: the port at which reflection tracking is measured.

portB: Not used, but must be a valid VNA port number.

ELDM - load match

portA: the port at which load match is measured.

portB: the source port.

Load match is measured with a cable connected between the measured port (portA) and the source port (portB).

The cal system requires that the complete matrix of loadmatch arrays be filled.  In most cases you can measure loadmatch once at a port, driven by any other port.  Then use that data for all variations of the receive port. (The exception is the 3-port VNA models, which requires the loadmatch-measured port to be driven by every other port.)

For example: Measure the loadmatch at port2 while driving port1. Then upload this same data to the following arrays:

        ELDM,2,1,<data>

        ELDM,2,3,<data>

        ELDM,2,4,<data>

ETRT -  transmission tracking

portA: the receive port

portB: the source port for this measurement

EXTLK - crosstalk

portA: the receive port

portB: the source port for this measurement

ERSPT - response tracking.

portA: Not used, but must be a valid VNA port number.

portB: Not used, but must be a valid VNA port number.

ERSPI - response isolation.

portA: Not used, but must be a valid VNA port number.

portB: Not used, but must be a valid VNA port number.

<rec>

<string> - Specify the VNA receiver for which the Eterm applies.

Required ONLY when Eterm is response tracking (ERSPT) or response isolation (ERSPI).

Logical receiver notation is allowed.

A full 4-port calibration requires the following terms be uploaded:

Reflection terms

Transmission terms

<block>

(Block). Error term data. A Real / Imaginary data pair for each data point.

Format is set using FORM:DATA command.

For REAL binary formats, refer to Getting Data from the Analyzer using SCPI

Example

'Set the directivity term with a cal set using 5 points

SENS1:CORR:CSET:DATA EDIR, 1, 1, +6.12569600000E-002,-7.27163800000E-003,-3.63812000000E-003,+1.33521800000E-002,-4.36775100000E-003,+1.87792400000E-002,-4.09239100000E-003,+4.24291200000E-002,-2.03784900000E-002,+3.21425100000E-002"

Query Syntax

SENSe<cnum>:CORRection:CSET:DATA? <eterm,portA, portB>,<rec>

Query Examples

'Read the response isolation eterms for the port 1 reference receiver

sens:corr:cset:data? ERSPI,1,1,’R1’

'Same receiver using logical receiver notation

sens:corr:cset:data? ERSPI,1,1,’a1’

Return Type

Block data

Default

Not Applicable

Applicable Models: All

(Write-only) Unselects a Cal Set from the specified channel.

Parameters

<cnum>

Channel number to have Cal Set unselected.

Examples

SENS:CORR:CSET:DEAC

sense2:correction:cset:deactivate

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

This command is replaced by CSET:DEL.

(Write-only)Deletes a Cal Set from the set of available Cal Sets.  This method immediately updates the Cal Set file on the hard drive. If the Cal Set is currently being used by a channel or does not exist, this request will be denied and an error is returned.

Parameters

<string>

Cal Set to be deleted. Specify the Cal Set by GUID or Name. Use SENS:CORR:CSET:CAT? to list the available Cal Sets in either format.

Examples

SENS:CORR:CSET:DEL '{2B893E7A-971A-11d5-8D6C-00108334AE96}'
sense2:correction:cset:delete 'MyCalSet'

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: All

(Read-Write) Sets or returns the descriptive string assigned to the selected Cal Set. Change this string so that you can easily identify each Cal Set. Apply and select the Cal Set using SENS:CORR:CSET:ACT.

Parameters

<cnum>

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

<string>

The descriptive string associated with the currently-selected Cal Set

Examples

SENS:CORR:CSET:DESC 'MyCalSet'
sense2:correction:cset:description 'thisCalSet'

Query Syntax

SENSe<cnum>:CORRection:CSET:DESCription?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-Write) Sets or returns error term data for all VNA measurements.

Parameters

<cnum>

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

<string>

(String) Error term to read or write. The error term is specified using the EXACT case-sensitive string displayed in the Cal Set Viewer utility.  See SENS:CORR:CSET:DATA for a description of port numbers.

The following Noise figure error terms are listed for convenience:

• RcvNoiseCorr_m_n  Noise correlation matrix of the noise receiver (a 2x2 complex matrix). The row and column indices m and n range from 1 to 2.

• RcvT_m_n   T-matrix of the noise receiver (a 2x2 complex matrix). The row and column indices m and n range from 1 to 2.

• GammaTuner_n  Reflection coefficient for impedance state n of the embedded noise tuner (Ecal module) in the port 1 source path. For the Keysight 4691 family of Ecal modules, n can range from 1 to 7.

<data>

(Block) Error term data. A Real / Imaginary data pair for each data point.

Format is set using FORM:DATA command.

For REAL binary formats, refer to Getting Data from the Analyzer using SCPI

Examples

SENS:CORR:CSET:ETERM "Directivity(1,1)", 0.237,-1.422, 0.513, 0.895  ' set directivity(source error term for 2 points
SENS:CORR:CSET:ETERM? "Directivity(1,1)"  'read

Query Syntax

SENSe<cnum>:CORRection:CSET:ETERm[:DATA]? <string>

Return Type

Block data

Default

Not Applicable

Applicable Models: All

(Read-only) Returns a list of error term names found in the current Cal Set that is applied to the specified channel.

Parameters

Examples

SENS:CORR:CSET:ETER:CAT?

'For a 1-port cal, returns

"Directivity(1,1),ReflectionTracking(1,1),SourceMatch(1,1)"

Return Type

String

Default

Not Applicable

Applicable Models: All

(Write-only)  When a Cal Set that was produced by a calibration has been interpolated or otherwise modified (for example, by Fixturing operations) this command saves the modified Cal Set to the VNA hard drive so that it can be reused. There is no User Interface equivalent for this command.

Background

When a Cal Set is selected for use by a channel, the channel reads the Cal Set from disk (master Cal Set). If the channel aligns perfectly with the Cal Set, the master Cal Set is used directly. In this case, the active Cal Set is the master Cal Set.

When processing occurs on the error terms due to interpolation or modification due to the use of fixturing, the channel will generate a temporary "memory-resident" Cal Set.  In this case, the active Cal Set is the memory-resident Cal Set. This FLATten command allows you to save the active Cal Set to disk.

Depending on the measurement conditions, this flattening of the Cal Set can improve performance, especially if the Cal Set is applied often (using multiple recall states) or used by many channels.  Flattening a version of the Cal Set for each channel can avoid the interpolation or the fixturing processing that would otherwise occur when the Cal Set is selected or the instrument state is recalled.  

You will have to manage the application of such a Cal Set as the VNA itself will have no way to determine what processing had been done once the flatten command is used.  For example, if fixture de-embedding occurred prior to the flatten command, that Cal Set should then be applied WITHOUT fixturing on, because fixturing is already embedded in that Cal Set.  It is your responsibility to apply the Cal Set properly.

If you want to repeatedly de-embed multiple networks (i.e. concatenate multiple 2-port de-embedding files) you can use the flatten command to create a new master Cal Set after each de-embed, and sequentially add additional de-embed networks.

Parameters

<cnum>

Channel number on which the modified Cal Set resides. If unspecified, value is set to 1

<string>

Name of the new Cal Set. Spaces or punctuation NOT allowed.

Examples

SENS:CORR:CSET:FLAT "MyCalSet"

Query Syntax

Not Applicable

Default

Not Applicable

Applicable Models: M937xA, P937xA

This command converts the selected Cal Set from an S-parameter Cal Set to an S-parameter+Power Cal Set. This command requires a Cal Set to be selected.

There are 2 modes for using this command:

Mode 1:

The <receiverName> is optional. If not specified, then ResponseTracking(a1) is set to 0, and the rest of ResponseTracking() terms are computed to be consistent with the S-parameter calibration terms.

Mode 2:

Use this pattern when there is already a receiver calibration for one of the receivers. In that case, this command can be used to transfer the receiver calibration to the other receivers.

If <receiverName> is specified, it must be either 'a1','a2','a3', etc or 'b1','b2','b3'. The ResponseTracking term for this receiver must already be added to the Cal Set, or else this command will generate an error. This command will then compute the ResponseTracking() terms for all of the other receivers in a manner consistent with the S-parameter calibration terms.

Parameters

<cnum>

Channel number on which the modified Cal Set resides. If unspecified, value is set to 1.

<receiverName>

Name of the receiver ('a1', 'a2', 'a3', etc., or 'b1', 'b2', 'b3', etc.)

Examples

SENS:CORR:CSET:GEN:REC 'a1'

Query Syntax

SENSe<cnum>:CORRection:CSET:GENerate:RECeiver?

Default

Not Applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

This command is replaced by SENS:CORR:CSET:ACTivate.

(Read-Write) Selects the Cal Set identified by the string parameter (GUID) and applies it to the specified channel.

• A Cal Set cannot be selected for a channel which is not ON.

• If the stimulus settings of the selected Cal Set differ from those of the selected channel, the instrument will automatically change the channel's settings to match the Cal Set.

Parameters

<cnum>

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

<string>

GUID of the desired Cal Set. The curly brackets and hyphens must be included.

Examples

SENS:CORR:CSET:GUID '{2B893E7A-971A-11d5-8D6C-00108334AE96}'
sense2:correction:cset:guid '{2B893E7A-971A-11d5-8D6C-00108334AE96}'

Query Syntax

SENSe<cnum>:CORRection:CSET:GUID?

Returns the GUID of the currently-selected Cal Set for the specified channel.

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Returns a list of all name-value pairs (items) in the Cal Set.

Parameters

Examples

SENS:CORR:CSET:ITEM:CAT?

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-Write) Read the value of the Cal Set item. The Cal Set item is added by the VNA firmware to every Cal Set.

About Cal Set Items

A Cal Set item is a named value. You can list the named values using CSET:ITEM:CATalog? or SENS:CORR:CSET:ITEM:CATalog?

You can query the value of a specific item by asking for its data:  CSET:ITEM:DATA?

CSET:ITEM:DATA? "mycalset","Created By"

Parameters

<cnum>

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

<itemName>

(String) Item added by the VNA firmware to every Cal Set named 'Created By'.

Examples

SENS:CORR:CSET:ITEM? "Created By"

"Standard" 'Example returned value indicating Cal Set created in a "Standard" channel.

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-Write) Sets or queries the name of the Cal Set currently applied to the specified channel.

Parameters

<cnum>

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

<string>

Name of the Cal Set. Spaces or punctuation NOT allowed.

Examples

SENS:CORR:CSET:NAME 'MyCalSet'
sense2:correction:cset:name 'thisCalSet'

Query Syntax

SENSe<cnum>:CORRection:CSET:NAME?

Return Type

String

Default

Not Applicable

Applicable Models: All

This command is NOT necessary after completion of a calibration. A Cal Set is automatically created, applied to the channel, and saved at the completion of a guided cal according to the preference setting SENS:CORR:PREF:CSET:SAVE.

(Read Write)

Saves the channel's Cal Set to the VNA hard drive. For example, use this command after writing data to a Cal Set using SENS:CORR:CSET:DATA (For Advanced Users).

The file name is saved as "CSETx.cst" where x is the user number assigned to <char>, and .cst specifies a Cal Set and instrument state. This is not the same syntax as a file saved through the default choices from the front panel, which is "at00x.cst". For more information on the file naming syntax, see the MMEMory subsystem. Learn more about Instrument/Cal States.

Parameters

<cnum>

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

[<char>]

Optional argument. Choose from:

USER01

USER02...

and so forth, until...

USER10

If <char> is NOT specified, changes that may have been made are saved to the cal set and NOT to the *cst file.

Examples

SENS:CORR:CSET:SAVE USER03
sense2:correction:cset:save user09

'save changes to only the cal set

SENS:CORR:CSET:SAVE

Query Syntax

SENSe<cnum>:CORRection:CSET:SAVE?

Queries the last correction set saved.

Return Type

Character

Default

Not applicable

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

This command is replaced by MMEM:LOAD

(Read-Write) Recalls a *.cst file from memory. The file name is "CSETx.cst" where x is the user number assigned to <char>. Learn more about .cst files

For more information on the file naming syntax, see the MMEMory subsystem.

Note: This command does NOT select a Cal Set for a channel. To select a Cal Set, use SENS:CORR:CSET:ACTivate

Parameters

<cnum>

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

<char>

Choose from:
DEF - Presets the analyzer

USER01 - Restores User01 calibration data

USER02 - Restores User02 calibration data

 through...

USER10 - Restores User10 calibration data

Examples

SENS:CORR:CSET DEF
sense2:correction:cset:select user02

Query Syntax

SENSe<cnum>:CORRection:CSET[:SELect]?

Return Type

Character

Default

DEF

Applicable Models: All

(Read-Write) Sets or returns standard data.  Standard data is available for Unguided Cals ONLY.

Note: The “Standards data” container in the calset is intended for internal use only.  External access is provided for use in diagnosing calibration problems.  Users should not form any expectations as to the presence of the data or the naming conventions used.

Parameters

<cnum>

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

<string>

(String) Cal standard to read or write. The standard is specified using the EXACT case-sensitive string displayed in the Cal Set Viewer utility.  See SENS:CORR:CSET:DATA for a description of port numbers.

<data>

(Block). Acquisition data. A Real / Imaginary data pair for each data point.

Format is set using FORM:DATA command.

For REAL binary formats, refer to Getting Data from the Analyzer using SCPI

Examples

SENS:CORR:CSET:STAN 'S11C(1,1), 0.237,-1.422, 0.513, 0.895  ' Set acquisition data for two points.

SENS:CORR:CSET:STAN? "S11C(1,1)"  'Read data

Query Syntax

SENSe<cnum>:CORRection:CSET:STANdard? (string)

Return Type

Block data

Default

Not Applicable

Applicable Models: All

(Read-only) Returns the source or response stimulus values for the Cal Set that is currently used by channel <ch>. Values are returned in the format specified by FORM:DATA  (Block or ASCII).

Parameters

<ch>

Channel number to query Cal Set stimulus values. If unspecified, value is set to 1

[num]

Optional argument.  Range of frequencies to return. These values would be different when FOM (Opt S93080A) is enabled.

0 - returns source frequencies. Default setting if not specified.

1 - returns response frequencies.

2 - returns primary frequencies.

Examples

SENS:CORR:CSET:STIM?

sense:correction:cset:stimulus 1

Return Type

Numeric

Default

Not Applicable

Applicable Models: All

(Read-only) Reads the port mapping used for the specified Cal Set. The returned values are the physical ports. The POSITION of the returned values corresponds to the logical ports.

For example, with an N44xx test set, if the returned string is "PNA 1,TS 2,PNA 2, TS 4" this means:

• VNA 1 is assigned to logical port 1

• TS 2 is assigned to logical port 2

• VNA 2 is assigned to logical port 3

• TS 4 is assigned to logical port 4

Parameters

 <cset>

(String) Name or GUID of the Cal Set. Use SENS:CORR:CSET:CAT? to read the list of available Cal Set names or GUIDs.

Examples

SENS:CORR:CSET:TSET:ALLP? "MyCalSet"
sens:correction:cset:tset:allports? "{2B893E7A-971A-11d5-8D6C-00108334AE96}"

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Reads the test set type (model) used for the specified Cal Set.

Parameters

 <cset>

(String) Name or GUID of the Cal Set. Use SENS:CORR:CSET:CAT? to read the list of available Cal Set names or GUIDs.

Examples

SENS:CORR:CSET:TSET:TYPE? "MyCalSet"

'returns "N44xx"

sens:correction:cset:tset:type? "{2B893E7A-971A-11d5-8D6C-00108334AE96}"

Return Type

String

Default

Not Applicable

Applicable Models: All

(Read-only) Query the Cal Types available in the selected Cal Set. The output is a comma separated list of Guids or a Cal Type names. Learn more about applying Cal Types using SCPI.

Use CALC:MEAS:CORR:TYPE to apply a Cal Type.

Parameters

<ch>

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

[format]

(Optional) Format of the output of cal types. choose from:

NAME - (default) returns a list of cal type string names.

GUID - returns a list of cal type GUIDs

Examples

SENS:CORR:CSET:TYPE:CAT? NAME

SENS2:CORRection:CSET:TYPE:CAT?

Return Type

String

Default

Not Applicable