Parameterization of the EMS

Manual -> Energy Management System (EMS) -> Parameterization of the EMS

Show all    Hide all

The engineering of the EMS is carried out via a hierarchic tree structure. There corresponding sub-objects are linked to individual objects depending on their type. Sub-objects are added by selecting the corresponding menu item in the context menu of the selected node.

All object have property Name and Identification. The engineering of the individual objects is carried out via the property window.

All adjustable properties which are available in the property window are described in the help window after you click on them.

Info

All mentioned or shown properties are only visible if the EMS is licensed. The licensed EMS module is a separate element in the project tree. The settings in the EMS can be made with the help of this entry.

Attention

Within the EMS all existing units (grids, device groups, generators, devices etc.) should have a distinct name in order to ensure the perfect function of the forecast and the optimization.

All objects have the following menu entries:

Menu/Entry	Description
Cut	Cuts the selected object(s) and copies it/them to the clipboard.
Copy	Copies selected object(s) to the clipboard.
Paste	Pastes object(s) from the clipboard. Starting from the selected node, only objects from the same level or the level directly beneath it can be pasted.
Delete	Deletes selected object(s) including all sub-objects.
Export XML all ...	Exports the whole project to an XML file.
Export selected XML ...	Exports selected objects including sub-objects to an XML file.
Import XML ...	Imports objects from an XML file. Only objects (and their exported sub-objects) can be imported which are of the level directly beneath the selected node.
Info
All values of variables which are used in the EMS to state or adjust time values during the Runtime (e.g. switch-on time variable) are interpreted as seconds. Therefore a numerical value of 300 corresponds to a time period of 5 minutes (=300 seconds).

In order to ensure the correct functionality of the EMS, you must create at least the following variables for a supply area:

• Current value
  

  Current value

  A variable that contains the current value of the area consumption. The value must represent the counter difference per time unit of the sum of the consumptions of the supply area. Open the dialog for selecting variables by clicking on the button.

  Attention: Make sure that the value will be transmitted cyclically, as it causes a short-term optimization.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Supply limit
  

  Supply limit

  A variable that contains the currently configured supply capacity limit. If the value changes during Runtime, the supply capacity limit will also be changed for one supply period. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Start value of forecast
  

  Start value of forecast

  A variable that contains the start value of the forecast line at the beginning of the forecast time range. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• First switching value
  

  First switching value

  A variable that contains the calculated supply average, at which the next switching action will be executed. Open the dialog for selecting variables by clicking on the button.

  Attention: This variable must be configured for the Internal driver in order to guarantee proper functioning.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Forecast area:
  

  Forecast area:

  A variable that contains the possible forecast error of the final forecast value. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Final value of forecast
  

  Final value of forecast

  Variable that contains the final value of the forecast line at the end of the billing period. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Last switching value
  

  Last switching value

  A variable that contains the sum of the supply averages, for which there are still switching actions scheduled in the current period. Open the dialog for selecting variables by clicking on the button.

  Attention: This variable must be configured for the Internal driver in order to guarantee proper functioning.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Gross actual deviation
  

  Gross actual deviation

  A variable for the average deviation of the real value forecast. This average equals the difference between the forecasted average of the real value prognosis and the supply capacity limit. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Net actual deviation
  

  Net actual deviation

  A variable for the average deviation of the actual value forecast. This average equals the difference between the forecasted average of the actual value prognosis and the supply capacity limit. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

Info

In the context menu for a supply area you can find the menu item "Create variable". When selected, it automatically creates variables for the properties listed above and links the variables with the properties.

You must at least create the following variables for a generator/device in order to ensure the functionality of the EMS.

• Switching state for the generator
  

  Switching state

  A variable that delivers the current switching state of a consumer (ON or OFF). Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Switching state for the device
  

  Switching state

  A variable, to which the current switching state of the generator (OFF or ON) will be sent. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

• Availability flag
  

  Availability flag

  A variable specifying whether the generator is available for the EMS and can therefore be switched on. If it is available, the generator will remain in the last valid switching state. Open the dialog for selecting variables by clicking on the button.

  More in the online help

  This property is available in VBA (with class name) and in the XML export (without class name) under: ""

© COPA-DATA. For any questions regarding the documentation please contact: documentation@copadata.com