Line chart
Last updated
Last updated
The Line chart widget in DataVista enables you to effortlessly compare two Homey insights in a single graph. This unique feature allows you to visualize and analyze the relationship between different data points, such as energy usage and temperature, side by side. With its intuitive design, the widget helps you uncover patterns and correlations, offering deeper insights into your Homey data.
Additionally, you can click on any data point within the chart to view more detailed information in a tooltip, providing a more granular look at the data for further analysis.
The widget currently supports displaying Homey insights, allowing you to visualize and compare different data points.
To add the toggle switch widget to your dashboard, follow these simple steps:
Open your Homey app and go to the Dashboards section.
Enter Edit Mode and select the "Add Widget" button.
Select "Apps" at the top and look for the app called "DataVista".
Look for the "Line chart" widget. You can easily identify it by the preview image (as shown below).
Once you find it, click on the widget preview to add it to your dashboard.
After adding it, you can customize the widget to display a specific Homey insight.
The widget has the following configurable settings:
Timeframe
Determines the period for which data is displayed in the chart. Options include day, week, month, or year.
Datasource 1
Choose a Homey insights source to display as the first data series in the chart. This will represent the primary data being visualized.
Period 1
Specifies the period (this or previous) to display for datasource 1, relative to the selected timeframe.
Color 1
Sets the color for the data series associated with datasource 1, allowing you to distinguish it from datasource 2.
Overwrite name 1
Allows you to overwrite the default name of the series for DataSource 1. This enables custom naming for better clarity.
Datasource 2
Select a second Homey insights source to display as the second data series in the chart, allowing for comparison with the first datasource.
Period 2
Specifies the period (this or previous) to display for datasource 1, relative to the selected timeframe.
Color 2
Sets the color for the data series associated with datasource 2, allowing you to distinguish it from datasource 1.
Overwrite name 2
Allows you to overwrite the default name of the series for DataSource 2. This enables custom naming for better clarity.
Show Icon
Enable to show the capability or device icon (if available), with priority given to the capability icon.
Show refresh countdown
Option to show or hide the progress bar that indicates the time remaining until the chart refreshes with the latest data.
Y Axis Calculation Method
Choose how the Y-axis range is calculated to determine if one or two Y-axes are required. Options include using the full range, applying the Interquartile Range (IQR) method, or forcing both series to share the same axis. This setting influences whether a second Y-axis is needed based on the range of the datasets.
To display only the primary data source, simply leave datasource 2 unconfigured. Additionally, ensure that the period for datasource 2 (Period 2) is set to the same value as the period for datasource 1 (Period 1). This will ensure consistency in the chart and allow the primary data source to be visualized without the secondary data series.
To compare the same data source for the current period vs the previous one, leave datasource 2 empty. Then, set period 2 to a different period than period 1, such as selecting "this" for period 1 and "previous" for period 2. This will allow you to visualize the comparison between the two periods using the same data source.
The "Y-Axis Calculation Method" setting determines how the Y-axis range is calculated and helps decide whether one or two Y-axes are required.
Full Range: Uses the full range of both datasets to calculate the Y-axis.
Interquartile Range (IQR): Uses the IQR method to exclude outliers and calculate the Y-axis range.
Force Same Axis: Forces both datasets to use the same Y-axis, so no second axis will be rendered.
Yes, the chart refreshes automatically, following the update pattern of the respective Homey insight.
Homey does not yet expose insights specific to both the current and previous hour, which is why this option is not available.
To view more detailed information about a specific data point, simply click on it within the chart. A tooltip will appear with additional context for that data point.
To close the tooltip, click on either the horizontal (x-axis) or vertical (y-axis) axis, and the tooltip will disappear.
