Configuring Energy AnalytiX Extensions

To configure an Energy AnalytiX application, there two basic areas of product configuration:

Energy AnalytiX Workbench Provider

This area relates to overall application configuration settings and it is the starting point for any energy application configuration. Although the product installation will install default, as well as sample, configuration data, it is always a good first step for the end user to start from this product configuration area.

 

Energy AnalytiX Workbench Provider

AssetWorX Tree

This area relates to enabling energy management to assets in the AssetWorX tree by adding an Energy AnalytiX extension. Energy AnalytiX supports the following types of extensions to an asset.

 

The AssetWorX asset tree is utilized to add Energy AnalytiX extensions to user configured assets (equipments). Using the Asset tree, Energy AnalytiX supports three types of Energy related assets.

Regular Energy Asset

Energy Meter

Energy AnalytiX Assets in Workbench

 

Note: Upon full Energy AnalytiX product installation, a folder with energy-related equipment classes will be created which can be referenced to get ideas and or suggestions about possible asset structure in terms of energy application.

Energy Equipment Classes

What Is a Meter and How Is It Used

An energy meter represents the entry point of energy data into Energy AnalytiX. It relates a utility or energy source to energy consumption, cost and carbon.

 

It is also the minimal configuration required to have energy data flows inside Energy AnalytiX. Also, an energy meter facilitates the analytics views on energy data (such as electric, water, gas) based on the energy meter’s meter type.

 

Energy Meters in Asset Tree

 

The user can associate the energy meter tags with important information regarding his energy application. In more details, an energy meter can have the following types of tags:

A meter can also have an optional rate tag to associate cost to energy consumption. In addition, energy meters can be utilized not only for energy source input but for other variables that require similar type of functionality such as occupancy, production count etc.

What Is an Energy Asset and How Is It Used

An energy asset represents the logical or physical entity for energy calculations allocation and propagation of energy data. It relates energy data to various levels of the asset tree, both physical as well as logical.

 

Energy assets operate on meter energy data, energy variables and built-in energy calculations. They are utilized for advanced energy analysis past the raw meter inputs. They can represent energy consumption at various levels of the asset tree and can be associated with both logical as well as physical locations or facilities.

 

Energy Assets in Asset Tree

 

Key differences between energy assets and meters

Integration with Asset AnalytiX

Here are a few comments regarding the new Energy AnalytiX architecture and the integration with Asset AnalytiX.

 

In the new architecture of Energy AnalytiX, any configuration element which requires data storage and data calculations will be processed by Hyper Historian. All related configurations in Energy AnalytiX Workbench forms will be auto-configured, transparent to the end user, as AssetWorX exposed equipment properties mapped to Hyper Historian tags or performance calculations.

 

Energy Meter Consumption Exposed as AssetWorX Equipment Property

 

The end user can view in Workbench the underlying Hyper Historian settings for the related equipment property, however because the above settings are auto-configured, the end user will not be able to modify them. The underlying settings for Hyper Historian tags or calculations are based on the type of the related Energy AnalytiX configuration element, whether it is a simple raw tag for data collection and storage or it requires to be associated with a Hyper Historian performance calculation.

 

Hyper Historian performance calculations do require an associated Calculation Trigger. Energy AnalytiX also handles this aspect transparently to the end user by using an appropriate calculation trigger with the appropriate processing phase pending on the timing of the individual energy related performance calculations.

 

To accomplish this task, Energy AnalytiX product installation will install a good number of pre-defined calculation triggers for Hyper Historian. The end user should not delete or rename, edit the related Hyper Historian calculation triggers, calculation functions, AnalytiX-BI energy data model, Periodic Triggers (under Actions) since the energy data collection and related calculations may be prevented from operating properly.

 

The calculation triggers are updated to include timezone information when daily, monthly and yearly data aggregates are enabled. The user should create first energy calculation triggers by using the General Options tab (Energy Data Aggregates) to pick a geographic location and to allocate related calculation triggers by clicking on the Add Triggers button.

Creating Timezone Aware Calculation Triggers from General Options

 

Predefined Calculation Triggers for Energy in Hyper Historian

 

In the new Energy AnalytiX architecture, all related energy data are exposed via AssetWorX or Hyper historian data access API and they are browsable via the ICONICS Unified Data Browser

 

Accessing Energy Data in Unified Tag Browser

 

As such, they can be natively accessed in any ICONICS client, such as TrendWorX64 Viewer.

 

Energy Data in TrendWorX64 Viewer

 

The typical recommended steps in adding energy extensions to assets in AssetWorX tree are:

AssetWorX Cache Data Store

In certain configuration settings, constant values may be entered in configuring energy assets or meters. In these cases, the resulting AssetWorX equipment properties will need the AssetWorX Cache Data Store to be properly configured. If it is not, a warning will be displayed on the related Energy AnalytiX form.

 

Configuring AssetWorX Cache Data Store

Remote Deployment of Hyper Historian

In certain applications, Hyper Historian, which is the datastore and calculations backend of Energy AnalytiX may need to be located on a separate server from Energy AnalytiX. This scenario is supported since the new architecture of Energy AnalytiX requires that the AssetWorX, Asset AnalytiX, Hyper Historian and Energy AnalytiX configuration databases are located within the same AssetWorX configuration database.

 

