Sense Correction SCPI

M9370A / M9371A / M9372A / M9374A / M9375A

Sense:Correction Commands


Performs and applies calibration and other error correction features.

SENSe:CORRection

CCHeck

     | [ACQuire]

     | DONE

     | PARameter

CKIT - More Commands

COLLect

     | [ACQuire]

     | APPLy

     | CKIT - More Commands

     | DISPlay:WINDow

          | AOFF

          | [STATe]

     | GUIDed - More Commands

     | ISOLation:

| AVER:INCRement

          | ECAL:[:STATe]

     | METHod

     | NOISe

| ENR:ADAP:DEEMbed[:STATe]

| LO:PCAL[:STATe]

| PSEN:ADAP:DEEMbed[:STATe]

     | SAVE

     | SESSion - More Commands

     | SWEep:CHANnel

          | AOFF

          | [STATe]

CSET - More Commands

ENR:CALibration:TABLe

     | DATA

     | ID:DATA

     | SERial:DATA

EXTension - More Commands

GCSetup

     | POWer

     | SENSor:

          | CKIT

          | CONNector

IMD - More Commands

IMPedance:INPut

     | MAGNitude

INTerpolate[:STATe]

ISOLation[:STATe]

METHods:MATCh

PREFerence

     | CALibration

          | [FOM:]RANGe

     | CSET

          | SAVE

          | SAVUser

     | ECAL

          | ORIentation

          | OVERrange[:STATe]

          | PMAP

     | SIMCal

     | TRIG:FREE

RPOWer:OFFSet

     | [AMPLitude]

RVELocity

     | COAX

SFOWard

     | [STATe]

[STATe]

TCOLd:USER:VALue

TSTandards

     | [STATe]

TYPE

     | CATalog?

Click on a keyword to view the command details.

Blue commands are superseded.

See Also


SENSe<cnum>:CORRection:CCHeck[:ACQuire] <mod>[,char]

(Write-only) Reads the 'confidence data' associated with the specified ECal module and puts it into memory. The measurement is selected using SENS:CORR:CCH:PAR.  This command is compatible with *OPC.

Note: A confidence check can NOT be performed remotely from User Characterizations that are stored on the PNA disk.

Parameters

 

<cnum>

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

<mod>

ECAL Module that contains the confidence data. Choose from:

ECAL1

..through..

ECAL50

[char]

Optional argument.  Specifies which characterization within the ECal module that the confidence data will be read from.

CHAR0   Factory characterization (data that was stored in the ECal module by Keysight). Default if not specified.

CHAR1   User characterization #1

CHAR2   User characterization #2

...and so forth up to:

CHAR12   User characterization #12

Examples

SENS:CORR:CCHeck ECAL2

sense2:correction:ccheck:acquire ecal1,char1

Query Syntax

Not applicable

Default

Not applicable


SENSe<cnum>:CORRection:CCHeck:DONE

(Write-only) Concludes the Confidence Check and sets the ECal module back into the idle state.

Parameters

 

<cnum>

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

Examples

SENS:CORR:CCH:DONE sense2:correction:ccheck:done

Query Syntax

Not applicable

Default

Not applicable


SENSe<cnum>:CORRection:CCHeck:PARameter <Mname>

(Read-Write) Specifies an existing measurement to be used for the Confidence Check.

Note: A confidence check can NOT be performed remotely from User Characterizations that are stored on the PNA disk.

Parameters

 

<cnum>

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

<Mname>

Name of the measurement you are selecting for the confidence check. The measurement must already exist.

Examples

SENS:CORR:CCH:PAR 'TEST'
'selects the measurement "test" on channel 1 for the confidence check

sense2:correction:ccheck:parameter 'test'
'selects the measurement "test" on channel 2 for the confidence check

Query Syntax

SENSe<cnum>:CORRection:CCHeck:PARameter?

Returns the name of the selected measurement on channel <cnum>.

Return Type

String

Default

Not applicable


SENSe<cnum>:CORRection:COLLect[:ACQuire] <class>[,subclass][,sync]

(Write-only) For UNGUIDED calibration, measures the specified standards from the selected calibration kit. The calibration kit is selected using the Sense:Correction:Collect:CKIT command.

For using two sets of standards, see SENS:CORR:TST.

Note: Before using this command you must select two items:
1. Select a calibration method using SENS:CORR:COLL:METH
2. Select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<cnum>

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

<class>

Measures the standards associated with these class labels. Choose from:

 

Label

SOLT

(Forward)

SOLT

(Reverse)

TRL

 

STAN1

SA

SA

TRL "R"

 

STAN2

SB

SB

N/A

 

STAN3

SC

SC

TRL "L"

 

STAN4

