SIMATIC Energy Suite Visualization example of the … Energy Suite – Visualization example of the ... SIMATIC Energy Suite as well as measuring and automation devices you can

https://support.industry.siemens.com/cs/ww/en/view/109739772

Application Example 03/2017

SIMATIC Energy Suite –

Visualization example of the

"*.xlsx"-Energy Data Files SIMATIC STEP 7 V14, WinCC Professional V14, SIMATIC Energy Suite


Warranty and Liability

Energy Suite Data Evaluation Tool Entry ID: 109739772, V1.0, 03/2017 2

S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Warranty and Liability

Note The Application Examples are not binding and do not claim to be complete regarding the circuits shown, equipping and any eventuality. The Application Examples do not represent customer-specific solutions. They are only intended to provide support for typical applications. You are responsible for ensuring that the described products are used correctly. These Application Examples do not relieve you of the responsibility to use safe practices in application, installation, operation and maintenance. When using these Application Examples, you recognize that we cannot be made liable for any damage/claims beyond the liability clause described. We reserve the right to make changes to these Application Examples at any time without prior notice. If there are any deviations between the recommendations provided in these Application Examples and other Siemens publications – e.g. Catalogs – the contents of the other documents have priority.

We do not accept any liability for the information contained in this document. Any claims against us – based on whatever legal reason – resulting from the use of the examples, information, programs, engineering and performance data etc., described in this Application Example shall be excluded. Such an exclusion shall not apply in the case of mandatory liability, e.g. under the German Product Liability Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life, body or health, guarantee for the quality of a product, fraudulent concealment of a deficiency or breach of a condition which goes to the root of the contract (“wesentliche Vertragspflichten”). The damages for a breach of a substantial contractual obligation are, however, limited to the foreseeable damage, typical for the type of contract, except in the event of intent or gross negligence or injury to life, body or health. The above provisions do not imply a change of the burden of proof to your detriment. Any form of duplication or distribution of these Application Examples or excerpts hereof is prohibited without the expressed consent of the Siemens AG.

Security informa-tion

Siemens provides products and solutions with industrial security functions that support the secure operation of plants, systems, machines and networks. In order to protect plants, systems, machines and networks against cyber threats, it is necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial security concept. Siemens’ products and solutions only form one element of such a concept. Customer is responsible to prevent unauthorized access to its plants, systems, machines and networks. Systems, machines and components should only be connected to the enterprise network or the internet if and to the extent necessary and with appropriate security measures (e.g. use of firewalls and network segmentation) in place. Additionally, Siemens’ guidance on appropriate security measures should be taken into account. For more information about industrial security, please visit http://www.siemens.com/industrialsecurity.

Siemens’ products and solutions undergo continuous development to make them more secure. Siemens strongly recommends to apply product updates as soon as available and to always use the latest product versions. Use of product versions that are no longer supported, and failure to apply latest updates may increase customer’s exposure to cyber threats. To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed under http://www.siemens.com/industrialsecurity.

http://www.siemens.com/industrialsecurity



Table of Contents


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Table of Contents Warranty and Liability .............................................................................................. 2

1 Task................................................................................................................. 4

2 Solution........................................................................................................... 5

2.1 Overview ........................................................................................... 5 2.2 Hardware and software components .................................................. 6 2.2.1 Validity .............................................................................................. 6 2.2.2 Components used ............................................................................. 6

3 Basics ............................................................................................................. 7

4 Operating the Application Example ............................................................... 8

4.1 Starting the macro ............................................................................. 9 4.2 Loading an Excel file ........................................................................ 10 4.3 Evaluation ....................................................................................... 11 4.4 Saving the evaluation as PDF file .................................................... 12 4.5 Operation detail view - diagram........................................................ 13

5 Mode of Operation of the VBA Macro .......................................................... 14

5.1 Structure of the macro ..................................................................... 15 5.2 Structure of the program code.......................................................... 17 5.3 Core functionalities .......................................................................... 18 5.3.1 Saving as PDF file ........................................................................... 18 5.3.2 Importing data records ..................................................................... 18 5.3.3 Evaluating measuring points ............................................................ 19

