Online documentation, manuals and tutorials
< All Topics
Print

AddToInstrumentHistory

Description

It is used to add a new item to the History view of the instrument. Currently, only adding chart items or widgets (Tabulator, Plotly or LineChart) are supported.

For example in the Rigol Waveform Data example we have this Action:

Alt text

It is used to add a chart which, after successful addition, will be displayed as follows (example of test signal acquisition):

Alt text

Properties

Specific

Instrument

EXPRESSION (object:Instrument)

An instrument in whose History an item will be added.

Item type

Enum

Item type to be added. It can be "Chart" or "Widget".

Chart description

EXPRESSION (string)

Description of the chart displayed in the instrument History:

Alt text

This property is only available when Item type is Chart.

Chart data

EXPRESSION (blob)

A string or blob containing the samples that will be displayed in the chart.

This property is only available when Item type is Chart.

Chart sampling rate

EXPRESSION (float)

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

This property is only available when Item type is Chart.

Chart offset

EXPRESSION (double)

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 available when Item type is Chart.

Chart scale

EXPRESSION (double)

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

This property is only available when Item type is Chart.

Chart format

EXPRESSION (string)

Format from Chart data. Possible values:

  • "float" – “Chart data” must be a blob containing 32-bit, little-endian float numbers.
  • "double"– “Chart data” must be a blob containing 64-bit, little-endian float numbers.
  • "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 available when Item type is Chart.

Chart unit

EXPRESSION (integer)

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

This property is only available when Item type is Chart.

Chart color

EXPRESSION (string)

The color of the line in the chart if a dark background is selected.

This property is only available when Item type is Chart.

Chart color inverse

EXPRESSION (string)

The color of the line in the chart if the light background is selected.

This property is only available when Item type is Chart.

Chart label

EXPRESSION (string)

Chart label:

Alt text

This property is only available when Item type is Chart.

Chart major subdivision horizontal

EXPRESSION (integer)

Alt text

This property is only available when Item type is Chart.

Chart major subdivision vertical

EXPRESSION (integer)

Alt text

This property is only available when Item type is Chart.

Chart minor subdivision horizontal

EXPRESSION (integer)

Alt text

This property is only available when Item type is Chart.

Chart minor subdivision vertical

EXPRESSION (integer)

Alt text

This property is only available when Item type is Chart.

Chart horizontal scale

EXPRESSION (double)

The number that defines the X-axis zoom factor in the default chart view.

This property is only available when Item type is Chart.

Chart vertical scale

EXPRESSION (double)

The number that defines the Y-axis zoom factor in the default chart view.

This property is only available when Item type is Chart.

Widget

EXPRESSION (widget)

Reference to the Tabulator, Plotly or LineChart widget. See Output widget handle property to find out how to obtain this reference.

This property is only available when Item type is Widget.

Inputs

seqin

SEQ | MANDATORY

A standard sequence input.

Outputs

seqout

SEQ | OPTIONAL

A standard sequence output.

id

DATA(string) | OPTIONAL

ID of the added history item. We can, for example, use this data in the Chart Widget to display the chart history item inside the dashboard.

Examples

  • Rigol Waveform Data
Page content