OED Documentation

Unit

Version V1.0.0

Overview

A graphic unit is the units that the user can choose for graphing meter/group data. The unit menu on each graphic page shows all the allowed (compatible) units that are available so the user can see the current graphic unit and select any available graphic unit. Since you can only graph one unit at a time, any new graphic unit replaces the current one. General information on units and the ones in the example used on these pages is available.

Usage

The unit menu on each graphic page is shown in the following figure (highlighted in blue box): Graphic unit menu

As shown, when you first load OED there is no graphic unit so it has "Select Unit". If the user selects a meter or group, then the default graphic unit associated with that meter or group will become the current unit. In the following figure, "Dining Hall Electric" was selected so OED automatically sets the units to "kWh". (Both shown in blue rectangle.) The y-axis graphing unit on this line graphic is the related flow unit of kW (see below). Graphic after selecting the Dining Hall Electric meter

Clicking on the down arrow to reveal the "Units:"" options will show all units and their status for the selected meter(s)/group(s) as show in this figure for the allowed units (they all just happen to fit in the dropdown display size): Graphic unit menu showing allowed choices

For the selected meter of "Dining Hall Electric", there are seven allowed units starting with "BTU" and ending with "US $" plus the already selected one of "kWh". Note the order of units is alphabetical withing each category. These are the seven units that are compatible in which you can graph the selected meters/groups. If you scroll down in the dropdown menu, you will see the incompatible (or not allowed) units. These are the units that cannot be used for graphing these meters/groups even though they are available at this site. There is a separation label "-----Incompatible Units-----" and these units are shown grayed out so they cannot be selected. With the selected meter, their are nine incompatible units starting with Celsius and going to ton. In the following figure you can only see the first five through "kW". The remaining ones could be seen by scrolling the dropdown choices. Graphic unit menu showing incompatible choices

Any allowed unit can be selected to update the displayed graphic unit. As shown in the following figure, "US $" was selected and the y-axis label became "US $/hour". (see below) Graphic after selecting US $ unit

Selecting additional meters/groups will not change the graphic unit on the "Units" menu but it can alter the allowed/incompatible units that are displayed. This is due to the fact that the allowed units are those that are allowed for all meters and groups selected. See for more information.

At times you may want to clear all selected meters and groups to restart anew. If you click the "x" next to the selected unit, as shown in the following figure, it will do this. The place to click is red as is automatically done when you hover over the "x". It will also clear the unit and reset it back to "Select Unit". Overall, this will put it back to the initial page when OED was loaded as shown at the top of this page. Clearing graphic unit

While less common, one can select a unit before any meter/group when it has "Select Unit". When this is done, the y-axis label is updated but nothing is graphed. In the following figure, the "Units" was set to "BTU" (shown in blue rectangle) and the y-axis label became "BTU/Hour": Selecting graphic unit before meter/group

One can select the graphing unit on any graphing page. The selected unit will remain active for all graphing pages until it is changed.

y-axis unit

OED selects the appropriate y-axis unit based on the graphing unit (and the graphing rate for line graphics). There are three types of units that OED uses:

  • Quantities. These are associated with resources measured as an amount and can be created/consumed. Common examples include energy (kWh, BTU, etc.), mass (kg, lb, etc.), volume (gallon, liter, etc.), money (US dollar, Euro, etc.) and CO2 emitted (kg of C22, tons of CO2).
  • Rates. These are associated with the amount/quantity consumed or created per unit of time. Common examples include volume/time (gallon / minute, gallon / day, liters / hour), money / time (dollars / day, e.g., spending per day) and power (kW).
  • Raw (as named by OED). These are not quantities and are not consumed. The common example is temperature (Celsius, Fahrenheit).

Each type of graphic has a y-axis unit that it wants to graph:

  • Line graphic. This shows a rate since each point is a moment in time. If the graphing unit is a quantity then OED will convert that to the rate of usage (quantity / time) by using the fact that measurements/readings from a meter span a time in OED. If the graphing unit is a rate then it directly graphs the value as it is already a rate. In both these cases, the graphing rate determines the time used for the rate but with an exception for kWh & kW. If the graphing unit is a raw unit then it also directly graphs the value because it does not make sense to talk about the rate usage of something that is not consumed. For example, Celsius / hour is not something one talks about.
  • Bar graphic. This shows a quantity since each bar represents a span of time. The value is related to the line graphic rate times the span of time. If the graphing unit is a quantity then the total quantity for the time range of each bar is determined and displayed. If the graphing unit is a rate then it is converted to a quantity by taking the appropriate rate and multiplying by the associated time. If the graphing unit is raw then it will not show on a bar graphic because you cannot sum these quantities over time.
  • Compare graphic. This is a type of bar graphic so the same ideas apply.
  • Map graphic. This shows a quantity over the selected range of time (day, week, 4 weeks). As such, it has the same ideas as a bar graphic. The actual unit displayed is quantity per day. For example, if the user selects a week, then the usage over the week is the quantity and this is divided by the 7 days to get quantity per day that is displayed. It is a type of rate but always the average rate per day. This was done so the value shown is similar when different time ranges are selected.

Details

An easy way to see all available graphing units is to use the "Units" dropdown menu when no meter/group is selected. Since all units are allowed, they will all be seen. You can also see at any time but once a meter/group is selected it is likely they are separated by allowed/incompatible.

The "Units" menu allows for incremental search as usual in OED menus. Typing character will limit the options. Note if you do this and don't select an option, OED will set the unit to "Select Unit" and clear all your selected meters/groups. To avoid this, delete the character(s) entered for the search to get back to just the previously selected unit.