ioBroker.echarts

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:

Use "Actual value" aggregation for predicted result.

Usage

Add after the restart the tab in the 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.

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:

• cd iobroker.echarts/src-chart
• npm run start
• Browser: http://localhost:8081/adapter/echarts/tab.html?dev=true

Todo

• widget for vis (button)
• show enum icons on folders or near it

Changelog

1.9.5 (2024-12-20)

• (bluefox) Convert actual values with provided "convert" function too

1.9.2 (2024-09-10)

• (bluefox) Fixed polar and bar charts

1.9.0 (2024-08-06)

• (bluefox) upgraded packages
• (bluefox) removed withStyles

1.8.4 (2024-06-21)

• (foxriver76) upgraded dependencies

1.8.0 (2024-02-03)

• (bluefox) Added the radar (polar) chart type

1.7.2 (2023-11-20)

• (bluefox) Added option to hide the value in the future

1.7.1 (2023-11-16)

• (bluefox) Added X-Label offset
• (bluefox) Corrected icons in the object selection dialog

1.6.1 (2023-11-08)

• (bluefox) Added vis-2 widget

1.5.4 (2023-09-13)

• (bluefox) Added an option to the export dialog: select / unselect all
• (bluefox) Added the availability to show legend as dialog

1.5.3 (2023-09-12)

• (bluefox) Added an option to reset zoom and tilt after X seconds of idle

1.5.1 (2023-06-14)

• (bluefox) Error handling in JSON data was improved

1.5.0 (2023-05-17)

• (bluefox) Implemented raw data export

1.4.15 (2023-05-10)

• (bluefox) Allowed using the timestamp in seconds in JSON sources

1.4.14 (2023-04-20)

• (bluefox) Added support for the alternative names for JSON sources

1.4.13 (2023-03-14)

• (bluefox) Corrected some issues from GitHub

1.4.11 (2023-02-25)

• (bluefox) Booleans were improved

1.4.9 (2023-02-22)

• (bluefox) Allowed the disabling of texts for enums and the adding/deletion of own text values

1.4.7 (2023-02-22)

• (bluefox) Implemented custom texts for enums

1.4.6 (2023-02-16)

• (bluefox) Implemented custom texts for true and false values

1.4.5 (2023-02-16)

• (bluefox) Allowed copying only the web URLs in the preview
• (bluefox) Corrected boolean charts

1.4.3 (2023-02-15)

• (bluefox) Implemented charts preview

1.4.1 (2023-02-14)

• (bluefox) Corrected some issues from GitHub
• (bluefox) Implemented negative offset of X-Axis
• (bluefox) Show device names for charts

1.4.0 (2023-02-13)

• (bluefox) Added possibility to load the history data from JSON state.

1.3.4 (2023-02-08)

• (bluefox) Added a formula for the value conversion

1.3.3 (2023-02-08)

• (bluefox) Implemented bar chart

1.2.1 (2023-01-31)

• (bluefox) Changed german translation
• (bluefox) Added new positions for markings: inside, top, bottom

1.1.5 (2022-12-31)

• (bluefox) Refactoring and packages update done

1.1.3 (2022-12-01)

• (bluefox) Make all buttons smaller

1.1.1 (2022-08-23)

• (bluefox) Added preparations for vis2.0

1.1.0 (2022-07-05)

• (bluefox) Made it work with ioBroker cloud
• (bluefox) GUI migrated to mui5

1.0.10 (2022-06-20)

• (bluefox) Corrected the problem with socket.io

1.0.9 (2022-06-17)

• (bluefox) Added 2 weeks as a relative period

1.0.8 (2022-06-01)

• (bluefox) Added option shift+mouse move to scale Y axis

1.0.7 (2022-05-13)

• (bluefox) Added background to export image
• (bluefox) Added integral and percentile aggregate methods

1.0.5 (2022-02-16)

• (bluefox) Added "i" in tooltips by interpolated values

1.0.4 (2022-01-31)

• (bluefox) License changed to Apache-2.0 (because of apache/echarts)
• (bluefox) Updated some packages
• (bluefox) Added fast properties editor

1.0.3 (2021-07-21)

• (bluefox) Fixed server-side rendering

1.0.2 (2021-07-20)

• (bluefox) Fixed the communication with admin4

1.0.1 (2021-07-14)

• (bluefox) Fixed the "no background" option

1.0.0 (2021-07-02)

• (bluefox) Fixed many bugs

0.4.14 (2021-04-29)

• (bluefox) Fixed reorder of presets

0.4.13 (2021-03-27)

• (bluefox) Tried to sort the time series before displaying it

0.4.12 (2021-03-27)

• (bluefox) Added the support of parameters in URL

0.4.11 (2021-02-06)

• (bluefox) Fixed the dashed lines

0.4.10 (2020-12-22)

• (bluefox) Allow the hiding of lines at start and show them via legend later
• (bluefox) Use canvas renderer on touch devices to allow zoom and pan

0.4.9 (2020-12-21)

• (bluefox) Updated echarts to 5.0
• (bluefox) Implemented copy&paste of lines and markings
• (bluefox) Available vertical legend
• (bluefox) Allowed the hiding the interpolated values in tooltip

0.4.7 (2020-12-13)

• (bluefox) Updated the select ID dialog

0.4.6 (2020-12-12)

• (bluefox) Allowed the same names in different folders

0.4.5 (2020-12-11)

• (bluefox) Some sentry errors were corrected.
• (bluefox) Added the possibility to show actual values in legend.

0.4.4 (2020-12-07)

• (bluefox) Some sentry errors were corrected.

0.4.2 (2020-11-29)

• (bluefox) Corrected the error with overflow of axis.

0.4.1 (2020-11-29)

• (bluefox) Disconnection errors are caught now.

0.4.0 (2020-11-28)

• (bluefox) Added new option: no background

0.3.9 (2020-11-28)

• (bluefox) Corrected error with the chart.

0.3.8 (2020-11-27)

• (bluefox) Implemented the conversion of the flot presets into echarts.

0.3.7 (2020-11-17)

• (bluefox) Hide nulls in hover details

0.3.6 (2020-11-13)

• (bluefox) The copy of charts is implemented

0.3.5 (2020-11-10)

• (bluefox) Corrected SENTRY errors

0.3.4 (2020-11-08)

• (bluefox) Corrected server-side rendering of PNG

0.3.1 (2020-10-31)

• (bluefox) Added the color of export button
• (bluefox) The interpolated values are shown now
• (bluefox) Server-side rendering is implemented

0.2.1 (2020-10-25)

• (bluefox) GUI fixes

0.2.0 (2020-10-22)

• (bluefox) Implemented the grouping by the category.

0.1.2 (2020-10-21)

• (bluefox) Added support for multiple charts

0.1.1 (2020-10-21)

• (bluefox) initial release

License

ioBroker.echarts is available under the Apache License V2.

Copyright (c) 2019-2024 bluefox [email protected]

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

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