Acquire

SCPI Commands :

ACQuire:AVAilable
ACQuire:COUNt
ACQuire:CURRent
ACQuire:AVERage
ACQuire:INTerpolate
ACQuire:TYPE
ACQuire:RESolution
ACQuire:DRESolution
ACQuire:SRReal
ACQuire:RLReal
ACQuire:POMemory
Commands in total: 35
Subgroups: 5
Direct child commands: 11
get_available() → int[source]
# ACQuire:AVAilable
value: int = driver.acquire.get_available()

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

Returns:

acq_cnt: 0 to 4294967295

get_average() → int[source]
# ACQuire:AVERage
value: int = driver.acquire.get_average()

Returns the current number of acquired waveforms that contribute to the average.

Returns:

curr_avg_cnt: 0 to 4294967295

get_count() → int[source]
# ACQuire:COUNt
value: int = driver.acquire.get_count()

Sets the acquisition and average count, which has a double effect:

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

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

Returns:

max_acq_cnt: 1 to 16777215

get_current() → int[source]
# ACQuire:CURRent
value: int = driver.acquire.get_current()

Returns the current number of acquisitions that have been acquired.

Returns:

curr_acq_cnt: 0 to 18446744073709551615

get_dresolution() → float[source]
# ACQuire:DRESolution
value: float = driver.acquire.get_dresolution()

Returns the current digital resolution of the digital channels.

Returns:

dig_res: 1E-15 to 100

get_interpolate() → IntpolMd[source]
# ACQuire:INTerpolate
value: enums.IntpolMd = driver.acquire.get_interpolate()

Selects the interpolation method.

Returns:

intpol_md: SINX | LINear | SMHD

  • LINear: Linear interpolation between two adjacent sample points

  • SINX: Interpolation with a sin(x) /x function.

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

get_po_memory() → bool[source]
# ACQuire:POMemory
value: bool = driver.acquire.get_po_memory()

The command returns 1 if the memory is not sufficient to process the data with the current settings. To solve the problem, reduce the record length or use automatic record length setting.

Returns:

processing_out_of_memory: OFF | ON

get_resolution() → float[source]
# ACQuire:RESolution
value: float = driver.acquire.get_resolution()

Returns the current resolution. The resolution is the time between two waveform samples in the waveform record. It considers the processing of the captured samples including interpolation. A fine resolution with low values produces a more precise waveform record. The resolution is the reciprocal of the sample rate. You can query the minimum and maximum values with <command>? MIN and <command>? MAX.

Returns:

resolution: 1E-15 to 100

get_rl_real() → int[source]
# ACQuire:RLReal
value: int = driver.acquire.get_rl_real()

Returns the internal record length used by the acquisition system.

Returns:

hw_record_len: 2 to 4294967295

get_sr_real() → float[source]
# ACQuire:SRReal
value: float = driver.acquire.get_sr_real()

Returns the sample rate of the waveform after HW processing. Interpolation is not considered. This value is shown in the acquisition label above the diagram. You can query the minimum and maximum values with <command>? MIN and <command>? MAX.

Returns:

hw_sample_rate: 2 to ADC sample rate

get_type_py() → AcqMd[source]
# ACQuire:TYPE
value: enums.AcqMd = driver.acquire.get_type_py()

Sets how the waveform is built from the captured samples.

set_count(max_acq_cnt: int) → None[source]
# ACQuire:COUNt
driver.acquire.set_count(max_acq_cnt = 1)

Sets the acquisition and average count, which has a double effect:

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

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

Parameters:

max_acq_cnt – 1 to 16777215

set_interpolate(intpol_md: IntpolMd) → None[source]
# ACQuire:INTerpolate
driver.acquire.set_interpolate(intpol_md = enums.IntpolMd.LINear)

Selects the interpolation method.

Parameters:

intpol_md –

SINX | LINear | SMHD

  • LINear: Linear interpolation between two adjacent sample points

  • SINX: Interpolation with a sin(x) /x function.

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

set_resolution(resolution: float) → None[source]
# ACQuire:RESolution
driver.acquire.set_resolution(resolution = 1.0)

Returns the current resolution. The resolution is the time between two waveform samples in the waveform record. It considers the processing of the captured samples including interpolation. A fine resolution with low values produces a more precise waveform record. The resolution is the reciprocal of the sample rate. You can query the minimum and maximum values with <command>? MIN and <command>? MAX.

Parameters:

resolution – 1E-15 to 100

set_sr_real(hw_sample_rate: float) → None[source]
# ACQuire:SRReal
driver.acquire.set_sr_real(hw_sample_rate = 1.0)

Returns the sample rate of the waveform after HW processing. Interpolation is not considered. This value is shown in the acquisition label above the diagram. You can query the minimum and maximum values with <command>? MIN and <command>? MAX.

Parameters:

hw_sample_rate – 2 to ADC sample rate

set_type_py(acq_md: AcqMd) → None[source]
# ACQuire:TYPE
driver.acquire.set_type_py(acq_md = enums.AcqMd.AVERage)

Sets how the waveform is built from the captured samples.

Parameters:

acq_md – SAMPle | PDETect | ENVelope | AVERage

Cloning the Group

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

Subgroups