Source:Power:Correction Commands

SOURce:POWer:CORRection:

COLLect

| ABORt

| [ACQuire]

| AVERage

            | [COUNt]

            | NTOLerance

       | DISPlay

            | [STATe]

       | FCHeck]

            | [STATe]

       | ITERation

            | [COUNt]

            | NTOLerance

       | SAVE

       | SENSor

            | [FRANge]

            | RCFactor

            | SELect

       | TABLe

            | DATA

            | FREQuency

            | LOSS

                 | [STATe]

            | POINts?

            | [SELect]

DATA

       | PRIor

LEVel [AMPlitude]

OFFSet

       | [MAGNitude]

[STATe]

(Write-only) Aborts a source power calibration sweep that is in progress.

To use this ABORt command, you MUST use the ASYNchronous argument with SOUR:POW:CORR:COLL:ACQ

After aborting, this message appears in the error log: +243,"Requested operation was canceled".

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

Examples

SOUR:POW:CORR:COLL:ABOR
source1:power2:correction:collect:abort

Query Syntax

Not Applicable

Default

Not Applicable

Note: With VNA Rev. 6.2, a new "id" argument has been added to this command, replacing SOUR:POW:CORR:COLL:METH.

(Write-only) Initiates a source power cal acquisition sweep using the power sensor attached to the specified channel (A or B) on the power meter, using a USB power sensor, or using the specified VNA receiver.  

For source power cal, the power meter can NOT be controlled by the VNA using the GPIB Talker/Listener interface. Instead use one of the following methods:

• If present, use the GPIB dedicated controller port.

• Connect the power meter to the VNA using a USB / GPIB interface (Keysight 82357B).

• SCPI programming of the VNA using a LAN Client interface (see example).

• Send SCPI commands through the COM interface using the SCPI String Parser object.

• Directly control the Power Meter and VNA to step frequency; then acquire and store the Power reading. (see example).

• Configure the Power Meter/Sensor as a PMAR Device. Learn how. See SCPI commands.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<char>

Acquisition Choose from:

• PMETer - Power Meter is used for all readings.

• PMReceiver - Power meter for the first iteration; then use the reference receiver for remaining readings if necessary (same as "fast iteration" box checked on dialog box)

• RECeiver -  Use VNA measurement receiver for all readings.

<id>

String  (Not case sensitive). The power sensor or VNA receiver to use for measuring power.

For PMETer or PMRECeiver, choose from:

• "ASENSOR" or "BSENSOR". For U series USB sensors, always specify "ASENSOR"

For RECeiver, choose from:

• Any VNA receiver to acquire readings using physical or logical receiver notation.

• Any configured PMAR device name. Learn more about PMAR Devices. See PMAR commands.

[src]

Optional argument. String. (NOT case sensitive). Source port.  Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

[sync]

If this argument is specified, must also specify [src].

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

SOUR:POW:CORR:COLL PMET,"ASENSOR","Port 1",ASYN  'acquires power meter readings using the A sensor, source port 1, asynchronous.
source1:power2:correction:collect:acquire receiver,"a1" 'acquires source cal readings using the reference receiver for port 1.

Query Syntax

Not Applicable

Default

Not Applicable

(Read-Write) This command, along with SOUR:POW:CORR:COLL:AVER:NTOLerance, allows for settling of the power sensor READINGS.

Sets the maximum number of acquisitions that will be used to acquire one settled reading from the power meter. These settings affect every use of the power meter (PMAR and source power cal).

When this average meets the Average:NTOLerance value or this number of readings has been made, the average is returned as the valid reading.

This setting is not necessary when using a VNA receiver (SOUR:POW:CORR:COLL REC) to make the measurement.

Learn more.

Parameters

<ch>

If provided, this argument is ignored by the VNA.

<port>

If provided, this argument is ignored by the VNA.

<num>

Maximum number of readings to make to allow for settling. Choose any number between 3 and 1000.

Examples

SOUR:POW:CORR:COLL:AVER 2
source:power:correction:collect:average:count 3

Query Syntax

SOURce:POWer:CORRection:COLLect:AVERage[:COUNt]?

Return Type

Numeric

Default

3

(Read-Write)  This command, along with SOUR:POW:CORR:COLL:AVER:COUNT, allows for settling of the power sensor READINGS.

Each power reading is averaged with the previous readings at each stimulus point. When the average meets this nominal tolerance value or the max number of readings has been made, the average is returned as the valid reading.

This setting is not necessary when using a VNA receiver (SOUR:POW:CORR:COLL REC) to make the measurement.

Learn more.

Parameters

<ch>

If provided, this argument is ignored by the VNA.

<port>

If provided, this argument is ignored by the VNA.

<num>

