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]

Commands in total: 17

Subgroups: 3

Direct child commands: 14

get_algorithm() → CfrAlgo

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

Defines the algorithm for crest factor reduction.

Returns:

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

# [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.

Returns:

arb_cfr_canc_pul_bw: float Range: 0 to 250E6

get_cspacing() → float

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

Sets the channel spacing, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to SIMPle.

Returns:

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

get_dcfdelta() → float

# [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.

Returns:

arb_cfr_dcf_delta: float Range: -20 to 0

get_filter_py() → CfrFiltMode

# [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.

Returns:

arb_cfr_filter_mod: SIMPle | ENHanced

get_forder() → int

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

Sets the maximum filter order, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced.

Returns:

arb_cfr_max_file_order: integer Range: 0 to 300

get_iterations() → int

# [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.

Returns:

arb_cfr_max_iter: integer Range: 1 to 10

get_oc_factor() → float

# [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.

Returns:

arb_cfro_crest_factor: float Range: 1 to 100

get_pfreq() → float

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

Sets the passband frequency, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced. Frequency components lower than the passband frequency are passed through unfiltered.

Returns:

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

get_rc_factor() → float

# [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.

Returns:

arb_cfr_res_crest_factor: float Range: 1 to 100

get_sbandwidth() → float

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

Sets the signal bandwidth, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to SIMPle. The value of the signal bandwidth should not be higher than the channel spacing (method RsSmw.source.bb.arbitrary.cfr.cspacing() ) .

Returns:

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

get_sfreq() → float

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

Sets the stopband frequency of the filter, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced. Frequency components higher than the stopband frequency are filtered out by the lowpass filter.

Returns:

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

get_state() → bool

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

Enables the crest factor reduction calculation.

Returns:

arb_cfr_state: 1 | ON | 0| OFF

get_tbandwidth() → float

# [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.

Returns:

dda_rb_cfr_tran_bw: float Range: 0 to 250E6

set_algorithm(arb_cfr_algorithm: CfrAlgo) → None

# [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.

Parameters:

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

# [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.

Parameters:

arb_cfr_canc_pul_bw – float Range: 0 to 250E6

set_cspacing(arb_cfr_chan_spac: float) → None

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

Sets the channel spacing, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to SIMPle.

Parameters:

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

# [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.

Parameters:

arb_cfr_dcf_delta – float Range: -20 to 0

set_filter_py(arb_cfr_filter_mod: CfrFiltMode) → None

# [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.

Parameters:

arb_cfr_filter_mod – SIMPle | ENHanced

set_forder(arb_cfr_max_file_order: int) → None

# [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 method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced.

Parameters:

arb_cfr_max_file_order – integer Range: 0 to 300

set_iterations(arb_cfr_max_iter: int) → None

# [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.

Parameters:

arb_cfr_max_iter – integer Range: 1 to 10

set_pfreq(arb_cfr_pass_band_freq: float) → None

# [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 method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced. Frequency components lower than the passband frequency are passed through unfiltered.

Parameters:

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

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

Sets the signal bandwidth, if method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to SIMPle. The value of the signal bandwidth should not be higher than the channel spacing (method RsSmw.source.bb.arbitrary.cfr.cspacing() ) .

Parameters:

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

# [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 method RsSmw.source.bb.arbitrary.cfr.filter_py() is set to ENHanced. Frequency components higher than the stopband frequency are filtered out by the lowpass filter.

Parameters:

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

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

Enables the crest factor reduction calculation.

Parameters:

arb_cfr_state – 1 | ON | 0| OFF

set_tbandwidth(dda_rb_cfr_tran_bw: float) → None

# [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.

Parameters:

dda_rb_cfr_tran_bw – float Range: 0 to 250E6

Cloning the Group

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

Subgroups

• CfWaveform
• Measure
• Waveform