search

ioBroker / ioBroker.echarts

Show all history data in one GUI
Apache License 2.0
19 stars 4 forks source link
charts echarts iobroker

readme

Logo

ioBroker.echarts

Number of Installations Number of Installations NPM version

Test and Release Downloads

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation!

echarts adapter for ioBroker

Build useful charts in ioBroker:

Screenshot

Bars

Radar Use "Actual value" aggregation for predicted result.

Usage

Add after the restart the tab in the admin: Admin

The created preset can be accessed in web adapter too. URL: http://IP:8082/echarts/index.html?preset=echarts.0.PRESETID.

For vis there is a special widget with easy selection of presets.

Tooltip

Lower case i indicates that the value was interpolated from the 2-neighbour values, and it does not exist at this time stamp.

Tooltip

Data from JSON

You can define the data source from JSON. In this case you can create some custom state of type json and store the value like this:

[
  {"ts": 1675887847000, "val": 45},
  {"ts": 1675887848000, "val": 77},
  {"ts": 1675887849000, "val": 180}
]

Alternative following attribute names are supported for val: value, v, data, y. And following for ts: time, t, date.

You cannot define start and start in echarts settings. The start and end will be calculated automatically from the data. Aggregation is not possible either. All manipulations must be done by writing of the JSON data. The chart will be automatically updated every time the value changes.

Server side rendering

You can render the presets on the server and get it as base64 URL or save it on disk on in ioBroker DB:

sendTo('echarts.0', {
    preset:   'echarts.0.myPreset', // the only mandatory attribute

    renderer: 'svg',                // svg | png | jpg | pdf, default: svg

    width: 1024,                    // default 1024
    height: 300,                    // default 300
    background: '#000000',          // Background color
    theme: 'light',                 // Theme type: 'light', 'dark'

    title: 'ioBroker Chart',        // Title of PDF document 
    quality: 0.8,                   // quality of JPG
    compressionLevel: 3,            // Compression level of PNG
    filters: 8,                     // Filters of PNG (Bit combination https://github.com/Automattic/node-canvas/blob/master/types/index.d.ts#L10)

    fileOnDisk: '',                 // Path on disk to save the file. 
    fileName: '',                   // Path in ioBroker DB to save the files on 'echarts.0'. E.g. if your set "chart.svg", so you can access your picture via http(s)://ip:8082/echarts.0/chart.png

    cache:    600,                  // Cache time for this preset in seconds, default: 0 - no cache
}, result => {
    if (result.error) {
        console.error(result.error);
    } else {
        console.log(result.data);
    }
});

Attention: You cannot enable/disable lines in legend on touch devices with enabled zoom

Developer manual

For non-developers, this link does not work!

You can debug view charts locally with:

Todo

1.9.0 (2024-08-06)

1.8.4 (2024-06-21)

1.8.0 (2024-02-03)

1.7.2 (2023-11-20)

1.7.1 (2023-11-16)

1.6.1 (2023-11-08)

1.5.4 (2023-09-13)

1.5.3 (2023-09-12)

1.5.1 (2023-06-14)

1.5.0 (2023-05-17)

1.4.15 (2023-05-10)

1.4.14 (2023-04-20)

1.4.13 (2023-03-14)

1.4.11 (2023-02-25)

1.4.9 (2023-02-22)

1.4.7 (2023-02-22)

1.4.6 (2023-02-16)

1.4.5 (2023-02-16)

1.4.3 (2023-02-15)

1.4.1 (2023-02-14)

1.4.0 (2023-02-13)

1.3.4 (2023-02-08)

1.3.3 (2023-02-08)

1.2.1 (2023-01-31)

1.1.5 (2022-12-31)

1.1.3 (2022-12-01)

1.1.1 (2022-08-23)

1.1.0 (2022-07-05)

1.0.10 (2022-06-20)

1.0.9 (2022-06-17)

1.0.8 (2022-06-01)

1.0.7 (2022-05-13)

1.0.5 (2022-02-16)

1.0.4 (2022-01-31)

1.0.3 (2021-07-21)

1.0.2 (2021-07-20)

1.0.1 (2021-07-14)

1.0.0 (2021-07-02)

0.4.14 (2021-04-29)

0.4.13 (2021-03-27)

0.4.12 (2021-03-27)

0.4.11 (2021-02-06)

0.4.10 (2020-12-22)

0.4.9 (2020-12-21)

0.4.7 (2020-12-13)

0.4.6 (2020-12-12)

0.4.5 (2020-12-11)

0.4.4 (2020-12-07)

0.4.2 (2020-11-29)

0.4.1 (2020-11-29)

0.4.0 (2020-11-28)

0.3.9 (2020-11-28)

0.3.8 (2020-11-27)

0.3.7 (2020-11-17)

0.3.6 (2020-11-13)

0.3.5 (2020-11-10)

0.3.4 (2020-11-08)

0.3.1 (2020-10-31)

0.2.1 (2020-10-25)

0.2.0 (2020-10-22)

0.1.2 (2020-10-21)

0.1.1 (2020-10-21)

License

ioBroker.echarts is available under the Apache License V2.

Copyright (c) 2019-2024 bluefox dogafox@gmail.com

Apache ECharts Copyright (c) 2017-2024 The Apache Software Foundation

This product includes software developed at The Apache Software Foundation (https://www.apache.org/).