Power measurement settling tolerance value in dB. Choose any number between 0 and 5.

Examples

SOUR:POW:CORR:COLL:AVER:NTOL .05
source1:power2:correction:collect:average:ntolerance .003

Query Syntax

SOURce:POWer:CORRection:COLLect:AVERage:NTOLerance?

Return Type

Numeric

Default

.050 dBm

(Read-Write)  Enables and disables the display of power readings on the VNA screen. Send this command BEFORE you begin a source power cal acquisition. After the source power cal data is acquired, this setting is reset to ON.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<ON|OFF>

ON (1)  Source power calibration dialog box is shown on the VNA screen. Power  readings are plotted against the Tolerance value as limit lines.

OFF (0) - Source power calibration dialog box is NOT shown on the VNA screen.

Examples

SOUR:POW:CORR:COLL:DISP ON
source1:power2:correction:collect:display:state off

Query Syntax

SOURce:POWer:CORRection:COLLect:DISPlay[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

ON (1)

(Read-Write)  Enables and disables frequency checking of source power cal acquisition sweeps. ONLY use when you have more than one power sensor.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<ON|OFF>

ON (1) turns source power cal frequency checking ON. A requested acquisition will only succeed for those frequency points which fall within a frequency range specified for the power sensor being used. An acquisition will pause in mid-sweep if the frequency is about to exceed the maximum frequency limit specified for that sensor. When the sweep is paused in this manner, a sensor connected to the other channel input of the power meter can be connected to the measurement port in place of the previous sensor, and used to complete the sweep. However, the maximum frequency specified for the second sensor would need to be sufficient for the sweep to complete. Frequency limits are specified using the SOUR:POW:CORR:COLL:SEN command.

OFF (0) - turns source power cal frequency checking OFF. An acquisition will use just one power sensor for the entire sweep, regardless of frequency.

Examples

SOUR:POW:CORR:COLL:FCH ON
source1:power2:correction:collect:fcheck:state off

Query Syntax

SOURce:POWer:CORRection:COLLect:FCHeck[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF (0)

(Read-Write) This command, along with SOUR:POW:CORR:COLL:ITER:NTOL describes the number of adjustments to set the power to a desired level.

These settings determine how many attempts (COUNt) the analyzer will make in an attempt to get close enough (NTOLerance) to the target power level.

Learn more.

Parameters

<ch>

If provided, this argument is ignored by the VNA.

<port>

If provided, this argument is ignored by the VNA.

<num>

Maximum number of readings. Choose any number between 1 and 1000.

Examples

SOUR:POW:CORR:COLL:ITER 2
source:power:correction:collect:iteration 3

Query Syntax

SOURce:POWer:CORRection:COLLect:ITERation[:COUNt]?

Return Type

Numeric

Default

1

(Read-Write) This command, along with SOUR:POW:CORR:COLL:ITER:COUNT describes the number of adjustments to make to the source power.

These settings determine how many attempts (COUNt) the analyzer will make in an attempt to get close enough (NTOLerance) to the target power level.

Learn more.

Parameters

<ch>

If provided, this argument is ignored by the VNA.

<port>

If provided, this argument is ignored by the VNA.

<num>

Tolerance value in dBm. Choose any number between 0 and 5

Examples

SOUR:POW:CORR:COLL:ITER:NTOL .005
source:power:correction:collect:iteration:ntolerance .1

Query Syntax

SOURce:POWer:CORRection:COLLect:ITERation:NTOLerance?

Return Type

Numeric

Default

.05

(Write-only) Applies the array of correction values after a source power calibration sweep has completed. The source power correction will then be active on the specified source port for channel <ch>. This command does NOT save the correction values. To save correction values, save an instrument / calibration state (*.cst file) after performing a source power cal.

Parameters

<ch>

If provided, this argument is ignored by the VNA.

<port>

If provided, this argument is ignored by the VNA.

<RREC>

Optional argument.

RRECeiver  In addition to a source Power Cal, perform a calibration of the reference receiver used in the measurement.  ONLY the Reference Receiver calibration is then saved to a Cal Set or Cal Register as specified by the current setting of SENS:CORR:PREF:CSET:SAVE.

This argument only applies to standard S-parameter channels.

Examples

SOUR:POW:CORR:COLL:SAVE
source:power:correction:collect:save rreceiver

Query Syntax

Not Applicable

Default

Not Applicable

(Read-Write) Specifies the frequency range over which the power sensors connected to the specified channels (A and B) of the power meter can be used (minimum frequency, maximum frequency). If the power meter has only a single channel, that channel is considered channel A.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<pmChan>

Power Meter channel. Choose from:

A - Channel A

B - Channel B

<num1>

Minimum frequency for the sensor. If a frequency unit is not specified, Hz is assumed. No limits are placed on this value.

<num2>

Maximum frequency for the sensor. If a frequency unit is not specified, Hz is assumed. No limits are placed on this value.

Examples

SOUR:POW:CORR:COLL:ASEN 100E3, 3E9
source1:power2:correction:collect:bsensor:frange 10 MHz, 18 GHz

Query Syntax

SOURce:POWer:CORRection:COLLect:ASENsor[:FRANge]?

SOURce:POWer:CORRection:COLLect:BSENsor[:FRANge]?

Return Type

Numeric

Default

0,0

(Read-Write) ) Specifies the reference cal factor for the power sensor connected to channel A or B of the power meter. If the power meter has only a single channel, that channel is considered channel A.

Note: If the sensor connected to the specified channel of the power meter contains cal factors in EPROM (such as the Keysight E-series power sensors), those will be the cal factors used during the calibration sweep. The reference cal factor value associated with this command, and any cal factors entered into the VNA for that sensor channel, will not be used.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<pmChan>

Power Meter channel. Choose from:

A - Channel A

B - Channel B

<num>

Reference cal factor in percent.  Choose any number between 1 and 150.

Examples

SOUR:POW:CORR:COLL:ASEN:RCF 98.7
source1:power2:correction:collect:bsensor:rcfactor 105

Query Syntax

SOURce:POWer:CORRection:COLLect:ASENsor:RCFactor?

SOURce:POWer:CORRection:COLLect:BSENsor:RCFactor?

Return Type

Numeric

Default

100

(Read-Write) Sets and returns the power sensor channel (A or B) to be used.  This performs the same function as the Use this sensor only checkbox in the Power Sensor Settings dialog.

Notes:

• This command is NOT necessary when performing a Guided Power Cal using Multiple Sensors.

• This command can be used with Application channels.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<pmChan>

Power Meter channel. Choose from:

A - Channel A

B - Channel B

Examples

SOUR:POW:CORR:COLL:<pmChan>SEN:SEL 'Write

source1:power2:correction:collect:bsensor:select? 1e9 'Read

Query Syntax

SOURce:POWer:CORRection:COLLect:ASENsor:SELect? <Frequency>

SOURce:POWer:CORRection:COLLect:BSENsor:SELect? <Frequency>

Returns a boolean 1 or 0 (ON or OFF) indicating whether the sensor is to be used at the specified frequency.

If frequency checking is OFF, then the <Frequency> parameter is ignored. The query returns if the sensor is selected for ALL frequencies.

Return Type

Numeric

Default

Not Applicable

(Read-Write) Read or write data into the selected table. Use SOUR:POW:CORR:COLL:TABL:SELect to select a table.

• When the power sensor table is selected, the data is interpreted as cal factors in percent.

• When the loss table is selected, POSITIVE values in dB are interpreted as LOSS.  To compensate for gain, use negative values.  

• Each table can contain up to 9999 segments. Values can be loaded using the Characterize Adapter macro.

• Learn more about Power Loss Compensation.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<data>

Data to write into the selected table.

Examples

SOURce:POWer:CORRection:COLLect:TABLe:DATA 0.12, 0.34, 0.56

Query Syntax

SOURce<ch>:POWer:CORRection:COLLect:TABLe:DATA?

If the selected table is currently empty, no data is returned.

Return Type

Numeric - one number per table segment.

Default

Not Applicable

(Read-Write) Read or write frequency values for the selected table (cal factor table for a power sensor, or the loss compensation table). Use SOUR:POW:CORR:COLL:TABL:SELect to select a table.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<data>

Frequency data to write into the selected table.

Examples

SOURce:POWer:CORRection:COLLect:TABLe:FREQuency 10E6, 1.5E9, 9E9

Query Syntax

SOURce<ch>:POWer:CORRection:COLLect:TABLe:FREQuency?

If the selected table is currently empty, no data is returned.

Return Type

Numeric - one number per table segment

Default

Not Applicable

(Read-Write) Indicates whether or not to adjust the power readings using the values in the loss table during a source power cal sweep.  Learn more about Power Loss Compensation.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<bool>

ON (or 1) -  turns use of the loss table ON.

OFF (or 0) - turns use of the loss table OFF.

Examples

SOUR:POW:CORR:COLL:TABL:LOSS ON
source1:power2:correction:collect:table:loss:state off

Query Syntax

SOURce:POWer:CORRection:COLLect:TABLe:LOSS[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF (0)

(Read-only) Returns the number of segments that are currently in the selected table.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

Examples

SOUR:POW:CORR:COLL:TABL:POIN?
source1:power2:correction:collect:table:points?

Return Type

Numeric

Default

0

(Read-Write) Selects which table you want to write to or read from. Read or write using SOURce:POWer:CORRection:COLLect:TABLe:FREQuency and SOURce:POWer:CORRection:COLLect:TABLe:DATA

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

If provided, this argument is ignored by the VNA.

<char>

Choose from:  

NONE - No table selected

ASENsor - Cal Factor table for Power Sensor A

BSENsor - Cal Factor table for Power Sensor B

LOSS - Loss compensation table

Examples

SOUR:POW:CORR:COLL:TABL ASEN
source1:power2:correction:collect:table:select bsensor

Query Syntax

SOURce:POWer:CORRection:COLLect:TABLe[:SELect]?

Return Type

Character

Default

NONE

(Read-Write) Writes and reads source power calibration data.

The effect from this command on the channel is immediate. Do NOT send SOUR:POW:CORR:COLL:SAVE after this command as it may invalidate the uploaded data.

When querying source power calibration data, if no source power cal data exists for the specified channel and source port, then no data is returned.

If a change in the instrument state causes interpolation and/or extrapolation of the source power cal, the correction data associated with this command correspond to the new instrument state (interpolated and/or extrapolated data).

If the channel is sweeping the source backwards, then the first data point is the highest frequency value; the last data point is the lowest. Use the SENS:X:VALues? command to return the X-axis values in the displayed order.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<data>

Correction Data

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOURce1:POWer2:CORRection:DATA 0.12, -0.34, 0.56

Query Syntax

SOURce<ch>:POWer<port>:CORRection:DATA? [src]

Return Type

Depends on FORMat:DATA command

Default

Not Applicable

(Read-Write) Writes and reads power correction values from the previous iteration of the source power cal. Data for which the first power meter reading were within the tolerance limit, the prior correction value is 0.

In all other respects, this command is the same as SOUR:POW:CORR:DATA.

This command can be used to determine the final power reading at each point of the power cal, for a cal that did not pass tolerance limits.  The formula for determining the power reading (in dB):

Power reading = Target power at the source port + specified power cal offset value + prior iteration corr value actual power corr value.

The "actual" value in this equation is returned with SOUR:POW:CORR:DATA?

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<data>

Correction Data

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOURce1:POWer2:CORRection:DATA:PRIor 0.12, -0.34, 0.56

Query Syntax

SOURce<ch>:POWer<port>:CORRection:DATA:PRIor? [src]

Return Type

Depends on FORMat:DATA command

Default

Not Applicable

(Read-Write) Specifies the power level that is expected at the desired reference plane (DUT input or output). This is not used for segment sweep with independent power levels or power sweeps.

Note: Although this command still works, it is recommended that you specify cal power by setting the test port power and offset value.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<num>

Cal power level in dBm. Because this could potentially be at the output of a device-under-test, no limits are placed on this value here. It is realistically limited by the specifications of the device (power sensor) that will be used for measuring the power. The power delivered to the VNA receiver must never exceed VNA specifications for the receiver!

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW:CORR:LEV 10
source1:power2:correction:level:amplitude 0 dbm

Query Syntax

SOURce:POWer:CORRection:LEVel[:AMPLitude]? [src]

Return Type

Numeric

Default

0 dBm

(Read-Write)  Sets or returns a power level offset from the VNA test port power. This can be a gain or loss value (in dB) to account for components you connect between the source and the reference plane of your measurement. For example, specify 10 dB to account for a 10 dB amplifier at the input of your DUT.

Cal power is the sum of the test port power setting and this offset value. Following the calibration, the VNA power readouts are adjusted to the cal power.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<num>

Gain or loss value in dB. Choose a value between -200 and 200

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW:CORR:OFFS 10
source1:power2:correction:offset:magnitude -3

Query Syntax

SOURce:POWer:CORRection:OFFSet[:MAGNitude]? [src]

Return Type

Numeric

Default

0 dB

(Read-Write) Enables and disables source power correction for the specified port on the specified channel.

Parameters

<ch>

Channel number of the source power cal. If unspecified, value is set to 1

<port>

Port number to correct for source power. If unspecified, value is set to 1.

<bool>

ON (or 1) turns source power correction ON.

OFF (or 0) - turns source power correction OFF.

[src]

String. (NOT case sensitive). Source port. Optional. Use SOUR:CAT? to return a list of valid port names.

While this argument can be used to make settings for ALL ports, it is designed to access ports that are not simple numbers, such as "Port 1 Src2". Otherwise, the <port> argument performs the same function. If both arguments are specified, [src] takes priority.

Examples

SOUR:POW:CORR ON
source1:power2:correction:state off

Query Syntax

SOURce:POWer:CORRection[:STATe]? [src]

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF (0)

18-May-2016

First Release