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() → 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() → 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: 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: 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