Documentation for All Versions

Download a PDF Version

Current Documentation for EnergyCAP Online

Page tree

This Documentation relates to 3.5.
If you are using a different version, please view the Documentation for All Versions and select the relevant version.

Skip to end of metadata
Go to start of metadata


EnergyCAP ‘channel data’ is any time-series stream of data OTHER than utility bills. Examples of channel data are: electric meter 15-minute interval data, weather data (dry bulb temp, wind, humidity), production data (pounds, linear feet or units of production), counter data (occupancy, sales volume, gallons pumped) and submeter data (hourly, daily or monthly consumption).

This topic will...

  • Describe the process for creating/adding a channel to a meter from the meter properties window.
  • NOT describe the process for adding a chargeback meter. Please refer to Creating a Chargeback Meter.


  • The ability to add channels is incorporated in the following User Roles:
    • Administration Full Access
    • Bill Entry & Account Setup
  • Obtain the channel details regarding the reading units, the multiplier used to convert the readings, the type of channel (odometer or trip), and the maximum reading (or roll-over value).
    • NOTE: some channel properties can be edited after the channel has been created (such as max reading and multiplier); however, primary properties such as channel type, observation type, and the channel rule cannot be edited.  Therefore if the channel is created without knowing these key properties and if any of those fields is not correct, setting the right values is not as simple as editing the channel.  It may be necessary to delete and recreate the channel with the correct property information.


  1. Select Buildings & Meters from the Main Menu. The Buildings navigation Tree View will be displayed on the left.

  2. Navigate to the meter that is to receive the channel.  

  3. Click the Edit button below the Tree View and select the Channels tab menu option.
  4. Click the Add Channel button to open the 'Create Channel' wizard.
  5. The next steps are setting the channel property details like channel type (usage or demand), observation type, etc.
    1. Channel Type - Is this a usage or a demand channel?
    2. Observation Type - select the applicable field from the drop down list. 
      1. Observation types can be thought of a "categories".  They are used to describe the type of data associated with the channel or in other cases line items on bills (e.g. demand, use, etc.)
      2. While there are a variety of observation types to choose from, most of the choices apply more to the line item data on a bill rather than interval data associated with channels.
      3. When adding a channel from the meter properties view, the user is given the option to select different observation types from the drop down list; however, the observation types that are most applicable to channel data include reading use, reading demand, usage, and demand.  In fact, when creating a channel during the setup of a chargeback distribution (rather than at meter properties) the drop down list is grey'ed out and the observation type is determined by the channel type selected.  This is to prevent accidentally picking an observation type that will not work with chargeback calculations.
    3. Reading Unit, Multiplier, and Output Unit
      1. Reading unit refers to the unit of measure of the readings.  This is most often set to 'Value', as it is the only unit associated with the Reading Use or Reading Demand observation types that are used for chargeback calculation processes. 
      2. Multiplier - the multiplier is what is used to convert the readings to the output unit.  For example, if your reading values are gallons and the output unit is set to thousand gallons (kgal) you would need to set the multiplier equal to 0.001 in order to arrive at the desired output unit of measure.  Another example would be a case in which the reading values are kWh and the desired output unit is kWh.  In the second scenario you would set the multiplier equal to 1 since the reading unit is the same as the output unit of measure.
      3. Output Unit - used to define the desired unit of measure of the chargeback calculation.  In the case of a usage odometer style meter, the previous reading would be subtracted from the current reading and then the multiplier would be applied to the difference to arrive at the desired output value and corresponding unit of measure.
    4. Time between readings - select the applicable interval of the readings associated with the channel of data.  Is this a 15 minute interval meter or is it hourly or maybe even monthly? 
    5. Rule - Odometer is assigned to channels in which the reading values progessivly get larger (similar to the odometer in a car that tracks mileage).  Trip is used for channels that are reset after each reading.  Trip is most often utilized for demand data as it measures the peak demand during the interval and then is reset to zero in preparation for the next interval period.
    6. Calibration Date and Maximum Reading
      1. The calibration date setting is the only optional field in the channel creation process.  It is meant to be used for tracking of when the meter was last calibrated.
      2. Maximum Reading - this field is utilized by the processor to determine when a meter/channel has reached the 'roll-over' point.  When an odometer type meter has reached the highest value that is allowed, it rolls over and continues counting from zero.  When this maximum reading value is set correctly, EnergyCAP will account for the roll-over when calculating the difference between the readings and arriving at the usage by applying the multiplier.  If this value is not set correctly and the meter rolls-over, the result will be a grossly negative or positive usage value. These mistakes are often easy to spot due to the drastic difference between the typical usage on the given meter (the expected usage that matches the use trend of the meter) and the value calculated with the incorrect roll-over setting.
    7. Click 'OK' to continue
  6. The last step is to assign the meter to a Route. Reading values can be imported or manually keyed.  Routes are used to manually enter channel readings; therefore, once a channel is created on a meter then meter must be assigned to a route. 
  7. Click Save to complete the channel setup.

Rules & Restrictions

  • When a channel is added to a meter the meter must be added to a route, so that readings can be manually entered.
  • Channels to be used with the chargeback processor must be assigned either the reading use or reading demand observation type.

  • No labels