Sense:Correction:Cset Commands

SENSe:CORRection:CSET

ACTivate

COPY

CREate

DEACtivate

DESCription

ETERm

     | CATalog?

     | [DATA]

FLATten

NAME

SAVE

STANdard

STIMulus?

TSET

     | ALLPorts?

     | TYPE?

TYPE

     | CATalog?

(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

(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

(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

This command is replaced by CSET:DEAC.

(Write-only)Clears the calibration error when the frequency offset feature is set to OFF for the selected channel.

Parameters

<string>

Clears calibration error.

Examples

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

Query Syntax

Not Applicable

Default

Not Applicable

(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

(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:ETER:CAT? for string.  

<r,i>

(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

(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

(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

(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

(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

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

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

(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 080) 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

(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 "VNA 1,TS 2,VNA 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

(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

(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: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

16-Mar-2015

Initial Release