6 Further Notes, Tips & Tricks, etc. ................................................................ 21

7 Links & Literature ......................................................................................... 22

8 History .......................................................................................................... 22

1 Task


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

1 Task

Introduction

In production, energy management plays an increasing role. The relevant data has to be specified in order to identify the energy consumption of a plant. With the SIMATIC Energy Suite as well as measuring and automation devices you can quickly determine your energy data. The data is archived at user-defined periodic intervals. You can either save the data in a tag archive via WinCC Professional (TIA Portal) or on the SIMATIC memory card of the S7-1500.

Overview of the application example

The following figure gives an overview of the application example.

Figure 1-1

kWhkW

CPU

S7-1500

Evaluation

energy data

ET 200SP with AI Energy Meter

480V

3VA MCCB

SINAMICS G120

SIMOCODEpro V PN

SENTRON 7KM PAC

Energy data acquisition with SIMATIC Energy Suite

Goal of the application example

The goal of the application example is the preparation of the archive data of the SIMATIC Energy Suite Export Tool. The prepared data is then evaluated and can be documented and saved. The solution introduced here is an example of how you can evaluate your measurement data with Microsoft Excel.

2 Solution


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

2 Solution

2.1 Overview

Schematic layout

The figure below schematically illustrates the principle of the solution.

Figure 2-1

*.xls file from Energy

Suite Export Tool

Import into the

Microsoft Excel

macro

Microsoft ExcelEvaluation

Excel macro

Documentation

Export

*.xls

Advantages

The solution presented in this application example, offers you the following advantages:

Time and cost savings through automated data evaluation.

Option for the visualization of the energy archive data of the SIMATIC memory card.

Documentation of the energy data.

Expandability of the Excel macro

Topics not covered by this application

This application example does not contain a description of:

Microsoft Excel

Visual Basic for Applications (VBA)

Assumed knowledge

Basic knowledge on Microsoft Excel is assumed. For the expansion of the macro, knowledge in Visual Basic for Applications (VBA) is required.

2 Solution


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

2.2 Hardware and software components

2.2.1 Validity

This application example is valid for the following products:

STEP 7 V14

SIMATIC S7-1500

SIMATIC Energy Suite V14

WinCC Runtime Professional

Microsoft Excel 2010 64 bit or higher

2.2.2 Components used

The application example has been created with the following components:

Hardware components

Table 2-1

Component Qty. Article number Note

SIMATIC S7-1516 1 6ES7516-3AN01-0AB0 Alternatively, all other CPUs from the S7-1500 controller family with article number 6ES7…-…01-…. and firmware 2.0 can be used.

SIMATIC Memory Card

1 6ES7954-8LL02-0AA0 Alternatively, all other “SIMATIC Memory Cards” can also be used.

Software components

Table 2-2

Component Qty. Article number Note

Microsoft Excel 2010 or higher

1 Microsoft 64 bit version

Note The application example was created Microsoft Excel 2010 64 bit. This is why you should use this Microsoft Excel version. Using later Microsoft Excel versions may lead to optical deviations, depending on the version.

Example files and projects

The following list contains all files and projects that are used in this application example.

Table 2-3

Component Note

109739772_EnS_DataEvaluation_PROF.xlsm This file includes macros that you have to enable first, after opening.

109739772_EnS_DataEvaluation_PROF_DOC_en.docx This document

3 Basics


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

3 Basics

Measuring points

The macro evaluates Excel files of the "*.xls" type or "*.xlsx" that include up to 200 measuring points.

Microsoft Excel

In Microsoft Excel 64 bit the number of rows per spreadsheet is limited to 1,048,576. The macro evaluates Excel files with up to 1 million data records per measuring point and month. The macro is optimized for Microsoft Excel 2010.

If you are using Microsoft Excel 2013 or higher, please switch off “Animations” in Microsoft Office, if possible. This increases the general performance of your Microsoft Office. For more information, please refer to the support area of the Microsoft page.

Evaluation