While the shared Hyper Historian and AssetWorX configuration database smust be hosted on a single SQL server, the Hyper Historian service and AssetWorX service can run on different machines.

 

Configuring Remote Access to Hyper Historian in AssetWorX

 

 

If the field Extension server is filled for Hyper Historian, AssetWorX will use remote syntax to get Hyper Historian  data (like \\HH_machine\hh:some_point) and vice versa.

Configuring Your Energy Meters

Before you configure your meters, make sure you are familiar with the concepts described in the What is a Meter and How is it Used? topic. Also, make sure you weigh the options for:

Before You Begin

Before you configure a meter, or any energy related asset you will need to have defined Hyper Historian logging groups and collectors to associate the meter tags. Energy AnalytiX will install a few sample logging groups in Hyper Historian, however you can create your own ones to related to desired data collection rates for energy meter data.

Steps for Configuring a Meter

Note: Since you are defining one meter (and not an equipment class to be used as a template for creating meters more easily), it is easy to define just the information that you need to establish the meter in the asset tree. Establishing all data for the meter would be more important if you were creating an equipment class (template) for meters. If you would rather create an equipment class for meters, refer instead to Configuring Energy AnalytiX Using Equipment Classes.

To Add a Meter to the Asset Tree and Identify it as a Meter:

Click Apply to save the new meter.

Energy Meter Configuration Form

 

The following fields may be specified:

Required Meter Data:

Meter Consumption Tags:

Miscellaneous:

Click OK. This closes the Configure Meter Data dialog.

Once all related energy meter configuration is completed and the user clicks on the Apply button all the configuration settings will be transparently auto-configured as asset equipment properties mapped to Hyper Historian raw tags or calculation functions. Because all the mapping of the energy configuration entities to the underlying platforms is transparent to the user, the user will not be allowed to manually edit the added asset equipment properties on behalf of Energy AnalytiX.

 

Energy Meter Configuration Exposed as AssetWorX Equipment Properties

 

In addition, all proper calculation triggers will be linked to the configuration entities with the proper processing phases to accommodate for the timings of the calculation executions.

 

Energy Meter Consumption Mapped to Hyper Historian Calculation

A Word on Naming Conventions

Energy AnalytiX in auto-configuring energy related entities will utilize a certain naming convention schema that will facilitate easy filtering on energy-related AssetWorX properties, along with the utilization of advanced array functions in Hyper Historian.

 

For energy meters, the related naming convention for asset equipment properties related to energy meters is as follows:

 

In general...

Asset Equipment Property Naming

 

The naming conventions for energy meters are as follows:

Sample Energy Meter Configuration

 

Sample Naming Convention for Consumption (Consumption Tag)

 

Sample Naming Convention for Cost (Rate Tag)

 

Sample Naming Convention for Demand Tag

 

Sample Naming Convention for Voltage (Related Tag)

A Word on Energy Meter Counters

In Energy AnalytiX all related meter data are collected, data logged and processed by Hyper Historian. This is accomplished by a dedicated energy function library within Hyper Historian which is installed upon Energy AnalytiX product installation. The types of energy meter consumption tag counters are as follows:

In addition, we also have the following energy related function:

Energy Meter Related Functions in Hyper-Historian

 

In all cases, Energy AnalytiX provider in Workbench will allocate all necessary configuration entities and configure all required energy calculations function parameters.

Delta Counter with Rollover for Energy Meter Consumption Tag

Delta Counter with Rollover

 

Delta Counter with Rollover Function Parameters

 

Description:

 

The Energy AnalytiX Workbench provider, when the user assigns a meter tag of the specific meter counter type, will:

Implementation:

 

This function will implement the calculation logic as follows:

Delta Counter for Energy Meter Consumption Tag

Delta Counter

 

Delta Counter Function Parameters

 

Description:

 

The Energy AnalytiX Workbench provider when the user assigns a meter tag of the specific meter counter type will

Implementation:

 

This function will implement the calculation logic as follows:

Point Counter for Energy Meter Consumption Tag

Point Counter

 

Point Counter Function Parameters

 

Description:

 

The Energy AnalytiX Workbench provider when the user assigns a meter tag of the specific meter counter type will

Implementation:

 

This function will implement the calculation logic as follows:

Note:

The Point counter is ideal for conversion of rates to totals such as kW to kWH or gallons per minute to gallons etc.

Total Counter for Energy Meter Consumption Tag

Total Counter

 

Total Counter Function Parameters

 

Description:

 

The Energy AnalytiX Workbench provider when the user assigns a meter tag of the specific meter counter type will:

Implementation:

 

This function will implement the calculation logic as follows:

Energy Cost for Energy Meter Consumption Tag

Energy Cost

If an energy meter has consumption tags and rate model values associated with it, then an energy cost calculation will be added. AS before, it will be an AssetWorX equipment property mapped to a Hyper Historian calculated tag and evaluated using a calculation trigger.

 

Energy Cost Calculation Function

 

Energy Cost Calculation Function Parameters

 

The energy cost calculation function will use as inputs the raw Hyper Historian historized tag for rate values and the calculated tag for energy consumption.

 

Description:

 

This function will implement he energy cost calculation function as follows:

Implementation:

See Also:

Energy AnalytiX Nodes

Energy AnalytiX Quick Start

How Energy AnalytiX Works