OED Documentation

Line Graphic

Version V0.8.0

The latest version of this page is V1.0.0.

Documentation overview

User documentation
Navigation
Admin documentation
Documentation versions for this page
V1.0.0
V0.8.0 (current page)
V0.7.0
V0.6.0

Overview

A line graphic shows each meter and group as a unique line showing usage across time. The following figure shows a line graphic of two meters (Meter 1 and Meter 2) and one group (Group 1 & 2) where the group contains the same two meters. The hover is shown whenever the curser is over a line and is accurate to 6 significant figures. If you hover over each line then you would see that the sum of the hover values for Meter 1 and Meter 2 is the same as the value for Group 1 & 2 as expected since the group contains these two meters. The time in the hover is 12:00:00 PM which is the middle of the day (noon) and is the same as the x-axis value. On most graphics, except if zoomed in to a small time frame (see below), the x-axis represents the average over multiple meter values as discussed below. The x-axis value is given the middle of the date/time range of values that were averaged. In this case, each point is a full day and goes from midnight to midnight of that day. Thus, the average is in the middle of the day/noon/12:00:00 PM. Each line represents power usage at that time for the indicated meter/group, e.g., kW for electricity. To get this graphic, you click the "Line" choice (highlighted with a blue box) from the "Select a graph type" dropdown menu. line graphic with two meters and a group of those meters

A line graphic can show an arbitrary choice and number of meters and groups. As described below, you can control the time frame (dates shown) on the line graphic.

Usage

You select the meters and/or groups to graph in the usual way. OED will display each meter and group as an individual line as shown in the figure above. For this section the graphics use synthetic data since values are easier to see. In this data, the meters have a constant value for long periods of time. Also, we will often use meters in these sample figures but the same ideas apply equally to groups. The time frame (days) shown on the x-axis will be the maximum time for all all meters and groups. If different meters and group have data for different time ranges then some lines will not span the entire length of the x-axis. The next figure shows this where the Meter C and Meter D do not span the full range of time on the graph so the beginning and end of the graphic does not have values for these two meters. sample line graphic where the meters data is different time frames

This graphic also demonstrates another potential issue. If the values of one or more meters (or groups) are substantially less than another meter (or group) then the values for these meters will be very close to the x-axis. You can see these values by removing the values for the meters or groups with larger values. One way to do this is to remove a meter from graphing by clicking the "X" next to its name in the list (details on the meters/groups viewing help pages). This works but is slower since OED must recalculate the values via the server (see details below). It also means you won't see these meters/groups in other graphics since they were removed. A nice solution is to click on the name of the meter/group at the top of the line graphic. In the next figure, Meter D was clicked (highlighted with blue box) and the graph quickly redrew to what is shown with the y-axis scale re-calibrated for the remaining meters. The meter not being shown is in shadow font. You can click to remove as many lines as desired. removing meters from a line graphic

You can click on a meter/group in shadow font to get it to quickly reappear on the line graphic. Note that going to another graphic will reset the lines shown so any hidden meters will show again.

Scrolling and zooming

Initially, OED shows the line graphic across all time that is available. Sometimes you want to look at a smaller time range. You can achieve this by zooming in the time (x) axis. This is done by clicking and dragging the rectangles with black border below the x-axis (highlighted with blue boxes in the figure below). As you slide the black rectangle, the parts of the x-axis (time) that is removed from the graph is show by a gray filled rectangle (highlighted in light blue boxes but goes also goes to center of rectangle but not highlighted since then hard to see other blue box). The white area between the gray rectangles is the time being shown. In the figure below the original time from of January through December was reduced to March through August. reducing time shown in a line graphic

Note that the time range selected on a line graphic is also used for the Bar Graphic.

Once you are zoomed in so gray areas are shown for the removed time, you can click within these areas to modify the time range shown but the behavior is a little more complex and likely to take time to learn to use.

If only part of the time is shown, then you can scroll to see the other times. The total time displayed remains the same but the times included change as you scroll. You do this by clicking and dragging in the white area below the x-axis that shows the time being displayed (highlighted with blue box in the next figure). The next figure shows the process of dragging where the time displayed has now changed to May through October. scrolling time in a line graphic

If you zoom in significantly so the time range is much smaller than the original time range, the graph can become jagged due to having too few points. Also, you might want to return the graphic to its original, full time range. Both of these are discussed in the next section on the "Redraw" and "Restore" buttons.

Redraw and Restore buttons

The next figure shows the result of zooming in even farther so a limited time range of one month is shown. It also only shows one meter so the effects are easier to see. zooming to a limited time range on a line graphic

As you can see, the line has become vague because the time points are far apart. This happens due to the limited number of points available. (see below for the details of why). If you want to see this time range with more points then click the "Redraw" button (highlighted with a blue box) below the graph. The figure below shows the result of doing this where you can see that many more points are present. In this case it is using the original meter data which is spaced one hour apart. result of redrawing a line graphic

Note that once you do this, the time range is reset so you cannot zoom outward nor scroll to times outside the new range but you can zoom in farther so you can do this. If you want to see other time ranges, you can click the "Restore" button (highlighted with a blue box) and the graph will return to its original view with the time range including all meters. The result of doing this is shown in the next figure. Notice that it matches the Meter 2 line in the original figure at the top of this page. restoring time in a line graphic