The Excel macro evaluates precisely one measuring point for one year. This measuring point and the year can be selected in the Excel sheet “Overview” after the import of the data records.

The macro evaluates data logs with the suffixes "*_energy" and "*_power".

Performance

The speed of the macros depends on the number of data records in the file to be evaluated and of the hardware on which the Excel macro is running.

4 Operating the Application Example


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

4 Operating the Application Example The VBA macro is integrated in the Microsoft Excel table. You operate the macro in Microsoft Excel via the Excel sheets “Overview” and “Dashboard”. After the evaluation of a measuring point the Excel sheets are displayed with the created diagrams.

Overview and description of the user interface

Figure 4-1 Configuration of the macro

“Browse" button ("…")

“Load Data” button

Selection of the measuring point (after import)

Selection of the year (after import)

“Evaluation” button

“Save as PDF” button

Changing Excel spreadsheet

2

4

7

3

5

6

1

2

3

4

5

7

6

1



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Figure 4-2 Display of the diagrams in the dashboard

Annual overview of the imported data (clickable area)

Display of the selected diagram

Display of the month

Operating the dashboard

The dashboard enables the display of different diagrams on a central location. Click on a value within the clickable area (1) in order to display the respective diagram in the display area (2).

Note A field is only clickable when data for the respective month is available.

4.1 Starting the macro

Table 4-1

No. Action

1. Open the Excel workbook “EnS_Data_Evaluation_Prof.xlsm” with Microsoft Excel 2010.

2. Enable the macros by clicking the button with the following note “Enable Content”.

1

2

3

1

3

2



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

No. Action

3. If you have already used the macro and old data records have been detected, you can restore them after the start of the macro via the following “Restore data logs” dialog. To do this, click the “Yes” button.

Note:

If you don’t want to restore the data, click “No”. The old data records are deleted and the workbook is corrected.

4.2 Loading an Excel file

Note How to export the energy data files with the Energy Suite Export Tool is explained in the application example with entry ID 109739102 in Chapter 5.7.2:


In order to load a file of the type "*.xls(x)*" into the macro, proceed as follows:

Table 4-2

No. Action

1. Click the "..." button in the “Overview” Excel sheet and select your file (1).

2. Click on the “Load Data” button (2).

You have now loaded the data records into the Excel macro.

Note Before you are loading a new Excel file, all existing data records from the Excel workbook are deleted. If required, save your evaluation as PDF file beforehand.

Loading time depends on the number of data records. You cannot operate Microsoft Excel during the import.

https://support.industry.siemens.com/cs/attachments/109739102/109739102_EnergySuiteGettingStarted_DOC_V14_en.pdf




S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

4.3 Evaluation

Prerequisite

You have loaded data records into the Excel macro.

Table 4-3

No. Action

1. Now select the measuring point (1) and the year (2) that you want graphically evaluated.

Note:

Select the respective check box in order to enable list fields.

2. Click on the “Evaluation” button (3) to start the evaluation.

The data is evaluated by month. The diagrams “Energy Value”, “Peak Power Value” and “Detail view” are created.

Once the data has been evaluated, the Excel sheets with the created diagram (“Jan”, “Feb” etc.) are shown.



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

4.4 Saving the evaluation as PDF file

Prerequisite

You have evaluated a measuring point.

Table 4-4

No. Action

1. Click the “Save as PDF” button in order to save the diagrams as PDF

2. The “Export as PDF” dialog window opens.

Select the diagrams you wish to save.

3. Click on the "..." button and select the storage location and a name. Then click the "Save" button.

A PDF file with all previously selected diagrams is created.

NOTICE If a file with the specified file name already exists, this file will be overwritten without further inquiry.



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

4.5 Operation detail view - diagram

The detail view - diagram offers you a detail view of your energy data. You have the option to make filter settings for the diagram via the configuration bar. You can display any period within the respective month.

Figure 4-3

Selecting a period

1. Select Start date (1) and End date (2) via the two selection lists.

2. Click on the “Apply Filter” button (3)

The Excel macro updates the diagram sources so that you can then see the selected area in the diagram.

