Immediate

SCPI Commands :

[SOURce<HW>]:POWer:[LEVel]:[IMMediate]:OFFSet
[SOURce<HW>]:POWer:[LEVel]:[IMMediate]:RCL
[SOURce<HW>]:POWer:[LEVel]:[IMMediate]:REFLevel
[SOURce<HW>]:POWer:[LEVel]:[IMMediate]:[AMPLitude]

Commands in total: 4

Subgroups: 0

Direct child commands: 4

get_amplitude() → float

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:[AMPLitude]
value: float = driver.source.power.level.immediate.get_amplitude()

Sets the RF level applied to the DUT. To activate the RF output use method RsSmw.output.state.value() (‘RF On’/’RF Off’) . The following applies POWer = RF output level + OFFSet, where:

• POWer is the values set with method RsSmw.source.power.level.immediate.amplitude()

• RF output level is set with method RsSmw.source.power.power()

• OFFSet is set with method RsSmw.source.power.level.immediate.offset()

Returns:

amplitude: float The following settings influence the value range: OFFSet set with the method RsSmw.source.power.level.immediate.offset() Numerical value Sets the level UP | DOWN Varies the level step by step. The level is increased or decreased by the value set with the method RsSmw.source.power.step.increment() . Range: (Level_min + OFFSet) to (Level_max + OFFStet) , Unit: dBm

get_offset() → float

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:OFFSet
value: float = driver.source.power.level.immediate.get_offset()

Sets the level offset of a downstream instrument. The level at the RF output is not changed. To query the resulting level, as it is at the output of the downstream instrument, use the command method RsSmw.source.power.level.immediate.amplitude() . See ‘Displayed RF frequency and level values with downstream instruments’. Note: The level offset also affects the RF level sweep.

Returns:

offset: float Range: -100 to 100 , Unit: dB Level offset is always expreced in dB; linear units (V, W, etc.) are not supported

get_recall() → InclExcl

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:RCL
value: enums.InclExcl = driver.source.power.level.immediate.get_recall()

Determines whether the current level is retained or if the stored level setting is adopted when an instrument configuration is loaded. The setting is valid for both paths. If a suffix is specified, it is ignored.

Returns:

rcl: INCLude | EXCLude INCLude Takes the current level when an instrument configuration is loaded. EXCLude Retains the current level when an instrument configuration is loaded.

get_ref_level() → float

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:REFLevel
value: float = driver.source.power.level.immediate.get_ref_level()

Queries the reference level of the user correction. The reference level is the sum of the amplitude and the level offset, set with the commands method RsSmw.source.power.power() method RsSmw.source.power.level.immediate.offset() .

Returns:

reference_level: float Range: -245 to 120

set_amplitude(amplitude: float) → None

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:[AMPLitude]
driver.source.power.level.immediate.set_amplitude(amplitude = 1.0)

Sets the RF level applied to the DUT. To activate the RF output use method RsSmw.output.state.value() (‘RF On’/’RF Off’) . The following applies POWer = RF output level + OFFSet, where:

• POWer is the values set with method RsSmw.source.power.level.immediate.amplitude()

• RF output level is set with method RsSmw.source.power.power()

• OFFSet is set with method RsSmw.source.power.level.immediate.offset()

Parameters:

amplitude – float The following settings influence the value range: OFFSet set with the method RsSmw.source.power.level.immediate.offset() Numerical value Sets the level UP | DOWN Varies the level step by step. The level is increased or decreased by the value set with the method RsSmw.source.power.step.increment() . Range: (Level_min + OFFSet) to (Level_max + OFFStet) , Unit: dBm

set_offset(offset: float) → None

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:OFFSet
driver.source.power.level.immediate.set_offset(offset = 1.0)

Sets the level offset of a downstream instrument. The level at the RF output is not changed. To query the resulting level, as it is at the output of the downstream instrument, use the command method RsSmw.source.power.level.immediate.amplitude() . See ‘Displayed RF frequency and level values with downstream instruments’. Note: The level offset also affects the RF level sweep.

Parameters:

offset – float Range: -100 to 100 , Unit: dB Level offset is always expreced in dB; linear units (V, W, etc.) are not supported

set_recall(rcl: InclExcl) → None

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:RCL
driver.source.power.level.immediate.set_recall(rcl = enums.InclExcl.EXCLude)

Determines whether the current level is retained or if the stored level setting is adopted when an instrument configuration is loaded. The setting is valid for both paths. If a suffix is specified, it is ignored.

Parameters:

rcl – INCLude | EXCLude INCLude Takes the current level when an instrument configuration is loaded. EXCLude Retains the current level when an instrument configuration is loaded.

set_ref_level(reference_level: float) → None

# [SOURce<HW>]:POWer:[LEVel]:[IMMediate]:REFLevel
driver.source.power.level.immediate.set_ref_level(reference_level = 1.0)

Queries the reference level of the user correction. The reference level is the sum of the amplitude and the level offset, set with the commands method RsSmw.source.power.power() method RsSmw.source.power.level.immediate.offset() .

Parameters:

reference_level – float Range: -245 to 120