FWD TRANS

REV TRANS

TRL "T"

 

STAN5

Generic Isolation; not associated with calibration kit definition.

 

ECAL1

through

ECAL50

ECAL modules

 

RESPonse

Same as Normalize selection in Unguided Cal. (subclass is ignored)

 

POWer

Take a receiver power cal sweep and turn correction ON

 

SLSET

Sets 'sliding load type', and increments the "number of slides" count. The total number of slides is critical to the correct calculation of the sliding load algorithm. See a sliding load cal example.

 

SLDONE

Computes the sliding load using a circle fit algorithm.

[subclass]

Optional argument. For mechanical calibration kits, choose from the following to specify the standard to be acquired from the SENS:CORR:COLL:CKIT:ORDer list. If not specified, subclass is set to SST1.

 

SST1

First standard in the order list

 

SST2

Second standard in the order list

 

SST3

Third standard in the order list

 

SST4

Fourth standard in the order list

 

SST5

Fifth standard in the order list

 

SST6

Sixth standard in the order list

 

SST7

Seventh standard in the order list

 

If an ECAL module (1 through 8) is specified for <class>, choose one of the following for specifying which characterization within the ECal module will be used for the acquire.  If not specified, the default is CHAR0.

 

CHAR0

Factory characterization (data that was stored in the ECal module by Keysight)

 

CHAR1

User characterization #1

 

CHAR2

User characterization #2

 

...and so forth up to:

 

CHAR12

User characterization #12

