Acquire

SCPI Commands :

ACQuire:AVAilable
ACQuire:COUNt
ACQuire:CURRent
ACQuire:INTerpolate
ACQuire:RESolution
ACQuire:DRESolution
ACQuire:ZRESolution
ACQuire:SRATe
ACQuire:SRReal
ACQuire:MUWaveform
ACQuire:CDTA

Commands in total: 25

Subgroups: 3

Direct child commands: 11

get_available() → int

# ACQuire:AVAilable
value: int = driver.acquire.get_available()

Returns the number of acquisitions that is saved in the memory. This number of acquisitions is available for history viewing. It is also the number of acquisitions in a fast segmentation acquisition series.

Returns:

acq_cnt: 0 to 4294967295

get_cdta() → bool

# ACQuire:CDTA
value: bool = driver.acquire.get_cdta()

Sets the acquisition mode and the waveform arithmetic of all channels to the last set value. If the acquisition settings are coupled, method RsRtx.acquire.mu_waveform() is not relevant, only one waveform per channel can be used.

get_count() → int

# ACQuire:COUNt
value: int = driver.acquire.get_count()

The acquisition and average count has a double effect:

• It sets the number of waveforms acquired with method RsRtx.run.single() .

• It defines the number of waveforms used to calculate the average waveform.

Returns:

max_acq_cnt: 1 to 16.7772E+6

get_current() → int

# ACQuire:CURRent
value: int = driver.acquire.get_current()

Shows the current number of acquisitions that have been acquired.

Returns:

curr_acq_cnt: 0 to 4.29497E+9

get_dresolution() → float

# ACQuire:DRESolution
value: float = driver.acquire.get_dresolution()

Returns the current digital resolution of the digital channels.

get_interpolate() → AcqIntpolationMode

# ACQuire:INTerpolate
value: enums.AcqIntpolationMode = driver.acquire.get_interpolate()

Selects the interpolation method.

Returns:

intpol_md: LINear | SINX | SMHD

• LINear: Linear interpolation between two adjacent sample points

• SINX: Interpolation by means of a sin(x) /x curve.

• SMHD: Sample/Hold causes a histogram-like interpolation.

get_mu_waveform() → bool

# ACQuire:MUWaveform
value: bool = driver.acquire.get_mu_waveform()

For each channel, up to three waveforms can be shown and analyzed. The decimation mode and the waveform arithmetic are specific for each waveform. So you can analyze several aspects of the signal: For example, waveform1 shows the peaks, and waveform2 shows the average of the signal.

Returns:

multi_waveform: OFF | ON

get_resolution() → float

# ACQuire:RESolution
value: float = driver.acquire.get_resolution()

Indicates the time between two waveform points in the record.

Returns:

resolution: A fine resolution with low values produces a more precise waveform record.

get_sr_real() → float

# ACQuire:SRReal
value: float = driver.acquire.get_sr_real()

Sets the number of captured waveform points per second. It considers the samples of the ADC, and the reduction of waveform points by decimation. If interpolation is not active, the sample rate is the reciprocal value of the resolution and thus also depends on the acquisition time and the record length. If interpolation is active, the sample rate is limited to the ADC sample rate.

Returns:

real_sample_rate: 20 Gsample/s, R&S RTP with serial number ≥ 103000 in interleaved mode (2 channels) : 40 Gsample/s

get_symbol_rate() → float

# ACQuire:SRATe
value: float = driver.acquire.get_symbol_rate()

Defines the sample rate, that is the number of recorded waveform samples per second.

Returns:

sample_rate: 20 Gsample/s, R&S RTP with serial number ≥ 103000 in interleaved mode (2 channels) : 40 Gsample/s

get_zresolution() → float

# ACQuire:ZRESolution
value: float = driver.acquire.get_zresolution()

Returns the current resolution of the R&S RT-ZVCmulti-channel power probe channel.

Returns:

zui_resolution: 1E-15 to 0.5

set_cdta(cpl_dec_md_tr_artm: bool) → None

# ACQuire:CDTA
driver.acquire.set_cdta(cpl_dec_md_tr_artm = False)

Sets the acquisition mode and the waveform arithmetic of all channels to the last set value. If the acquisition settings are coupled, method RsRtx.acquire.mu_waveform() is not relevant, only one waveform per channel can be used.

Parameters:

cpl_dec_md_tr_artm – OFF | ON

set_count(max_acq_cnt: int) → None

# ACQuire:COUNt
driver.acquire.set_count(max_acq_cnt = 1)

The acquisition and average count has a double effect:

• It sets the number of waveforms acquired with method RsRtx.run.single() .

• It defines the number of waveforms used to calculate the average waveform.

Parameters:

max_acq_cnt – 1 to 16.7772E+6

set_interpolate(intpol_md: AcqIntpolationMode) → None

# ACQuire:INTerpolate
driver.acquire.set_interpolate(intpol_md = enums.AcqIntpolationMode.LINear)

Selects the interpolation method.

Parameters:

intpol_md –

LINear | SINX | SMHD

• LINear: Linear interpolation between two adjacent sample points

• SINX: Interpolation by means of a sin(x) /x curve.

• SMHD: Sample/Hold causes a histogram-like interpolation.

set_mu_waveform(multi_waveform: bool) → None

# ACQuire:MUWaveform
driver.acquire.set_mu_waveform(multi_waveform = False)

For each channel, up to three waveforms can be shown and analyzed. The decimation mode and the waveform arithmetic are specific for each waveform. So you can analyze several aspects of the signal: For example, waveform1 shows the peaks, and waveform2 shows the average of the signal.

Parameters:

multi_waveform – OFF | ON

set_resolution(resolution: float) → None

# ACQuire:RESolution
driver.acquire.set_resolution(resolution = 1.0)

Indicates the time between two waveform points in the record.

Parameters:

resolution – A fine resolution with low values produces a more precise waveform record.

set_sr_real(real_sample_rate: float) → None

# ACQuire:SRReal
driver.acquire.set_sr_real(real_sample_rate = 1.0)

Sets the number of captured waveform points per second. It considers the samples of the ADC, and the reduction of waveform points by decimation. If interpolation is not active, the sample rate is the reciprocal value of the resolution and thus also depends on the acquisition time and the record length. If interpolation is active, the sample rate is limited to the ADC sample rate.

Parameters:

real_sample_rate – 20 Gsample/s, R&S RTP with serial number ≥ 103000 in interleaved mode (2 channels) : 40 Gsample/s

set_symbol_rate(sample_rate: float) → None

# ACQuire:SRATe
driver.acquire.set_symbol_rate(sample_rate = 1.0)

Defines the sample rate, that is the number of recorded waveform samples per second.

Parameters:

sample_rate – 20 Gsample/s, R&S RTP with serial number ≥ 103000 in interleaved mode (2 channels) : 40 Gsample/s

Cloning the Group

# Create a copy of the original group, that exists independently
acquire_copy = driver.acquire.clone()

Subgroups

• Areset
  • Immediate
• Points
• Segmented