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]
# [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 RsSmbv.output.state.value() (‘RF On’/’RF Off’) . The following applies POWer = RF output level + OFFSet, where:

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

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

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

Returns:

amplitude: float The following settings influence the value range: OFFSet set with the method RsSmbv.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 RsSmbv.source.power.step.increment() . Range: (Level_min + OFFSet) to (Level_max + OFFStet) , Unit: dBm

get_offset() float[source]
# [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 RsSmbv.source.power.level.immediate.amplitude() . See ‘RF frequency and level display with a downstream instrument’. Note: The level offset also affects the RF level sweep.

Returns:

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

get_recall() InclExcl[source]
# [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.

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]
# [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 RsSmbv.source.power.power() method RsSmbv.source.power.level.immediate.offset() .

Returns:

reference_level: float Range: -245 to 120

set_amplitude(amplitude: float) None[source]
# [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 RsSmbv.output.state.value() (‘RF On’/’RF Off’) . The following applies POWer = RF output level + OFFSet, where:

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

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

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

Parameters:

amplitude – float The following settings influence the value range: OFFSet set with the method RsSmbv.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 RsSmbv.source.power.step.increment() . Range: (Level_min + OFFSet) to (Level_max + OFFStet) , Unit: dBm

set_offset(offset: float) None[source]
# [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 RsSmbv.source.power.level.immediate.amplitude() . See ‘RF frequency and level display with a downstream instrument’. Note: The level offset also affects the RF level sweep.

Parameters:

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

set_recall(rcl: InclExcl) None[source]
# [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.

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]
# [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 RsSmbv.source.power.power() method RsSmbv.source.power.level.immediate.offset() .

Parameters:

reference_level – float Range: -245 to 120