[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 STAN1
 

'If SENS:CORR:COLL:CKIT:ORDer2 5,3,7
was specified, the following command measures standard 3 (the second in the order list)
sense1:correction:collect:acquire stan3,sst2

SENS:CORR:COLL ECAL4,ASYN; *OPC?

sense2:correction:collect:acquire ecal2,char1

Query Syntax

Not applicable

Default

Not applicable


SENSe<cnum>:CORRection:COLLect:APPLy

(Write-only) Applies error terms to the measurement that is selected using Calc:Par:Select.

Note: Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Note: This command is only necessary if you need to modify error terms. If you do not need to modify error terms, SENSe<cnum>:CORRection:COLLect:SAVE calculates and then automatically applies error terms after you use SENS:CORR:COLL:ACQuire to measure cal standards.

Parameters

 

<cnum>

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

Example

  1. CALCulate2:PARameter:SELect S21_2 'select the measurement to apply terms to

  2. SENSe2:CORRection:COLLect:METHod SPARSOLT 'set type of cal method.

  3. CALCulate2:DATA? SCORR1 'download the error term of interest

  4. 'Modify the error term here

  5. CALCulate2:DATA SCORR1 'upload the error term of interest

  6. SENSe2:CORRection:COLLect:APPLy 'applies the error terms to the measurement

Query Syntax

Not applicable

Default

Not applicable


SENSe:CORRection:COLLect:DISPlay:WINDow:AOFF

(Write-only) Clears the flags for windows to be shown during calibrations.  To flag a window to be shown see SENS:CORR:COLL:DISP:WIND.

Examples

SENS:CORR:COLL:DISP:WIND:AOFF

sense:correction:collect:display:window:aoff

See an example using this command.

Query Syntax

Not Applicable

Default

Not Applicable


SENSe:CORRection:COLLect:DISPlay:WINDow<wNum>[:STATe] <bool>

(Write-only) Set the 'show' state of the window to be displayed during a calibration to view the measurements/channels.  Learn more.

When this command is sent, the specified window is 'flagged' to be shown during calibration.  The flag is cleared when the window is closed. A Preset or Instrument State Recall also closes the window. If the same window number is reopened, this command must be sent again to show the window during a calibration.  The flag is NOT saved with an instrument state.

Send this command for each additional window to show during a calibration.

Parameters

 

<wNum>

Window number to show during a calibration. The calibration window will also be shown with this window.

The window must already be created.

Use DISPlay:CATalog? to read all existing window numbers.

<bool>

Window state. Choose from:

ON (or 1) - Show the specified window during calibration.

OFF (or 0) - Do NOT show the specified window during calibration.

Examples

SENS:CORR:COLL:DISP:WIND1 1

sense:correction:collect:display:window2:state off

See an example using this command.

Query Syntax

Not Applicable

Default

OFF


SENSe:CORRection:COLLect:ISOLation:AVERage:INCRement <num>

(Read-Write) Specifies amount to increment (increase) the channel averaging factor during isolation measurement of the ECal module during an unguided ECal calibration.

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

Parameters

 

<num>

Incremental Averaging factor. The maximum averaging factor is 65536 (2^16).

Examples

SENS:CORR:COLL:ISOL:AVER:INCR 16

sense:correction:collect:isolation:average:increment 0

Query Syntax

SENSe:CORRection:COLLect:ISOLation:AVERage:INCRement?

Return Type

Numeric

Default

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


SENSe<cnum>:CORRection:COLLect:ISOLation:ECAL[:STATe] <bool>

(Read-Write) Specifies whether or not the isolation state of the ECal module will be measured as part of an unguided ECal calibration.

An unguided calibration is performed using the SENS:CORR:COLL:METH and SENS:CORR:COLL:ACQ commands.

Note: The inherent isolation of the PNA is better than that attained with this command. ONLY use this command when using an external test set, and ONLY using a 8509x ECal module.

Parameters

 

<cnum>

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

<bool>

ON (or 1) - isolation is measured during the unguided ECal calibration.

OFF (or 0) isolation is NOT measured during the unguided ECal calibration.

Examples

SENS1:CORR:COLL:ISOL:ECAL ON

sense2:correction:collect:isolation:ecal:state 0

Query Syntax

SENSe:CORRection:COLLect:ISOLation:ECAL:STATe?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF


SENSe<cnum>:CORRection:COLLect:METHod <char>

(Read-Write) For UNGUIDED calibration, sets the calibration method (also known as 'Calibration Type' on calibration dialog box.) To select a Cal Type from a Cal Set, use CALC:CORR:TYPE.

Note: Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<cnum>

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

<char>

Choose from:

 

Method

Description

 

NONE

No Cal method

 

REFL1OPEN

Response Open

 

 REFL1SHORT or REFL1

Response Short

 

REFL3

Full 1 port

 

RESPonse

Same as Normalize selection in Unguided Cal.

 

RPOWer

Receiver Power Cal - Used only with receiver measurements.

 

TRAN1

Response Thru - Requires a Thru standard.

 

TRAN2

Response Thru and Isolation - Requires a Thru standard.

 

SPARSOLT

Full SOLT 2 port

 

SPARSOLT3

Full SOLT 3 port

 

SPARTRL

TRL Cal (Delta Match Cal may be required)

Examples

SENS:CORR:COLL:METH REFL1
sense2:correction:collect:method sparsolt

Query Syntax

SENSe<cnum>:CORRection:COLLect:METHod?

Return Type

Character

Default

Not Applicable


SENSe<ch>:CORRection:COLLect:NOISe:ENR:ADAPter:DEEMbed:[STATe] <bool>

(Read-Write) Set and read the state of ENR Adapter de-embedding. Learn more.

Parameters

 

<ch>

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

<bool>

ENR Adapter de-embed state. Choose from:

OFF or 0 - Do not force de-embedding.

ON or 1 - Force de-embedding.

Examples

SENS:CORR:COLL:NOIS:ENR:ADAP:DEEM 0

sense2:correction:collect:noise:enr:adapter:deembed:state ON

Query Syntax

SENSe:CORRection:COLLect:NOISe:ENR:ADAPter:DEEMbed:[STATe]?

Return Type

Boolean

Default

O - OFF


SENSe<ch>:CORRection:COLLect:NOISe:LO<n>:PCAL[:STATe] <bool>

(Read-Write) Enables and disables LO power calibration for NFX.

Parameters

 

<ch>

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

<n>

LO Stage (number). Choose 1 for NFX.

<bool>

LO Power Cal state. Choose from:

OFF or 0 - Disable LO Power Cal

ON or 1 - Enable LO Power Cal

Examples

SENS:CORR:COLL:NOIS:LO1:PCAL 0

sense2:correction:collect:noise:lo1:pcal:state ON

Query Syntax

SENSe:CORRection:COLLect:NOISe:LO<n>:PCAL:STATe?

Return Type

Boolean

Default

O - OFF


SENSe<ch>:CORRection:COLLect:NOISe:PSENsor:ADAPter:DEEMbed:[STATe] <bool>

(Read-Write) Set and read the state of power sensor adapter de-embedding. Learn more.

Parameters

 

<ch>

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

<bool>

Power sensor adapter de-embed state. Choose from:

OFF or 0 - Do not force de-embedding.

ON or 1 - Force de-embedding.

Examples

SENS:CORR:COLL:NOIS:PSEN:ADAP:DEEM 0

sense2:correction:collect:noise:psensor:adapter:deembed:state ON

Query Syntax

SENSe:CORRection:COLLect:NOISe:PSENsor:ADAPter:DEEMbed:[STATe]?

Return Type

Boolean

Default

O - OFF


SENSe<cnum>:CORRection:COLLect:SAVE

(Write-only) For UNGUIDED calibrations ONLY. This command does the following:

  • calculates the error terms using the selected :METHod

  • applies the error terms to the selected measurement (turns error correction ON.)

  • saves the calibration error-terms to the channels Cal Register or a User Cal Set.

The Cal Register or User Cal Set is determined by the setting of the SENS:CORR:PREFerence:CSET:SAVE command.

 

Do NOT use this command during an ECAL.  When performing an ECAL calibration using SENS:CORR:COLL:ACQuire, this SAVE operation is performed automatically before the completion of a successful ACQuire.

Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<cnum>

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

Examples

SENS:CORR:COLL:SAVE
sense2:correction:collect:save

Query Syntax

Not applicable

Default

Not applicable


SENSe:CORRection:COLLect:SWEep:CHANnel:AOFF

(Write-only) Clears ALL flags for channels to sweep during calibration. To flag a channel, see SENS:CORR:COLL:SWE:CHAN.

Examples

SENS:CORR:COLL:SWE:CHAN:AOFF

sense:correction:collect:sweep:channel:aoff

See an example using this command.

Default

Not applicable


SENSe<cnum>:CORRection:COLLect:SWEep:CHANnel<cnum2>[:STATe] <bool>

(Write-only) Specifies the channel to sweep during a Calibration.

When this command is sent, the <cnum2> channel is 'flagged' to be swept during calibration.  

The flag is cleared when the channel is deleted, if the Measurement Class is changed, or if all measurements are deleted from the channel.

If the same channel number is recreated, this command must be sent again to sweep the channel during a calibration.  The flag is NOT saved with an instrument state.

A Preset or Instrument State Recall deletes the channel.

Parameters

 

<cnum>

The channel to be calibrated.  If unspecified, value is set to 1.

<cnum2>

The channel to sweep when waiting to measure a standard.

This channel must already exist with at least one measurement in the channel. If this channel is in continuous sweep mode, it must have the same attenuator settings and path configuration (PNA-X only).

<bool>

Channel sweep state. Choose from:

ON (or 1) - Sweep the channel during calibration.

OFF (or 0) - Do NOT sweep the channel during calibration.

Examples

SENS:CORR:COLL:SWE:CHAN2 1

sense2:correction:collect:sweep:channel3:state off

See an example using this command.

Query Syntax

Not Applicable

Default

OFF


SENSe:CORRection:ENR:CALibration:TABLe:DATA <freq, value, freq, value...>

(Read-Write) Set and read the ENR calibration data. All of the frequency and ENR data must be sent at the same time. Use MMEM:LOAD to load, and MMEM:STORE:ENR CAL to save ENR table data from disk. Learn more about Noise Source ENR files.

Parameters

 

<freq, value>

(Numeric) ENR data. Frequency value in Hz followed by a ENR noise value in dB. Enter as many pairs as necessary.

Examples

SENS:CORR:ENR:CAL:TABL:DATA 1.0E9,14.37,2.5E9,15.28
sense:correction:enr:calibration:table:data 1.0E9,14.37,2.5E9,15.28

Query Syntax

SENSe:CORRection:ENR:CALibration:TABLe:DATA?

Return Type

Comma separated numeric values

Default

Not Applicable


SENSe:CORRection:ENR:CALibration:TABLe:ID:DATA <id>

(Read-Write) Sets and returns ID of ENR table. While this is for informational purposes only, it can be used to record the model of the noise source. Learn more about ENR files.

Parameters

 

<id>

(String)  Identifier for the ENR table.

Examples

SENS:CORR:ENR:CAL:TABL:ID:DATA "346C"
sense:correction:enr:calibration:table:id:data "ENR Table"

Query Syntax

SENSe:CORRection:ENR:CALibration:TABLe:ID:DATA?

Return Type

String

Default

Not Applicable


SENSe:CORRection:ENR:CALibration:TABLe:SERial:DATA <sn>

(Read-Write) Sets and returns the serial number of noise source. This is for informational purposes only to identify the specific noise source for which the data pertains. Learn more about ENR files.

Parameters

 

<sn>

Serial number of the noise source for which the data applies, enclosed in quotes.

Examples

SENS:CORR:ENR:CAL:TABL:SER:DATA "ABCD1234"
sense:correction:enr:calibration:table:serial:data "ABCD1234"

Query Syntax

SENSe:CORRection:ENR:CALibration:TABLe:SERial:DATA?

Return Type

String

Default

Not Applicable


SENSe<ch>:CORRection:GCSetup:POWer <num>

(Read-Write) Set and read the power level at which to perform the Source Power Cal portion of a Gain Compression (Opt 086) Calibration.  Learn more about this setting.

Parameters

 

<num>

Power level in dB. Choose a value from +30 to (-30).

Examples

SENS:CORR:GCS:POW 0
sense:correction:gcsetup:power 5

Query Syntax

SENSe:CORRection:GCSetup:POWer?

Return Type

Numeric

Default

0


SENSe<ch>:CORRection:GCSetup:SENSor:CKIT <string>

(Read-Write) Set and read the cal kit to be used for calibrating at the port 1 reference plane when the power sensor connector is different from the DUT port 1.  Learn more.

Parameters

 

<string>

Cal Kit. Use SENS:CORR:COLL:GUID:CKIT:PORT1:CAT? to return a list of valid cal kits.

Examples

SENS:CORR:GCS:SENS:CKIT "85052B"

Query Syntax

SENSe:CORRection:GCSetup:SENSor:CKIT?

Return Type

String

Default

Not Applicable


SENSe<ch>:CORRection:GCSetup:SENSor:CONNector<string>

(Read-Write) Set and read the power sensor connector type which is used to perform the Source Power Cal portion of a Gain Compression Calibration.  Learn more.

Parameters

 

<string>

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

Select "Ignored" to NOT compensate for the adapter.

Examples

SENS:CORR:GCS:SENS:CKIT "3.5 mm (50) male"

Query Syntax

SENSe:CORRection:GCSetup:SENSor:CKIT?

Return Type

String

Default

Not Applicable


SENSe:CORRection:IMPedance:INPut:MAGNitude <num>

(Read-Write) Sets and returns the system impedance value for the analyzer.

Parameters

 

<num>

System Impedance value in ohms. Choose any number between 0 and 1000 ohms.

Examples

SENS:CORR:IMP:INP:MAGN 75
sense:correction:impedance:input:magnitude 50.5

Query Syntax

SENSe:CORRection:IMPedance:INPut:MAGNitude?

Return Type

Numeric

Default

50


SENSe<ch>:CORRection:INTerpolate[:STATe] <ON | OFF>

(Read-Write) Turns correction interpolation ON or OFF.

Note: Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<ch>

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

<ON | OFF>

ON (or 1) - turns interpolation ON.
OFF
(or 0) - turns interpolation OFF.

Examples

SENS:CORR:INT ON
sense2:correction:interpolate:state off

Query Syntax

SENSe<cnum>:CORRection:INTerpolate[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON


SENSe<ch>:CORRection:ISOLation[:STATe] <ON | OFF>   OBSOLETE

This command no longer works beginning in the PNA 5.2 release. The set and query of this command will NOT return an error.

To perform isolation as part of an unguided calibration, you must explicitly measure the isolation standard using SENS:CORR:COLL:ACQ Stan5.

To measure isolation as part of an ECal, use SENS:CORR:COLL:ISOL:ECAL.

(Read-Write) Turns isolation cal ON or OFF during Full 2-port calibration. If this command is not sent, the default state is to disable Isolation.

Parameters

 

<ch>

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

<ON | OFF>

ON (or 1) - turns isolation ON.

OFF (or 0) - turns isolation OFF.

Examples

SENS:CORR:ISOL ON

sense2:correction:isolation:state off

Query Syntax

SENSe<cnum>:CORRection:ISOLation[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF - (Isolation disabled)


SENSe<ch>:CORRection:METHods:MATCh <bool>

(Read-Write) Turns match-correction ON or OFF. Use this command AFTER performing an Guided Power Cal. Learn more.

Parameters

 

<ch>

Channel number on which Guided Power Cal was performed. If unspecified, value is set to 1

<bool>

ON (or 1) - Turns match-correction ON

OFF (or 0) -  Turns match-correction OFF.

Examples

SENS:CORR:METH:MATC 0
sense2:correction:methods:match off

Query Syntax

SENSe<cnum>:CORRection:METHods:MATCh?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON


SENSe:CORRection:PREFerence:CALibration[:FOM]:RANGe <char>

(Read-Write)  Specifies the FOM frequency range to use when performing calibration.

Parameters

 

<char>

Choose from:

PRIMary - Used for calibrating at the mmWave frequencies when NOT using a test set. Learn more.

AUTO - All other calibration situations.

Examples

SENS:CORR:PREF:CAL:RANG PRIM
sense:correction:preference:calibration:fom:range auto

Query Syntax

SENSe:CORRection:PREFerence:CALibration[:FOM]:RANGe?

Return Type

Character

Default

AUTO


SENSe:CORRection:PREFerence:CSET:SAVE <char>

Important Notes:

  • This command replaces SENS:CORR:PREF:CSET:SAVU

  • With 6.0 we implemented a change that defaults to saving completed calibrations to Cal Registers instead of User Cal Sets. To revert to the old behavior, send this command with the USER argument.

(Read-Write)  Specifies the default manner in which calibrations that are performed using SCPI or COM are to be stored. Cal data is ALWAYS stored to the channel Cal Register regardless of this setting.

This setting survives instrument preset and reboot. It remains until changed by another execution of this command.

Note: Cal Set arguments used with commands such as SENS:CORR:COLL:GUID:INIT, SENS:CORR:COLL:GUID:SAVE and SENS:CORR:COLL:GUID:SAVE:CSET will override of any of these default preference settings.

Learn about Cal Registers and User Cal Sets.

Parameters

 

<char>

CALRegister - Each Cal is saved ONLY to the channel Cal Register. If the error terms from a new Cal can co-exist with those in the Cal Register, they are appended.

USER - Each Cal is saved to its own new User Cal Set file. The Cal Set name is automatically generated. To change the name, send SENS:CORR:CSET:NAME after the cal is complete. This reverts to pre-6.0 behavior.

REUSe - The cal is saved to the Cal Set that is currently selected on the specified channel, which could be the channel Cal Register. If the channel does not yet have a selected Cal Set, the cal will be saved to a new User Cal Set with an automatically-generated name. If the error terms from a new Cal can co-exist with those in the Cal Set, they are appended.

Examples

SENS:CORR:PREF:CSET:SAVE USER
sense:correction:preference:cset:save reuse

Query Syntax

SENSe:CORRection:PREFerence:CSET:SAVE?

Return Type

Character

Default

CALRegister


SENSe:CORRection:PREFerence:CSET:SAVUser <bool> Superseded

This command is replace with SENS:CORR:PREF:CSET:SAVE

NOTE: With 6.0 we implemented a change that defaults to saving completed calibrations to Cal Registers instead of User Cal Sets. To revert to the old behavior, send this command as ON (1). For UI and COM use, this can be done from the GPIB console.

(Read-Write)  Specifies whether cal data is automatically saved to a User Cal Set file after performing a SCPI calibration. Cal data is always saved to a Cal Register regardless of this setting.

This setting survives instrument preset and reboot. It remains until changed by another execution of this command.

Learn about Cal Registers and User Cal Sets.

Parameters

 

<bool>

ON or 1 - Cal is automatically saved to a User Cal Set file when performing a SCPI calibration. The Cal Set name is automatically generated. To change the name, send SENS:CORR:CSET:NAME after the cal is complete. Reverts to pre-6.0 behavior.

OFF or 0 - Cal is NOT automatically saved to a User Cal Set. To save a calibration to a User Cal Set, use SENS:CORR:COLL:GUID:INIT.

Examples

SENS:CORR:PREF:CSET:SAVU 1
sense:correction:preference:cset:savuser 0

Query Syntax

SENSe:CORRection:PREFerence:CSET:SAVUser?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF (0)


SENSe:CORRection:PREFerence:ECAL:ORIentation[:STATe] <ON|OFF>

(Read-Write)  Specifies whether or not the PNA should perform orientation of the ECal module during calibration.  Orientation is a technique by which the PNA automatically determines which ports of the module are connected to which ports of the PNA.  Orientation begins to fail at very low power levels or if there is much attenuation in the path between the PNA and the ECal module.  If orientation is turned OFF, the SENS:CORR:PREF:ECAL:PMAP command must be used to specify the port connections before performing a cal.  

Note: For 3-port or 4-port measurements, when orientation is OFF, you are not allowed to specify how the ECAL module is connected. Instead, the PNA determines the orientation. Use SENS:CORR:COLL:GUID:DESC? to query the orientation. The PNA does not verify that you made the connection properly.

This setting remains until the PNA is restarted or this command is sent again.

Parameters

 

<bool>

 ECAL orientation state. Choose from:

ON or 1 - PNA performs orientation of the ECal module.

OFF or 0 - PNA does NOT performs orientation of the ECal module.

Examples

SENS:CORR:PREF:ECAL:ORI OFF

sense:correction:preference:ecal:orientation:state on

Query Syntax

SENSe:CORRection:PREFerence:ECAL:ORIentation[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON (1)


SENSe:CORRection:PREFerence:ECAL:OVERrange[:STATe] <ON|OFF>

(Read-Write)  Sets and returns the ECAL over range state.

Parameters

 

<bool>

 ECAL over range state. Choose from:

ON or 1 - Enable ECAL over range.

OFF or 0 - Disable ECAL over range.

Examples

SENS:CORR:PREF:ECAL:OVER OFF

sense:correction:preference:ecal:overrange:state on

Query Syntax

SENSe:CORRection:PREFerence:ECAL:OVERrange[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON (1)


SENSe:CORRection:PREFerence:ECAL:PMAP <module>,<string>

(Read-Write) When ECal module orientation is turned OFF (SENS:CORR:PREF:ECAL:ORI), this command specifies the port mapping (which ports of the module are connected to which ports of the PNA) prior to performing ECal calibrations.

This setting remains until the PNA is restarted or this command is sent again.

Parameters

 

<module>

Specifies which ECal module this port map is being applied to.  Choose from:

ECAL1

.through.

ECAL50

<string>

Format this parameter in the following manner:

Aw,Bx,Cy,Dz

where

  • A, B, C, and D are literal ports on the ECAL module

  • w,x,y, and z are substituted for PNA port numbers to which the ECAL module port is connected.

Ports of the module which are not used are omitted from the string.

For example, on a 4-port ECal module with

port A connected to PNA port 2

port B connected to PNA port 3

port C not connected

port D connected to PNA port 1

the string would be: A2,B3,D1

If either the receive port or source port (or load port for 2-port cal) of the CALC:PAR:SELected measurement is not in this string and orientation is OFF, an attempt to perform an ECal calibration will fail.

Examples

SENS:CORR:PREF:ECAL:PMAP ECAL2, 'A1,B2' sense:correction:preference:ecal:pmap ecal3, 'a2,b1,c3'

Query Syntax

SENSe:CORRection:PREFerence:ECAL:PMAP? <module>

Return Type

String

Default

Null string ()


SENSe:CORRection:PREFerence:SIMCal <bool> Obsolete

This command is no longer supported. Learn more about old and new behaviors.

(Read-Write) Sets and returns a preference for the Unguided Cal behavior described below. This setting persists until it is changed.

This preference can also be set ON by executing the script on the PNA at C:/Program Files/Keysight/Network Analyzer/System/wincal32.reg.

Parameters

 

<bool>

Boolean - Choose from:

0 - OFF - Reverts to new (preferred) behavior. An error is returned if standard data is not acquired before sending SENS:CORR:COLL:SAVE.

1 - ON - (WinCal compatible)  Prevents SENS:CORR:COLL:SAVE from failing when standard data has not, and will not, be acquired.

Examples

SENS:CORR:PREF:SIMC 0

sense:correction:preference:simcal 1

Query Syntax

SENSe:CORRection:PREFerence:SIMCal?

Return Type

Boolean

Default

0


SENSe:CORRection:PREFerence:TRIG:FREE <char>, <bool>

(Read-Write) Sets and returns the preference for the trigger behavior during a calibration. This setting persists until it is changed.

Note: If TRIGger:SOURce = Manual, during a calibration the PNA ALWAYS switches to Internal for one trigger, then back to Manual, regardless of this preference command.

Parameters

 

<char>

Character - Calibration type. Choose from:

GUIDed - preference setting pertains to a Guided calibration.

UNGuided - preference setting pertains to an Unguided calibration.

<bool>

Boolean - Choose from:

0 - OFF - The trigger behavior during the specified calibration type DOES respect the setting of the TRIGger:SOURce command. For example,when Trigger source = External, the single trigger method will wait for the External trigger signal and then allow only one sweep.

1 - ON - (Pre-6.0 behavior) The trigger behavior during the specified calibration type does NOT respect the setting of the TRIGger:SOURce command. For example, when Trigger source = External, during calibration the PNA switches to Internal sweep, responds to one trigger signal to measure the standard, then switches back to External.

Examples

SENS:CORR:PREF:TRIG:FREE GUID,1

sense:correction:preference:trig:free unguided,0

Query Syntax

SENSe:CORRection:PREFerence:TRIG:FREE? <char>

Return Type

Boolean

Default

OFF for both calibration types.


SENSe<cnum>:CORRection:RPOWer:OFFSet[:AMPLitude] <num>

(Read-Write)  Adjusts a receiver power cal to account for components or adapters that are added between the source port and receiver while performing this cal. For more information, see Receiver Cal.

Parameters

 

<cnum>

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

<num>

Offset Value in dB. Specify loss as a negative number; and gain as a positive number. Choose a number between -200 and 200.

Examples

SENS:CORR:RPOW:OFFS .5
sense2:correction:rpower:offset:amplitude .-5

Query Syntax

SENSe<cnum>:CORRection:RPOWer:OFFSet[:AMPLitude]?

Return Type

Numeric

Default

0


SENSe<cnum>:CORRection:RVELocity:COAX <num>

(Read-Write) Sets the velocity factor to be used with Electrical Delay and Port Extensions.

Parameters

 

<cnum>

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

<num>

Velocity factor. Choose a number between 0 and 10

(.66 polyethylene dielectric; .7 PTFE dielectric)

Examples

SENS:CORR:RVEL:COAX .66
sense2:correction:rvelocity:coax .70

Query Syntax

SENSe<cnum>:CORRection:RVELocity:COAX?

Return Type

Numeric

Default

1


SENSe<cnum>:CORRection:SFORward[:STATe] <boolean>

(Read-Write) Sets the direction a calibration will be performed when only one set of standards is used.

Use SENSe:CORRection:TSTandards[:STATe] OFF to specify that only one set of standards will be used.

Parameters

 

<cnum>

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

<boolean>

ON (1) - FORWARD direction of a 2-port calibration will be performed

OFF (0) - REVERSE direction of a 2-port calibration will be performed

Examples

SENS:CORR:SFOR 1
sense2:correction:sforward:state 0

See an example using this command

Query Syntax

SENSe<cnum>:CORRection:SFORward[:STATe]?

Return Type

Boolean

Default

ON


SENSe<cnum>:CORRection[:STATe] <ON | OFF>

(Read-Write) Turns error correction ON and OFF for the specified channel.

Note: Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<cnum>

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

<ON | OFF>

ON (or 1) - correction is applied to the channel.

OFF (or 0) - correction is NOT applied to the channel.

Examples

SENS:CORR ON
sense2:correction:state off

Query Syntax

SENSe<cnum>:CORRection[:STATe]?

To query the error correction state for a measurement, use CALC:CORR:STATe?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF


SENSe<cnum>:CORRection:TCOLd:USER:VALue <num>

(Read-Write) Sets and returns the temperature of the noise source connector. Learn more about Noise Figure Calibration.

Parameters

 

<cnum>

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

<num>

Noise source temperature in Kelvin.

Examples

SENS:CORR:TCOL:USER:VAL 295

sense2:correction:tcold:user:value 298

See an example using this command

Query Syntax

SENSe<cnum>:CORRection:TCOLd:USER:VALue?

Return Type

Numeric

Default

Not Applicable


SENSe<cnum>:CORRection:TSTandards[:STATe] <boolean>

(Read-Write) Specifies the acquisition of calibration data using ONE or TWO sets of standards.

Parameters

 

<cnum>

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

<boolean>

ON (1) - TWO identical sets of standards will be used to simultaneously calibrate two ports (for both Forward and Reverse parameters).

OFF (0)- ONE set of standards will be used to perform a full 2-port calibration, one port at a time.

When specifying ON (use two sets), the SENS:CORR:COLL:ACQuire command uses the same standard index for each calibration class. To specify the calibration standard gender for each port, you must first ensure that the order of calibration class accurately reflects the configuration of your DUT.  For example, for a DUT with a male connector on port 1 and a female connector on port 2, order the devices within the S11 classes (A, B, and C) such that the MALE standards are first in the list.  Then order the S22 classes specifying the FEMALE standards as the first in the list.

Examples

SENS:CORR:TST 1
sense2:correction:tstandard:state 0

See an example using this command

Query Syntax

SENSe<cnum>:CORRection:TSTandards[:STATe]?

Return Type

Boolean

Default

ON


SENSe:CORRection:TYPE:CATalog? <char>

(Read-Write) Lists the Cal Types in the PNA by either GUID or registered name. Learn more about applying Cal Type using SCPI.

Note: Before using this command you must select a measurement using CALC:PAR:SEL. You can select one measurement for each channel.

Parameters

 

<char>

Specifies the type of list. Choose from:

GUID -  the registered GUID of the Cal Type

NAME -  the registered name of the Cal Type

Examples

SENS:CORR:TYPE:CAT? GUID

Query Syntax

SENSe<cnum>:CORRection:TYPE:CATalog? <char>

Return Type

Comma-separated string

Default

Not Applicable


Last modified:

16-Jan-2014

Obsolete WinCal Pref command

16-Jan-2014

Fixed link at ENR:CAl:Table:Data

16-Jan-2014

Added note to Obsolete Isolation command

Reordered list of commands

16-Jan-2014

Removed errant link to Window:STATe

Updated ACQuire command with ECal# and char

Fixed TCOLd example

Added Cal method Sparsolt3

16-Jan-2014

Edited Pref:Save

16-Jan-2014

Edited TRL limitations

Added SENS:CORR:METH:MATC

16-Jan-2014

Updated confidence check to 12 User chars

16-Jan-2014

Added Noise commands and Normalization method. (9.1)

16-Jan-2014

Added Cal Pref FOM

16-Jan-2014

Added Acq, sync

16-Jan-2014

Added 'if meas deleted' to Swe:Chan

16-Jan-2014

Added Noise TCOLd

16-Jan-2014

Added missing <cnum> arguments

January 16, 2014

Added ENR commands

January 16, 2014

Addd ECal isolation commands

Oct 30, 2006

Modified SavUser command