Power

SCPI Commands :

[SOURce<HW>]:POWer:AATTenuation
[SOURce<HW>]:POWer:IQPep
[SOURce<HW>]:POWer:LBEHaviour
[SOURce<HW>]:POWer:LMODe
[SOURce<HW>]:POWer:MANual
[SOURce<HW>]:POWer:MODE
[SOURce<HW>]:POWer:PEP
[SOURce<HW>]:POWer:POWer
[SOURce<HW>]:POWer:STARt
[SOURce<HW>]:POWer:STOP
[SOURce]:POWer:WIGNore
Commands in total: 46
Subgroups: 8
Direct child commands: 11
get_aattenuation() float[source]
# [SOURce<HW>]:POWer:AATTenuation
value: float = driver.source.power.get_aattenuation()

Queries the currently active level attenuation.

Returns:

active_att: float Range: 0 to 110

get_iq_pep() float[source]
# [SOURce<HW>]:POWer:IQPep
value: float = driver.source.power.get_iq_pep()

No help available

get_lbehaviour() PowLevBehaviour[source]
# [SOURce<HW>]:POWer:LBEHaviour
value: enums.PowLevBehaviour = driver.source.power.get_lbehaviour()

Selects the level behavior at the RF output over time.

Returns:

behaviour: AUTO | UNINterrupted | MONotone | CVSWr | CPHase UNINterrupted | MONotone Do not use the uninterrupted level settings and strictly monotone modes in combination with the high-quality optimization mode (see method RsSmw.source.bb.impairment.optimization.mode() ) CVSWr Constant VSWR CPHase Continuous phase CONStant Constant phase

get_lmode() PowLevMode[source]
# [SOURce<HW>]:POWer:LMODe
value: enums.PowLevMode = driver.source.power.get_lmode()

Sets the RF level mode.

Returns:

lev_mode: NORMal | LOWNoise | LOWDistortion NORMal Supplies the RF signal with the standard power level of the instrument. LOWNoise Supplies a very low noise sinewave signal. LOWDistortion Supplies a very pure sinewave signal.

get_manual() float[source]
# [SOURce<HW>]:POWer:MANual
value: float = driver.source.power.get_manual()

Sets the level for the subsequent sweep step if method RsSmw.source.sweep.power.mode() . Use a separate command for each sweep step.

Returns:

manual: float You can select any level within the setting range, where: STARt is set with method RsSmw.source.power.start() STOP is set with method RsSmw.source.power.stop() OFFSet is set with method RsSmw.source.power.level.immediate.offset() Range: (STARt + OFFSet) to (STOP + OFFSet) , Unit: dBm

get_mode() LfFreqMode[source]
# [SOURce<HW>]:POWer:MODE
value: enums.LfFreqMode = driver.source.power.get_mode()

Selects the operating mode of the instrument to set the output level.

Returns:

mode: CW | FIXed | SWEep CW | FIXed Operates at a constant level. CW and FIXed are synonyms. To set the output level value, use the command method RsSmw.source.power.level.immediate.amplitude() . SWEep Sets sweep mode. Set the range and current level with the commands: method RsSmw.source.power.start() and method RsSmw.source.power.stop() , method RsSmw.source.power.manual() .

get_pep() float[source]
# [SOURce<HW>]:POWer:PEP
value: float = driver.source.power.get_pep()

Queries the PEP ‘Peak Envelope Power) of digital modulation or digital standards at the RF output. This value corresponds to the level specification, displayed in the status bar (header) .

Returns:

pep: float

get_power() float[source]
# [SOURce<HW>]:POWer:POWer
value: float = driver.source.power.get_power()

Sets the level at the RF output connector. This value does not consider a specified offset. The command method RsSmw.source.power.level.immediate.amplitude() sets the level of the ‘Level’ display, that means the level containing offset. See ‘Displayed RF frequency and level values with downstream instruments’.

Returns:

power: float Level at the RF output, without level offset Range: See specifications document. , Unit: dBm

get_start() float[source]
# [SOURce<HW>]:POWer:STARt
value: float = driver.source.power.get_start()

Sets the RF start/stop level in sweep mode.

get_stop() float[source]
# [SOURce<HW>]:POWer:STOP
value: float = driver.source.power.get_stop()

Sets the RF start/stop level in sweep mode.

Returns:

stop: float Sets the setting range calculated as follows: (Level_min + OFFSet) to (Level_max + OFFSet) Where the values are set with the commands: method RsSmw.source.power.level.immediate.offset() method RsSmw.source.power.start() method RsSmw.source.power.stop() Range: Minimum level to maximum level , Unit: dBm

