VectorStar™ MS4640A SeriesMicrowave Vector Network Analyzer : SCPI Commands : :SOURce{1-16}:POWer Subsystem
 
:SOURce{1-16}:POWer Subsystem
The :SOURce{1-16}:POWer subsystem commands are used configure and control port power types, attenuation types and levels, power coupling, calibration, and correction data for the indicated channel and port.
Power Configuration Subsystems
Related power configuration and control systems are:
• :SOURce{1-16}:EFFective Subsystem
• :SOURce{1-16}:POWer Subsystem (this subsystem)
 
:SOURce{1-16}:POWer:PORT:COUPle <char1>
:SOURce{1-16}:POWer:PORT:COUPle?
Description
Turns port power coupling on/off on the given channel.
Outputs the port power coupling on/off state on the given channel.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
1
Syntax Example
:SOUR1:POW:PORT:COUP ON
:SOUR1:POW:PORT:COUP?
 
 
:SOURce{1-16}:POWer:PORT{1-2}:CORRection:COLLect
Description
Performs a flat power correction calibration for the indicated channel and port, and returns the calibration result. No query. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable. The command returns status where:
• 0 = Calibration Passed
• 1 = Calibration Failed
• 2 = Calibration Aborted
Cmd Parameters
<NR1> 0 | 1 | 2
Range
NA
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:CORR:COLL
1
 
:SOURce{1-16}:POWer:PORT{1-2}:CORRection:DATA <block>
:SOURce{1-16}:POWer:PORT{1-2}:CORRection:DATA?
Description
Inputs the flat power correction data for the indicated channel and port. Outputs the flat power correction data of the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<block> data formatted as XML. See definition of <block> or <arbitrary block>.
Query Parameters
<block> data formatted as XML. See definition of <block> or <arbitrary block>.
Range
NA
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:CORR:DATA <block>
:SOUR1:POW:PORT1:CORR:DATA?
 
:SOURce{1-16}:POWer:PORT{1-2}:CORRection:TARGet <NRf>
:SOURce{1-16}:POWer:PORT{1-2}:CORRection:TARGet?
Description
Sets the power level target for the flat power correction calibration on the indicated channel and port. Outputs the power level target for the flat power correction calibration on the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
MPNF
Default Value
0.000000E+000
Syntax Example
:SOUR1:POW:PORT1:CORR:TARG 3.0
:SOUR1:POW:PORT1:CORR:TARG?
 
:SOURce{1-16}:POWer:PORT{1-2}:CORRection[:STATe] <char1>
:SOURce{1-16}:POWer:PORT{1-2}:CORRection[:STATe]?
Description
Turn on/off flat power correction for the indicated channel and port. Outputs the on/off status of flat power correction for the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:CORR ON
:SOUR1:POW:PORT1:CORR?
 
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:COLLect
Description
Performs a power linearity correction calibration for the indicated channel and port, and returns the calibration result. The command returns the calibration completion status where:
• 0 = Calibration Passed
• 1 = Calibration Failed
• 2 = Calibration Aborted
No query.
This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<NR1> 0 | 1 | 2
Range
NA
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:LIN:CORR:COLL
 
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:DATA <block>
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:DATA?
Description
Inputs the power sweep linearity calibration data for the indicated channel. Outputs the power sweep linearity calibration data of the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<block> data formatted as XML. See definition of <block> or <arbitrary block>.
Query Parameters
<block> data formatted as XML. See definition of <block> or <arbitrary block>.
Range
NA
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:LIN:CORR:DATA <block>
:SOUR1:POW:PORT1:LIN:CORR:DATA?
 
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:POWer:STARt <NRf>
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:POWer:STARt?
Description
Sets the power sweep start power target for the linear power calibration on the indicated channel and port. Outputs the power sweep start power target for the linear power calibration on the indicated channel and port.This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<NRf> The input parameter is in dBm.
Query Parameters
<NR3> The output parameter is in dBm.
Range
MPNF
Default Value
-2.000000E+001 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:CORR:POW:STAR 2.3E1
:SOUR1:POW:PORT1:LIN:CORR:POW:STAR?
 
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection:POWer:STOP?
Description
Query only. Outputs the power sweep start power target for the linear power calibration on the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<NR3> The output parameter is in dBm.
Range
NA
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:CORR:POW:STOP?
 
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection[:STATe] <char1>
:SOURce{1-16}:POWer:PORT{1-2}:LINear:CORRection[:STATe]?
Description
The command turns on/off the power sweep linear calibration for the indicated channel and port. Outputs the on/off status of the power sweep linear calibrations for the indicated channel and port. This command is not supported for 4-Port VNAs. If a 4-Port Test Set is connected to the VNA, this command will not work and the equivalent GUI interface buttons are unavailable.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:LIN:CORR 1
:SOUR1:POW:PORT1:LIN:CORR?
 
