Data Retrieval

Poll the driver for the latest streamed data on a single channel/mode.

To drain several channels (or RAW plus a downsampled mode) coherently in one driver call, use :meth:get_streaming_latest_values_multi.

Poll the driver for the latest streamed data on several channel/mode combinations in a single call.

The driver fills every requested buffer set from the same snapshot, so multi-channel captures (or simultaneous RAW + downsampled streaming) stay sample-aligned. Polling channels one at a time with :meth:get_streaming_latest_values returns misaligned snapshots.

Return an array of time values based on the timebase and number of samples

Retrieves a block of captured samples from the device once it's ready. If a channel goes over-range a warning will appear.

This function should be called after confirming the device is ready using is_ready(). It invokes the underlying PicoSDK GetValues function to read the data into memory.

Retrieve data from multiple memory segments.

Retrieve overlapped data from multiple segments for block or rapid block mode.

Call this method before :meth:run_block_capture to defer the data retrieval request. The driver validates and performs the request when :meth:run_block_capture runs, which avoids the extra communication that occurs when calling :meth:run_block_capture followed by :meth:get_values. After the capture completes you can call :meth:get_values again to retrieve additional copies of the data. Stop further captures with :meth:stop_using_get_values_overlapped and check progress using :meth:ps6000a.PicoScope.get_no_of_processed_captures.

Examples:

>>> samples = scope.get_values_overlapped(
...     start_index=0,              # read from start of buffer
...     no_of_samples=1024,         # copy 1024 samples
...     down_sample_ratio=1,        # no downsampling
...     down_sample_ratio_mode=RATIO_MODE.RAW,
...     from_segment_index=0,       # first segment only
...     to_segment_index=0,
... )
>>> scope.run_block_capture(timebase=1, samples=1024)
>>> data = scope.get_values(samples=1024)
>>> samples, scope.over_range
(1024, 0)

Check if the LED is flashing.

Logs and prints a warning if any channel has been over range.

The :attr:over_range attribute stores a bit mask updated by data retrieval methods like :meth:get_values and :meth:get_values_overlapped. Calling this method logs a warning if any channel went over range and returns a list of the affected channel names.

Blocks execution until the PicoScope device is ready.

Continuously calls the PicoSDK IsReady function in a loop, checking if the device is prepared to proceed with data acquisition.

Return the number of values currently available while streaming.