get_wignore() bool[source]
# [SOURce]:POWer:WIGNore
value: bool = driver.source.power.get_wignore()

Ignores level range warnings.

Returns:

state: 1 | ON | 0| OFF

set_lbehaviour(behaviour: PowLevBehaviour) None[source]
# [SOURce<HW>]:POWer:LBEHaviour
driver.source.power.set_lbehaviour(behaviour = enums.PowLevBehaviour.AUTO)

Selects the level behavior at the RF output over time.

Parameters:

behaviour – AUTO | UNINterrupted | MONotone | CVSWr | CPHase UNINterrupted | MONotone Do not use the uninterrupted level settings and strictly monotone modes in combination with the high-quality optimization mode (see method RsSmw.source.bb.impairment.optimization.mode() ) CVSWr Constant VSWR CPHase Continuous phase CONStant Constant phase

set_lmode(lev_mode: PowLevMode) None[source]
# [SOURce<HW>]:POWer:LMODe
driver.source.power.set_lmode(lev_mode = enums.PowLevMode.LOWDistortion)

Sets the RF level mode.

Parameters:

lev_mode – NORMal | LOWNoise | LOWDistortion NORMal Supplies the RF signal with the standard power level of the instrument. LOWNoise Supplies a very low noise sinewave signal. LOWDistortion Supplies a very pure sinewave signal.

set_manual(manual: float) None[source]
# [SOURce<HW>]:POWer:MANual
driver.source.power.set_manual(manual = 1.0)

Sets the level for the subsequent sweep step if method RsSmw.source.sweep.power.mode() . Use a separate command for each sweep step.

Parameters:

manual – float You can select any level within the setting range, where: STARt is set with method RsSmw.source.power.start() STOP is set with method RsSmw.source.power.stop() OFFSet is set with method RsSmw.source.power.level.immediate.offset() Range: (STARt + OFFSet) to (STOP + OFFSet) , Unit: dBm

set_mode(mode: LfFreqMode) None[source]
# [SOURce<HW>]:POWer:MODE
driver.source.power.set_mode(mode = enums.LfFreqMode.CW)

Selects the operating mode of the instrument to set the output level.

Parameters:

mode – CW | FIXed | SWEep CW | FIXed Operates at a constant level. CW and FIXed are synonyms. To set the output level value, use the command method RsSmw.source.power.level.immediate.amplitude() . SWEep Sets sweep mode. Set the range and current level with the commands: method RsSmw.source.power.start() and method RsSmw.source.power.stop() , method RsSmw.source.power.manual() .

set_power(power: float) None[source]
# [SOURce<HW>]:POWer:POWer
driver.source.power.set_power(power = 1.0)

Sets the level at the RF output connector. This value does not consider a specified offset. The command method RsSmw.source.power.level.immediate.amplitude() sets the level of the ‘Level’ display, that means the level containing offset. See ‘Displayed RF frequency and level values with downstream instruments’.

Parameters:

power – float Level at the RF output, without level offset Range: See specifications document. , Unit: dBm

set_start(start: float) None[source]
# [SOURce<HW>]:POWer:STARt
driver.source.power.set_start(start = 1.0)

Sets the RF start/stop level in sweep mode.

Parameters:

start – float Sets the setting range calculated as follows: (Level_min + OFFSet) to (Level_max + OFFSet) Where the values are set with the commands: method RsSmw.source.power.level.immediate.offset() method RsSmw.source.power.start() method RsSmw.source.power.stop() Range: Minimum level to maximum level , Unit: dBm

set_stop(stop: float) None[source]
# [SOURce<HW>]:POWer:STOP
driver.source.power.set_stop(stop = 1.0)

Sets the RF start/stop level in sweep mode.

Parameters:

stop – float Sets the setting range calculated as follows: (Level_min + OFFSet) to (Level_max + OFFSet) Where the values are set with the commands: method RsSmw.source.power.level.immediate.offset() method RsSmw.source.power.start() method RsSmw.source.power.stop() Range: Minimum level to maximum level , Unit: dBm

set_wignore(state: bool) None[source]
# [SOURce]:POWer:WIGNore
driver.source.power.set_wignore(state = False)

Ignores level range warnings.

Parameters:

state – 1 | ON | 0| OFF

Cloning the Group

# Create a copy of the original group, that exists independently
power_copy = driver.source.power.clone()

Subgroups