If the "*_energy" and "*_power" values are available for the selected measuring points, you can select what data is displayed in the detail view diagram via the check box (4). If, for example, only "*_power" values are available, they are automatically displayed in the diagram.

5 Mode of Operation of the VBA Macro


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

5 Mode of Operation of the VBA Macro The following figure gives an overview of the mode of operation of the Excel macro. The Microsoft Excel application copies the data records of the Excel file, sorts them and displays the measuring points in example diagrams. All functionalities are described in the VBA.

Figure 5-1

Yes

Start/Stop

Import successful?

Import

open .xls file

Copy und adjust data

records

Selection measuring point and

year

No

Close .xls file

Save as PDF file

Evaluation

Filter data and

separate by

months

Update diagrams

Hide inactive sheets

Evaluation successful?

Yes

No

Dashboard



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

5.1 Structure of the macro

This application example consists of a total of 29 Excel sheets. The Excel sheets are required for the following functions:

Operation and configuration of the macro

Data management

Representation of the diagrams

Operation

You operate the macro in Microsoft Excel via the Excel sheets “Overview” and “Dashboard”. In the Excel sheet “Overview” you import the Excel data and evaluate it. The Excel sheet “Dashboard” offers you a compact display of diagrams that are created by the macro. In the monthly Excel sheets (“Jan”, “Feb” etc.) you can access individual diagrams after the evaluation, in addition to the "Dashboard".

Data management

The macro saves all data records from the imported file in the Excel sheets “Archive data” or “Virtual process tags”. The further evaluation of the data according to selected measuring points and selected year is done in the data Excel sheets “*Data”. The placeholder “* “ stands for the abbreviation of the month, for example, “JanData”. To have a better overview, these Excel sheets are hidden.

Diagrams

For each month, three different diagrams are created.

Table 5-1

Diagram Display

“Energy Value” diagram

Display of the energy consumption for the month



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Diagram Display

“Peak Power” diagram

Display of the power peaks for the month

“Detail view” diagram

Detailed view with selectable period.

The diagrams created are stored in the Excel sheets “Jan”, “Feb”, etc.. As soon as the data is available for a month, the Excel sheet is automatically displayed after the evaluation. The macro furthermore creates an annual overview. You can find it in the displayed “Year” Excel sheet.



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

5.2 Structure of the program code

The Excel macro was written in the Visual Basic for Applications (VBA) programming language. For a better overview the code is divided in modules. Forms are used for dialogs, they are called “UserForms”.

.

Note This chapter explains you the structure of the program codes that is behind the Excel macro.

The VBA editor can be opened with the key combination <Alt> + <F11>.

Forms

The macro works with the following UserForms:

UserFormProgress (progress display)

UserFormPDF (storage dialog)

Modules

The program code of the Excel macro is divided in the following six modules:

Modul00_Functions_Consts

In this module, global constants and tags as well as generally valid functions are stored.

Modul01_Import

In this module, the data records for the Excel file to be imported are stored separately in the Excel sheet “DataImport”. Afterwards, date and time as well as spaces and quotation marks are removed separately in the data records.

Modul02_Evaluation

This module includes the following functions for the evaluation of the data records:

Filtering data records in Excel sheet “DataImport” according to year and measuring point.

Dividing data records in data Excel sheets by month (“JanData”, ... ).

Updating diagrams.

Hiding diagrams without displayable content.

Modul03_Analyse

Module 3 analyzes the data records. The following information is displayed and then output:

Time stamp of first data record

Time stamp of the last data record

Archiving cycle

Number of data records

Number of detected gaps in the data records, for example, due to a failure of a device



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Modul04_Overview

The functions in module 5 relate to the Excel sheet “Overview”.

The data records are searched for measuring points and years included and then displayed in the list fields on the Excel sheet “Overview”.

Modul05_Dashboard

The functions in module 6 relate to the Excel sheet “Dashboard”.

Copy the original diagram from the monthly Excel sheets “Jan”, “Feb”, ... and add it in the dashboard.

5.3 Core functionalities