As noted, when you "Redraw" the data, OED recalculates the number of points to display. Part of that process is deciding the frequency, i.e., the time between points, that is shown. OED has three frequencies that it uses:

  • Daily. Each point represents one day of data. This is typically the average of the readings across that day unless there are not multiple readings in a day. When you hover over a line in this case the time shown will be 12:00:00 PM because that is the midpoint of the points averaged. OED will display day data when there is 2 or more months of data (precisely, for 61 or more days).
  • Hourly. Each point represents one hour of data. As with days, OED automatically averages multiple readings within the hour. When you hover over a line in this case the time shown will be a half hour such as 9:30:00 AM since the half hour is the midpoint of the time averaged. When this happens can be controlled by the site but the default is for more than about 2 weeks (precisely, 15 days) and up to 60 days when the daily points will be shown.
  • Original Meter Data. If you go below the minimum time for hourly points then OED will display the original meter data (also called raw data). This means that no averaging has been done and the graph shows what was received from the meter. This can be valuable if you want to see exactly what the meter showed. For the default settings, this happens when you display less than 15 days worth of data.

If a site receives meter data more rapidly than about every 15 minutes, it would be common to lower the point when original meter data is displayed. For example, if data is read every minute, then the normal setting would be to switch at 1 day and not the 15 days for most sites. A site can choose to modify this nominal setting. If it was set so the switch occurred at 2 days instead of 1 day then OED would need to send more points than it typically wants for time ranges between 1 and 2 days. For example, at exactly 2 days, OED would send 2880 points (normally OED limits to 1440 points). This will make getting this data a little slower but does allow for seeing a larger range of time with original meter data. The site administrator can help with this setting.

Details

Exporting graph data

You can export the data represented on a line graphic. You can use the line graph to get the time range and meters/groups you want. See the export help page for further information.

Plotly graph controls

As shown in the next figure, the Plotly (the underlying graphic package) graphical controls (highlighted by a blue box) are available for usage. The most useful might be the camera that allows you to download a PNG for the graph. If you hover over a Plotly control icon it will show its name. Note that using some of the other controls (zoom, pan, etc.) may cause unexpected behavior as OED is also using those features. Plotly controls

Colors of lines

The color of lines is always the same for a given meter or group. This means everyone sees the same color for a given meter or group whenever it is graphed. The line colors are chosen to try to provide contrast between different lines. They are also designed to give some differentiation between meters and groups when possible. OED tries to show meters in lighter colors and groups in darker colors. This is not guaranteed as colors are reused between groups and meters if the number in either category becomes large. OED also tries to give a unique color to each line but that may not happen when the number of meters and groups is large. Note both of these depend on the number of meters and groups at the OED site and not the number being shown. Finally, a given meter or group will have the same color on the line, bar and map graphic.

Why do I need to Redraw and Restore?

OED is designed to be fast on any reasonable device. When you are zooming and scrolling within a line graphic, the work is all done in your web browser so it will have a very fast response rate. If OED recalculated the points shown as you zoomed/scrolled then it would be substantially slower, esp. if it needed to access the site's server to get new data. OED could try to determine when you are done zooming/scrolling and then recalculate the points but it is very difficult to determine when that has happened given users often pause during these operations. Thus, to be fast and allow you to get high quality line graphs, OED needs you to let it know when you are done and need the points displayed to be reset. The "Redraw" button is how you do that. You can also tell OED when you want to go back to the original graphic via the "Restore" button. This allows you to see all the data and/or zoom/scroll to other areas of the graph.

Why doesn't OED show all the meter/group data?

Meters often get a new data point every 15 to 60 minutes and groups inherit that value. This means a given meter or group can have a lot of data points. For example, a meter reading every 20 minutes for a year has over 26,000 data points. OED refers to these points as the original or raw meter data. There would be two main issues in showing you all the raw data. First, it would be significantly slower. All that data needs to be located in the OED database and then transferred across the network to your device. If you are on a mobile device you may be paying to transfer the data. Second, you would not be able to see all the points even if OED tried to graph them. Screen resolutions are in the hundreds to thousands of pixels (a single point on the screen) and the line graphics only get a subset of those pixels. That means OED cannot show more than hundreds to a few thousand points (if you have an HD screen). A massive number of points would be lost in viewing. Thus, OED averages the data on the site server to reduce the number of points it sends to your web browser for graphing. Thus, a point is the average energy usage across that time. Typically it averages across a day of data to be highly responsive. If you have limited data points for day averages then it will use smaller time intervals between points and will go to the original meter data when the number is small enough. This is still fast since the number of points to get is small and the number transmitted is also small. OED will average together multiple days if you have too many days to represent (if you are showing multiple years of data). These details are generally not important to you except to know that you are often looking at averaged data. Zooming in to a smaller time frame and redrawing or downloading the raw meter data for a graph are ways to see the original meter data.

Format of dates and times

OED uses a software system that tries to properly use your current language of display to determine how to display dates and times. For example, in English it would show MM DD, YYYY (e.g., January 1, 2020) whereas in Spanish it would show DD de MM de YYYY (e.g., 1 de enero de 2020). What this means is the date and time format you see may vary from what is shown in the help pages. It should be more appropriate for your language.

Meters that supply readings infrequently

As described above, OED displays averaged data at daily and hourly frequencies. If the meter supplies data at rate of less then every hour or day then you can see repeated values in the line graphic. For example, if a meter supplied reading every four hours, then there are four readings of hourly average that will have the same value since the reading spans four hour. The values displayed are correct but users might wonder why the same value is repeated for multiple points in a row. This should help explain this.