The first time you access your Chart view, it will populate with chart items displaying values obtained from the meter registers configured under Setup → Other settings, then Installation to the left. By default, all configured registers will be included. This section covers functionality related to customizing your chart views.
If your eGauge meter has not been configured, please see: eGauge meter configuration for details.
Items in the Chart Main Menu
These functions are accessed using the menu in the top left corner of the page. Tap or click the menu, then tap or click "Chart" and select the desired function.
- Save config to meter - Choose this option to save changes you've made to your chart to the meter. This allows a chart setup to be available to load for other users or additional web browsers if you access your meter on multiple computers.
- Load config from meter - Choose this option to load a previously saved chart setup to your web browser, or to update your browser with changes that have been saved to the meter on a different computer.
- Name this setup - Give a custom name to the current chart setup.
- Create empty setup - Start fresh with a blank chart.
- Manage Setups - Manage your list of previously saved chart setups. Here you can delete, rename or make a copy of a previously saved chart setup.
- Download chart data - Chart data can be downloaded for use in external processing. The resulting export will only contain values for Curve-type chart items. These values are paired with both a Unix timestamp and standard date and time value for ease of processing. The values themselves are instantaneous values which are automatically presented in a granularity based on the time frame displayed in the chart. For more control over exported data you may choose to use the Export function from the main menu, or the JSON API.
- Edit functions - (Advanced) Allows for Javascript functions to be added as chart items. For advanced users familiar with writing Javascript this feature can be used to make more complex calculations than may be possible in a simple formula register. For more information see: Editing Chart Functions
Viewing and Editing Chart items
The settings and appearance of Chart items can be edited by long pressing on the Chart item until the 'Edit Chart item' dialog box appears.
Rearranging, Adding and Deleting Chart items
To rearrange the order if the items in your list, first disable the register synchronization function by clicking the circular arrow icon at the upper right side of the Chart items list. When synchronization is disabled, the button will show as greyed out.
Next, enable the 'Rearrange' function by clicking the double-arrow icon.
When this function is active you can click and drag items to rearrange the order in which they appear in the list.
To Delete a chart item while the 'rearrange' function is active click the x for that Chart item in the list.
To add a Chart item to an existing chart setup, click the 'Add item to display' icon
For more detail on the type of items that can be added to a Chart setup and related settings, expand the appropriate section below:
Curve
A curve is simply a line generated from the values contained within a register in the eGauge's database. This is the most commonly used chart item. In this example, we'll graph the value of the Usage register (which is meant to record total site usage).
- Value to graph - register used to populate the chart item with data. In essence, the actual value used to generate the line.
- Name of item - name to display on the chart and chart item list. Completely arbitrary, but should make sense to the user.
- Line style - allows the user to define a line color and/or line style (solid, dashed, dot-dash) for the chart item. The "Customize color" option can be selected to choose a specific color or enter a HEX code for the desired color.
Advanced options - Check the option box to edit
- Physical unit - This setting will change the physical unit the reading is displayed in.
- Flip sign of graphed value - unlike the Classic eGauge UI, the chart will graph negative values below the x-axis and positive values above the x-axis. To maintain the desired layout, it may be necessary to flip the polarity of one or more registers so they all graph above or below the x-axis.
- Show accrued value - graphs a cumulative value instead of an average value. In essence, this displays a graph of the total value for a register. For most registers, this would be an ever increasing or decreasing line. When this option is selected, a new dropdown "Accrue since" will appear to select the start of recording for this register (eg, since start of hour, since start of day, and so on). Useful for measurements like pulse counts.
Shaded Area
A shaded area can be used to add emphasis to the chart. There are many uses here, but in this example we'll replicate the shading present in the "Usage" line on the original eGauge UI.
- Name of item - name to display on the chart and register list. Completely arbitrary, but should make sense to the user.
- Lower bound of area - the "bottom" of the shaded area. In this example we're using '0 W'. This dropdown will always display in the unit type for the register being displayed.
- Upper bound of area - the "top" of the shaded area. In this example we're using the value of the "Usage" register
Lower and upper bound can be used to highlight the range between two chart items. This relationship cannot be inverted (eg, shading will display if upper > lower but not if lower > upper). A second shaded area item is needed for this.
- Reported register value - The value reported for the chart item in the chart item list below the chart. Can be left blank, or associated with a register value. In this case, we're using "Usage" since the value of the shaded area and the value of Usage are the same.
- Shade color - allows the user to define a shade color for the shaded area chart item. The "Custom color" option can be selected to choose a specific color or enter a HEX code for the desired color.
Ratio
As its name suggests, the ratio chart item can be used to display the ratio between two values. These values can be obtained from registers, fixed numerical values, or a combination of the two. Unlike the other chart items, a ratio item will only appear in the list of chart items at the bottom of the page (nothing is displayed in the chart itself). In this example, we'll look at the ratio between total usage and electric heat usage.
- Numerator - "top" of the ratio equation. A ratio is simply A/B - this would be value A.
- Denominator - "bottom" of the ratio equation. A ratio is simply A/B - this would be value B.
- Name of item - name to display on the chart and register list. Completely arbitrary, but should make sense to the user.
- Flip sign of reported value - can be used to flip the sign/polarity of the resulting value if desired.
Ratio chart items always return a percentage. In the case of this example, we can say "the Appliances account for approximately 30.54% of the total electrical usage".
After customizing a chart setup, you can save the setup to the eGauge meter by choosing Chart → Save config to meter from the main menu. This is an optional step, but necessary if you want to share your customized chart setup between computers. If you don't save to the meter the customization will only show in the web browser you used to make the changes.
Naming and viewing multiple Chart setups
If you would like to save a customized chart setup you can name it by choosing Chart → Name this setup from the Main Menu.
Once you've named at least one chart setup, a Chart setup list will show in the upper left corner of the Chart view:
Reminder: After making changes, choose Chart → Save config to meter to make your chart setups available if you switch between computers. Chart → Load config from meter will pull saved customization to a new computer or browser.