get_data

Get single frame of the data from the instrument

Parameters

wait_reacquire boolean

Wait for a new trigger event

default: false

wait_complete boolean

Wait until complete frame is available

default: false

measurements boolean

When set to True, it returns both the raw data for channels and the computed measurements

default: false

timeout number

Timeout for trigger event if wait_reacquire is true

default: 60

allowed values:0 - inf

units: Seconds

Every data frame is a time series data of points with following structure

"data": {
  "ch1":  [],
  "ch2":  [],
  "time": [],
}

Each element of the data has the same length, set by the max_length parameter of set_timebase and defaulting to 1024 points. Note that depending on the timebase set and the hardware version, the achievable number of points varies. It will never be fewer than half the number of points requested, and is usually within a few percent of requested. This means that user code must be able to process frames whose lengths vary with different timebases.

The returned timebase is guaranteed to include the requested timebase, but may have a small number of extra samples before or after again due to achievable decimation rates. If the precise bounds are important, the user code should trim the returned data to align with the requested timebase.

Below are the examples on how to read the data frame,