Cfr

SCPI Commands :

[SOURce<HW>]:BB:ARBitrary:CFR:ALGorithm
[SOURce<HW>]:BB:ARBitrary:CFR:CPBandwidth
[SOURce<HW>]:BB:ARBitrary:CFR:CSPacing
[SOURce<HW>]:BB:ARBitrary:CFR:DCFDelta
[SOURce<HW>]:BB:ARBitrary:CFR:FILTer
[SOURce<HW>]:BB:ARBitrary:CFR:FORDer
[SOURce<HW>]:BB:ARBitrary:CFR:ITERations
[SOURce<HW>]:BB:ARBitrary:CFR:OCFactor
[SOURce<HW>]:BB:ARBitrary:CFR:PFReq
[SOURce<HW>]:BB:ARBitrary:CFR:RCFactor
[SOURce<HW>]:BB:ARBitrary:CFR:SBANdwidth
[SOURce<HW>]:BB:ARBitrary:CFR:SFReq
[SOURce<HW>]:BB:ARBitrary:CFR:TBANdwidth
[SOURce<HW>]:BB:ARBitrary:CFR:[STATe]

class CfrCls

Cfr commands group definition. 17 total commands, 3 Subgroups, 14 group commands

get_algorithm() → RsSmbv.enums.CfrAlgo

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:ALGorithm
value: enums.CfrAlgo = driver.source.bb.arbitrary.cfr.get_algorithm()

Defines the algorithm for crest factor reduction.

return

arb_cfr_algorithm: CLFiltering| PCANcellation CLFiltering Clipping and filtering algorithm. This algorithm performs a hard clipping of the baseband signal. It is followed by a low pass filtering of the result in an iterative manner until the target crest factor is reached. You can define the settings of the filter that is used for the calculation. PCANcellation Peak cancelation algorithm. This algorithm subtracts Blackman windowed sinc pulses from the signal wherever the amplitude is above a defined threshold.

get_cp_bandwidth() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:CPBandwidth
value: float = driver.source.bb.arbitrary.cfr.get_cp_bandwidth()

Sets the cancellation pulse bandwidth for peak cancellation CFR algorithm.

return

arb_cfr_canc_pul_bw: float Range: 0 to 250E6

get_cspacing() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:CSPacing
value: float = driver.source.bb.arbitrary.cfr.get_cspacing()

Sets the channel spacing, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to SIMPle.

return

arb_cfr_chan_spac: float Range: 0 to depends on the sample rate of the loaded file

get_dcfdelta() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:DCFDelta
value: float = driver.source.bb.arbitrary.cfr.get_dcfdelta()

Sets the value difference by which you want to change your crest factor.

return

arb_cfr_dcf_delta: float Range: -20 to 0

get_filter_py() → RsSmbv.enums.CfrFiltMode

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:FILTer
value: enums.CfrFiltMode = driver.source.bb.arbitrary.cfr.get_filter_py()

Selects which filter mode is used for the filtering.

return

arb_cfr_filter_mod: SIMPle| ENHanced

get_forder() → int

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:FORDer
value: int = driver.source.bb.arbitrary.cfr.get_forder()

Sets the maximum filter order, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced.

return

arb_cfr_max_file_order: integer Range: 0 to 300

get_iterations() → int

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:ITERations
value: int = driver.source.bb.arbitrary.cfr.get_iterations()

Sets the number of iterations that are used for calculating the resulting crest factor. The iteration process is stopped when the desired crest factor delta is achieved by 0.1 dB.

return

arb_cfr_max_iter: integer Range: 1 to 10

get_oc_factor() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:OCFactor
value: float = driver.source.bb.arbitrary.cfr.get_oc_factor()

Queries the original crest factor of the waveform after the calculation of the resulting crest factor is completed. The original crest factor is calculated as an average over the whole waveform, including any idle periods that might be present in TDD waveforms.

return

arb_cfro_crest_factor: float Range: 1 to 100

get_pfreq() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:PFReq
value: float = driver.source.bb.arbitrary.cfr.get_pfreq()

Sets the passband frequency, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced. Frequency components lower than the passband frequency are passed through unfiltered.

return

arb_cfr_pass_band_freq: float Range: 0 to depends on the sample rate of the loaded file

get_rc_factor() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:RCFactor
value: float = driver.source.bb.arbitrary.cfr.get_rc_factor()

Queries the resulting crest factor of the waveform after the calculations are completed. The resulting crest factor is calculated as an average over the whole waveform, including any idle periods that might be present in TDD waveforms.

return

arb_cfr_res_crest_factor: float Range: 1 to 100

get_sbandwidth() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:SBANdwidth
value: float = driver.source.bb.arbitrary.cfr.get_sbandwidth()

Sets the signal bandwidth, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to SIMPle. The value of the signal bandwidth should not be higher than the channel spacing ([:SOURce<hw>]:BB:ARBitrary:CFR:CSPacing) .

return

arb_cfr_signal_bw: float Range: 0 to depends on the sample rate of the loaded file

get_sfreq() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:SFReq
value: float = driver.source.bb.arbitrary.cfr.get_sfreq()

Sets the stopband frequency of the filter, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced. Frequency components higher than the stopband frequency are filtered out by the lowpass filter.

return

arb_cfr_stop_band_freq: float Range: 0 to depends on the sample rate of the loaded file

get_state() → bool

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:[STATe]
value: bool = driver.source.bb.arbitrary.cfr.get_state()