:SOURce{1-16}:POWer:PORT{1-4}:ATTenuation <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:ATTenuation?
Description
Sets the attenuation value of the indicated port on the indicated channel. Outputs the attenuation value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
0 to 60 dB in 10 dB increments
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:ATT 2E1
:SOUR1:POW:PORT1:ATT?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:EFFective:STOP?
Description
Query only. Ouputs the power sweep effective (>54G) stop power of the indicated port on the indicated channel.
Cmd Parameters
NA
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:POW:EFF:STOP?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:STARt<NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:STARt?
Description
The command sets the power sweep start power for frequencies greater than 54 GHz (>54G) on the indicated port on the indicated channel. The query ouputs the power sweep (>54G) start power of the indicated port on the indicated channel.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:POW:STAR <NRf>
:SOUR1:POW:PORT1:LIN:MODBB:POW:STAR?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:STEP?
Description
Query only. The query ouputs the power sweep (>54G) stepsize of the indicated port on the indicated channel for frequencies greater than 54 GHz.
Cmd Parameters
NA
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:POW:STEP?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:STOP <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:POWer:STOP?
Description
The command sets the power sweep (>54G) stop power on the indicated port on the indicated channel for frequencies greater than 54 GHz. The query outputs the power sweep (>54G) stop power of the indicated port on the indicated channel for frequencies greater than 54 GHz.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:POW:STOP <NRf>
:SOUR1:POW:PORT1:LIN:MODBB:POW:STOP?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:SINGle:POWer:EFFective:VALue?
Description
Query only. The query ouputs the power sweep effective (>54G) single power value of the indicated port on the indicated channel for frequencies greater than 54 GHz.
Cmd Parameters
NA
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:SING:POW:EFF:VAL?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:SINGle:POWer:VALue <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:MODBB:SINGle:POWer:VALue?
Description
Sets the power sweep (>54G) single power value on the indicated port on the indicated channel for frequencies greater than 54 GHz. The query ouputs the power sweep (>54G) single power value of the indicated port on the indicated channel for frequencies greater than 54 GHz.
Cmd Parameters
<NRf>
Query Parameters
NA
Output
<NR3>
Syntax Example
:SOUR1:POW:PORT1:LIN:MODBB:SING:POW:VAL <NRf>
:SOUR1:POW:PORT1:LIN:MODBB:SING:POW:VAL?
<NR3>
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:EFFective:STARt?
Description
Query only. Outputs the power sweep effective start power of the indicated port on the indicated channel.
Query Parameters
<NR3> The output parameter is in dBm.
Range
MPNF
Default Value
The default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:EFF:STAR?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:EFFective:STOP?
Description
Query only. Outputs the power sweep effective stop power of the indicated port on the indicated channel.
Query Parameters
<NR3> The output parameter is in dBm.
Range
MPNF
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:EFF:STOP?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:OFFSet <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:OFFSet?
Description
Sets the power sweep offset power on the indicated port on the indicated channel. Outputs the power sweep offset power of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
–1E2 to 1E2 dB
Default Value
0.000000E+000
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:OFFS 1.2E1
:SOUR1:POW:PORT1:LIN:POW:OFFS?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:POINt <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:POINt?
Description
Sets the power sweep number of points on the indicated port on the indicated channel. Outputs the power sweep number of points of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
<NR1> The output parameter is an integer.
Range
0 to 60
Default Value
50
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:POIN 10E0
:SOUR1:POW:PORT1:LIN:POW:POIN?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:STARt <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:STARt?
Description
Sets the power sweep start power on the indicated port on the indicated channel. Outputs the power sweep start power of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dBm.
Query Parameters
<NR3> The output parameter is in dBm.
Range
–3E1 to 2.99E1 dBm
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:STAR 2.10E1
:SOUR1:POW:PORT1:LIN:POW:STAR?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:STEP?
Description
Query only. Outputs the power sweep step size of the indicated port on the indicated channel.
Query Parameters
<NR3> The output parameter is in dB.
Range
Power step is a calculated value based on the start and stop power levels divided by the number of points in the active channel.
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:STEP?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:STOP <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:POWer:STOP?
Description
Sets the power sweep stop power on the indicated port on the indicated channel. Outputs the power sweep stop power of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dBm.
Query Parameters
<NR3> The output parameter is in dBm.
Range
-2.99E1 to 3E1 dBm
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:POW:STOP 2.5E1
:SOUR1:POW:PORT1:LIN:POW:STOP?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:REFerence:ATTenuation <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:REFerence:ATTenuation?
Description
Sets the power sweep reference attenuation value of the indicated port on the indicated channel. Outputs the power sweep reference attenuation value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
0 to 60 dB in 10 dB increments
Default Value
0 dB
Syntax Example
:SOUR1:POW:PORT1:LIN:REF:ATT 10E0
:SOUR1:POW:PORT1:LIN:REF:ATT?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:SINGle:POWer:EFFective:VALue?
Description
Query only. Outputs the power sweep effective single power value of the indicated port on the indicated channel.
Query Parameters
<NR3> The output parameter is in dBm.
Range
–20 dBm to +5 dBm
Default Value
NA
Syntax Example
:SOUR1:POW:PORT1:LIN:SING:POW:EFF:VAL?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:SINGle:POWer:VALue <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:SINGle:POWer:VALue?
Description
Sets the power sweep single power value on the indicated port on the indicated channel. Outputs the power sweep single power value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dBm.
Query Parameters
<NR3> The output parameter is in dBm.
Range
–3E1 to 3E1
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1:LIN:SING:POW:VAL 1.0E1
:SOUR1:POW:PORT1:LIN:SING:POW:VAL?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:SINGle:POWer[:STATe] <char1>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:SINGle:POWer[:STATe]?
Description
Turns on/off the power sweep single power mode on the indicated port on the indicated channel. Outputs on/off state of the power sweep single power mode of the indicated port on the indicated channel.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:LIN:SING:POW 1
:SOUR1:POW:PORT1:LIN:SING:POW?
 
