Online documentation, manuals and tutorials
< All Topics
Print

EEZChart

Description

Displays a line chart using the same Widget as in the Instrument History panel.

Properties

Specific

Chart mode

Enum

The following modes are available:

  • Single chart – Displays a single chart.
  • Multiple charts – Displays multiple charts.
  • EEZ DLOG – Displays the chart given by the EEZ DLOG file format.
  • Instrument History Item – Displays a chart from the instrument history.

Chart data

EXPRESSION (any)

If Chart mode is set to Single chart, then a string, array or blob containing the samples that will be displayed in the chart should be set here. If Chart mode is set to EEZ DLOG then the content of the EEZ DLOG file should be set here (e.g. it can be read with FileRead Action, see EEZ Chart example).

This property is not used when the Chart mode is Multiple charts or Instrument History item.

Format

EXPRESSION (string)

Format of Data property. Possible values:

  • "float" – “Chart data” must be a blob containing 32-bit, little-endian float numbers, or array:float
  • "double" – “Chart data” must be a blob containing 64-bit, little-endian float numbers, or array:float
  • "rigol-byte" – “Chart data” must be a blob containing 8-bit unsigned integer numbers
  • "rigol-word" – “Chart data” must be a blob containing 16-bit unsigned integer numbers
  • "csv" – “Chart data” must be a CSV string, the first column is taken

This property is only used when the Chart mode is Single chart.

Sampling rate

EXPRESSION (integer)

Sampling rate or number of samples per second (SPS).

This property is only used when the Chart mode is Single chart.

Unit name

EXPRESSION (integer)

The unit displayed on the Y-axis. The X-axis is always time.

This property is only used when the Chart mode is Single chart.

Color

EXPRESSION (string)

The color of the line in the chart.

This property is only used when the Chart mode is Single chart.

Label

EXPRESSION (string)

Chart label:

Alt text

This property is only used when the Chart mode is Single chart.

Offset

EXPRESSION (string)

Offset value used in formula offset + sample_value * scale which transforms sample value to sample position on y axis in the chart.

This property is only used when the Chart mode is Single chart.

Scale

EXPRESSION (string)

When displaying samples, the formula offset + sample_value * scale is used.

This property is only used when the Chart mode is Single chart.

Charts

Array

List of chart definitions when Chart mode is set to Multiple charts. Each definition contains these properties:

  • Chart data
  • Format
  • Sampling rate
  • Unit
  • Color
  • Label
  • Offset
  • Scale

These properties have the same meaning as the corresponding property when Single chart mode is selected.

History item ID

EXPRESSION (string)

This ID is obtained using AddToInstrumentHistory action through id output of that action.

This property is only used when the Chart mode is Instrument History Item.

Visible

EXPRESSION (boolean)

If the calculated expression is true then the Widget is visible, and if it is false then the Widget is hidden. It can be left blank, in which case the Widget is always visible.

Examples

  • Line Chart
  • EEZ Chart
  • Rigol Waveform Data
Page content