5.3.1 Saving as PDF file

You find the VBA code to save the diagrams as PDF file in the VBA editor in the form “UserFormPDF”. It consist of three click events for the check box “All” and the buttons “[…]” and “Save”.

Call

The UserForm is opened by clicking the button “Save as PDF” on the Excel sheet “Overview”.

Mode of operation

Select the objects to be printed via the checkboxes.

By clicking on the “Save” button the sub-function “Button_Save_Click()” evaluates the check boxes. The diagrams are copied in a new, temporary Excel sheet. This is printed with the default Export function as PDF file and saved in the path specified by you. Then the temporarily created Excel sheet is deleted.

5.3.2 Importing data records

The “Import” function imports the data records of a .xls file into the Excel workbook.

Call

Click the “Load Data” button in the Excel sheet “Overview” in order to start the “Import” function.



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

Structure

By clicking the “LoadButton” button in the overview table the “LoadButton_Click()” function is called. This function calls the following sub-functions one after each other:

Table 5-2

No. Name Function

1 “deleteAll” Corrects the following Excel sheets and resets the internal tags.

DataImport and “Month”Data (“JanData”, “FebData”)

“Overview” Excel sheet

“Dashboard” Excel sheet

2 “csvImport” Separates the data records of the .CSV file to be imported and stores it in the Excel sheet “DataImport”.

Separates date and time

Removes spaces and quotation marks in the data records in the Excel sheet “DataImport”

3 “fillYearListboxes” and

“fillMPListboxes” Searches the data records for years and measuring points included and outputs them on the Excel sheet “Overview”.

5.3.3 Evaluating measuring points

The Evaluation function evaluates the data records and updates the diagrams.

Call

Click the “Evaluation” button in the Excel sheet “Overview” in order to start the “Evaluation” function.

Structure

By clicking the “EvaluationButton” in the overview table the “EvaluationButton_Click()” function is called. This function calls the following sub-functions one after each other:

Table 5-3

No. Name Function

1 “filterData” Filters the Excel sheet “DataImport” according to selected measuring point and year with the auto filter function.

2 “clearMonthData” Deletes the exiting content from the Excel sheets “Month”Data (for example, “JanData”, “FebData”) and resets the filter in these Excel sheet.

3 “evaluate” Filters the Excel sheet “DataImport” according to selected measuring point and year with the auto filter function.

Filters the Excel sheet “DataImport” according to selected measuring point and year with the auto filter function.

Separates the data from the Excel sheet “DataImport” in the individual months and saves them in the respective Excel sheet (for example, “JanData”).



S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

No. Name Function

4 “hideInactiveSheets” Hides all diagrams without content.

5 “refreshPivotTables” Updates the data tables of the workbook.

6 “configurateCharts” Creates the formatting of the diagrams for all diagrams in the workbook.

7 “findInterval” Determines the update interval and finds gaps in the data records. After the evaluation, the information determined is shown in a notification window.

6 Further Notes, Tips & Tricks, etc.


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

6 Further Notes, Tips & Tricks, etc.

Note For reasons of performance the “AutoSave” Excel function is disabled for this macro. If required, save the workbook manually. If you evaluate large data records and save them afterwards, this takes more time during saving and loading of the Excel workbook.

Note For large data volumes it may happen that Excel no longer responds during the execution of the macro. In this case, wait until the macro is finished. Then you can operate Excel again.

7 Links & Literature


S

iem

en

s A

G 2

01

7 A

ll ri

gh

ts r

ese

rve

d

7 Links & Literature Table 7-1

Topic

\1\ Siemens Industry Online Support

https://support.industry.siemens.com

\2\ Download page of the entry https://support.industry.siemens.com/cs/ww/en/view/109739772

\3\

8 History

Table 8-1

Version Date Modifications

V1.0 03/2017 First version

https://support.industry.siemens.com/cs/start?lc=en-DE


Documents

SIMATIC Energy Suite Visualization example of the … Energy Suite – Visualization example of the ... SIMATIC Energy Suite as well as measuring and automation devices you can