Enables the crest factor reduction calculation.

return

arb_cfr_state: 1| ON| 0| OFF

get_tbandwidth() → float

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:TBANdwidth
value: float = driver.source.bb.arbitrary.cfr.get_tbandwidth()

Sets the transition bandwidth of the cancellation pulse for peak cancellation CFR algorithm.

return

dda_rb_cfr_tran_bw: float Range: 0 to 250E6

set_algorithm(arb_cfr_algorithm: RsSmbv.enums.CfrAlgo) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:ALGorithm
driver.source.bb.arbitrary.cfr.set_algorithm(arb_cfr_algorithm = enums.CfrAlgo.CLFiltering)

Defines the algorithm for crest factor reduction.

param arb_cfr_algorithm

CLFiltering| PCANcellation CLFiltering Clipping and filtering algorithm. This algorithm performs a hard clipping of the baseband signal. It is followed by a low pass filtering of the result in an iterative manner until the target crest factor is reached. You can define the settings of the filter that is used for the calculation. PCANcellation Peak cancelation algorithm. This algorithm subtracts Blackman windowed sinc pulses from the signal wherever the amplitude is above a defined threshold.

set_cp_bandwidth(arb_cfr_canc_pul_bw: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:CPBandwidth
driver.source.bb.arbitrary.cfr.set_cp_bandwidth(arb_cfr_canc_pul_bw = 1.0)

Sets the cancellation pulse bandwidth for peak cancellation CFR algorithm.

param arb_cfr_canc_pul_bw

float Range: 0 to 250E6

set_cspacing(arb_cfr_chan_spac: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:CSPacing
driver.source.bb.arbitrary.cfr.set_cspacing(arb_cfr_chan_spac = 1.0)

Sets the channel spacing, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to SIMPle.

param arb_cfr_chan_spac

float Range: 0 to depends on the sample rate of the loaded file

set_dcfdelta(arb_cfr_dcf_delta: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:DCFDelta
driver.source.bb.arbitrary.cfr.set_dcfdelta(arb_cfr_dcf_delta = 1.0)

Sets the value difference by which you want to change your crest factor.

param arb_cfr_dcf_delta

float Range: -20 to 0

set_filter_py(arb_cfr_filter_mod: RsSmbv.enums.CfrFiltMode) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:FILTer
driver.source.bb.arbitrary.cfr.set_filter_py(arb_cfr_filter_mod = enums.CfrFiltMode.ENHanced)

Selects which filter mode is used for the filtering.

param arb_cfr_filter_mod

SIMPle| ENHanced

set_forder(arb_cfr_max_file_order: int) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:FORDer
driver.source.bb.arbitrary.cfr.set_forder(arb_cfr_max_file_order = 1)

Sets the maximum filter order, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced.

param arb_cfr_max_file_order

integer Range: 0 to 300

set_iterations(arb_cfr_max_iter: int) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:ITERations
driver.source.bb.arbitrary.cfr.set_iterations(arb_cfr_max_iter = 1)

Sets the number of iterations that are used for calculating the resulting crest factor. The iteration process is stopped when the desired crest factor delta is achieved by 0.1 dB.

param arb_cfr_max_iter

integer Range: 1 to 10

set_pfreq(arb_cfr_pass_band_freq: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:PFReq
driver.source.bb.arbitrary.cfr.set_pfreq(arb_cfr_pass_band_freq = 1.0)

Sets the passband frequency, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced. Frequency components lower than the passband frequency are passed through unfiltered.

param arb_cfr_pass_band_freq

float Range: 0 to depends on the sample rate of the loaded file

set_sbandwidth(arb_cfr_signal_bw: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:SBANdwidth
driver.source.bb.arbitrary.cfr.set_sbandwidth(arb_cfr_signal_bw = 1.0)

Sets the signal bandwidth, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to SIMPle. The value of the signal bandwidth should not be higher than the channel spacing ([:SOURce<hw>]:BB:ARBitrary:CFR:CSPacing) .

param arb_cfr_signal_bw

float Range: 0 to depends on the sample rate of the loaded file

set_sfreq(arb_cfr_stop_band_freq: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:SFReq
driver.source.bb.arbitrary.cfr.set_sfreq(arb_cfr_stop_band_freq = 1.0)

Sets the stopband frequency of the filter, if [:SOURce<hw>]:BB:ARBitrary:CFR:FILTer is set to ENHanced. Frequency components higher than the stopband frequency are filtered out by the lowpass filter.

param arb_cfr_stop_band_freq

float Range: 0 to depends on the sample rate of the loaded file

set_state(arb_cfr_state: bool) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:[STATe]
driver.source.bb.arbitrary.cfr.set_state(arb_cfr_state = False)

Enables the crest factor reduction calculation.

param arb_cfr_state

1| ON| 0| OFF

set_tbandwidth(dda_rb_cfr_tran_bw: float) → None

# SCPI: [SOURce<HW>]:BB:ARBitrary:CFR:TBANdwidth
driver.source.bb.arbitrary.cfr.set_tbandwidth(dda_rb_cfr_tran_bw = 1.0)

Sets the transition bandwidth of the cancellation pulse for peak cancellation CFR algorithm.

param dda_rb_cfr_tran_bw

float Range: 0 to 250E6

Cloning the Group

# Create a clone of the original group, that exists independently
group2 = driver.source.bb.arbitrary.cfr.clone()

Subgroups

• CfWaveform
• Measure
• Waveform