:SOURce{1-16}:POWer:PORT{1-4}:LINear:TEST:ATTenuation <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:LINear:TEST:ATTenuation?
Description
Sets the power sweep test attenuation value of the indicated port on the indicated channel. Outputs the power sweep test attenuation value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
0 to 60 dB in 10 dB increments
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:LIN:TEST:ATT 10E0
:SOUR1:POW:PORT1:LIN:TEST:ATT?
 
:SOURce{1-16}:POWer:PORT{1-4}:REFerence:ATTenuation <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:REFerence:ATTenuation?
Description
Sets the reference attenuation value of the indicated port on the indicated channel. Outputs the reference attenuation value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
0 to 60 dB in 10 dB increments
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:ATT 2.0E1
:SOUR1:POW:PORT1:REF:ATT?
 
:SOURce{1-16}:POWer:PORT{1-4}:SLOPe <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:SLOPe?
Description
Sets the power slope value of the indicated port on the indicated channel. Outputs the power slope value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is a unitless number.
Query Parameters
<NR3> The output parameter is a unitless number.
Range
–1E3 to 1E3
Default Value
0.000000E+000
Syntax Example
:SOUR1:POW:PORT1:SLOP 3.0E0
:SOUR1:POW:PORT1:SLOP?
 
:SOURce{1-16}:POWer:PORT{1-4}:TEST:ATTenuation <NRf>
:SOURce{1-16}:POWer:PORT{1-4}:TEST:ATTenuation?
Description
Sets the test attenuation value of the indicated port on the indicated channel. Outputs the test attenuation value of the indicated port on the indicated channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR1> The output parameter is in dB.
Range
0 to 60 dB in 10 dB increments
Default Value
0
Syntax Example
:SOUR1:POW:PORT1:TEST:ATT 10E0
:SOUR1:POW:PORT1:TEST:ATT?
 
:SOURce{1-16}:POWer:PORT{1-4}[:LEVel][:IMMediate][:AMPlitude] <NRf>
:SOURce{1-16}:POWer:PORT{1-4}[:LEVel][:IMMediate][:AMPlitude]?
Description
Sets the power level of the given port on the given channel. Outputs the power level of the given port on the given channel.
Cmd Parameters
<NRf> The input parameter is in dB.
Query Parameters
<NR3> The output parameter is in dB.
Range
–3E1 to 3E1
Default Value
Default value depends on model and installed options:
• MSA4645A or MS4647A with Options 051, 061, or 062 = –10 dBm
• All other MS4645As and MS4647As = –3 dBm
• MS4642A and MS4644A = +5 dBm
Syntax Example
:SOUR1:POW:PORT1 3.0E0
:SOUR1:POW:PORT1?
 
:SOURce{1-16}:POWer:SLOPe[:STATe] <char1>
:SOURce{1-16}:POWer:SLOPe[:STATe]?
Description
Turns on/off the power slope mode on the indicated channel. Outputs on/off state of the power slope mode on the indicated channel.
Cmd Parameters
<char1> 1 | 0 | ON | OFF
Query Parameters
<char1> 1 | 0
Range
NA
Default Value
0
Syntax Example
:SOUR1:POW:SLOP ON
:SOUR1:POW:SLOP?