SIMATIC Energy Suite Visualization example of the "*.csv"-energy Data Files

Application Example 03/2017 SIMATIC Energy Suite Visualization example of the "*.csv"-energy Data Files SIMATIC STEP 7 (TIA Portal), SIMATIC Energy Suite https://support.industry.siemens.com/cs/ww/en/view/109739772

Warranty and Liability 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 information 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. Entry ID: 109739772, V1.0, 03/2017 2

Table of Contents 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 Adding an Excel file... 11 4.4 Evaluation... 12 4.5 Saving the evaluation as PDF file... 13 4.6 Operation detail view - diagram... 15 5 Mode of Operation of the VBA Macro... 16 5.1 Structure of the macro... 17 5.2 Structure of the program code... 19 5.3 Core functionalities... 20 5.3.1 Saving as PDF file... 20 5.3.2 Importing data records... 20 5.3.3 Adding data records... 21 5.3.4 Evaluating measuring points... 22 6 Further Notes, Tips & Tricks, etc.... 23 7 Links & Literature... 24 8 History... 24 Entry ID: 109739772, V1.0, 03/2017 3

1 Task 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 CPU S7-1500 kwh kw Evaluation energy data Energy data acquisition with SIMATIC Energy Suite ET 200SP with AI Energy Meter 480V 3VA MCCB SINAMICS G120 SENTRON 7KM PAC SIMOCODE pro V PN Goal of the application example The goal of the application example is the preparation of the archive data of the SIMATIC memory card. 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. Entry ID: 109739772, V1.0, 03/2017 4

2 Solution 2 Solution 2.1 Overview Schematic layout The figure below schematically illustrates the principle of the solution. Figure 2-1 SIMATIC Memory Card (with DataLogs) Download via CPU Web server Excel macro Export Microsoft Excel Evaluation Documentation 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. Entry ID: 109739772, V1.0, 03/2017 5

2 Solution 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 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 CPU 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 109739772_EnS_DataEvaluation_TOOL.xlsm 109739772_EnS_DataEvaluation_DOC_en.docx Note This document includes macros that you have to enable first, after opening. This document Entry ID: 109739772, V1.0, 03/2017 6

3 Basics 3 Basics Measuring points Microsoft Excel 2010 The Excel macro evaluates files of the ".*csv" type that include up to 200 measuring points. In Microsoft Excel 64 bit the number of rows per spreadsheet is limited to 1,048,576. The Excel macro evaluates Excel files with up to 1 million data records per 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. Size of the Excel file Use files up to a size of 180 MB in order to prevent loss of data. 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 macro depends on the number of data records in the file to be evaluated and of the hardware on which the Excel macro is running. Entry ID: 109739772, V1.0, 03/2017 7

4 Operating the Application Example 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 1 2 3 4 5 6 7 7 1 2 3 4 5 6 7 8 Browse button (" ") Load Data button Add Data button Selection of the measuring point (after import) Selection of the year (after import) Evaluation button Save as PDF button Changing Excel spreadsheet Entry ID: 109739772, V1.0, 03/2017 8

4 Operating the Application Example Figure 4-2: Display of the diagrams in the dashboard 1 2 3 1 2 3 Annual overview of the imported data (clickable area) Display of the selected diagram Display of the currently selected month Operating the dashboard The dashboard enables the display of the 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_DataEvaluation_TOOL.xlsm with Microsoft Excel 2010. 2. Enable the macros by clicking the button with the following note Enable Content. Entry ID: 109739772, V1.0, 03/2017 9

4 Operating the Application Example 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 In order to load a file of the type "*.csv" into the macro, proceed as follows: Table 4-2 No. Action 1. Click the "..." button in the Overview Excel sheet and select your Excel file (1). 2. Then click the Load Data (2) button. The import of your energy data into the macro starts. The data is prepared and stored in the hidden Excel sheet DataImport. Note Before you are loading a new 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. Entry ID: 109739772, V1.0, 03/2017 10

4 Operating the Application Example 4.3 Adding an Excel file In order to add a file of the type "*.csv" to an existing evaluation, proceed as follows: Table 4-3 No. Action 1. Click the "..." button in the Overview Excel sheet and select the Excel file (1). 2. Then click the Add Data button (2). The Import of your energy data into the macro starts. The data is prepared and stored in the hidden DataImport Excel sheet. Note Loading time depends on the number of data records. You cannot operate Microsoft Excel during the import. Entry ID: 109739772, V1.0, 03/2017 11

4 Operating the Application Example 4.4 Evaluation Prerequisite You have loaded at least one Excel file into the Excel macro. Table 4-4 No. Action 1. Now select the measuring point and the year that you want graphically evaluated. 2. Click on the Evaluation button 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. Entry ID: 109739772, V1.0, 03/2017 12

4 Operating the Application Example 4.5 Saving the evaluation as PDF file Prerequisite You have evaluated a measuring point. Table 4-5 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. You can print out the diagrams by month as PDF file. If you enable the Overview check box, an annual overview is additionally created. Entry ID: 109739772, V1.0, 03/2017 13

4 Operating the Application Example No. Action 3. Select the diagrams you wish to export. 4. 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. Entry ID: 109739772, V1.0, 03/2017 14

4 Operating the Application Example 4.6 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. Entry ID: 109739772, V1.0, 03/2017 15

5 Mode of Operation of the VBA Macro 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 an Excel file, sorts them and displays the measuring points in example diagrams. All functionalities are described in the VBA. Figure 5-1 Start/Stop Import Import *.csv data Separate date and time Adjust formats No Import all data records? Evaluation Yes Selection measuring point and year Filter measuring point and separate by months Update diagrams Hide inactive sheets No Evaluation successful? Yes Save as PDF file Dashboard Entry ID: 109739772, V1.0, 03/2017 16

5 Mode of Operation of the VBA Macro 5.1 Structure of the macro This application example consists of a total of 28 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 data records and evaluate them. 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". In Chapter 4 the operation of the Excel macro is explained. Data management The macro saves all data from the imported Excel file in the Excel sheet DataImport. 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. Entry ID: 109739772, V1.0, 03/2017 17

5 Mode of Operation of the VBA Macro Diagram Peak Power diagram Display 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. Entry ID: 109739772, V1.0, 03/2017 18

5 Mode of Operation of the VBA Macro 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> when Microsoft Excel is open. Forms Modules The macro works with the following UserForms: UserFormProgress (progress display) UserFormPDF (storage dialog) The program code of the Excel macro is divided in the following seven 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 Modul04_Detailview The functions in this module refer to the Detail view-diagrams. The following functions are stored in this module: Entry ID: 109739772, V1.0, 03/2017 19

5 Mode of Operation of the VBA Macro Filling of the drop-down lists with the available date specifications of the data records Resetting the drop-down lists. Accepting the selection of the drop-down lists for the filter settings of the diagram Modul05_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. Modul06_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. Entry ID: 109739772, V1.0, 03/2017 20

5 Mode of Operation of the VBA Macro 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 Excel 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 searchmp andyears Searches the data records for years and measuring points included and outputs them on the Excel sheet Overview. 5.3.3 Adding data records The Data add function imports the data records of a file of the type "*.csv" into the Excel macro. Existing data records are not deleted. With this function you can summarize divided Excel files in the macro and evaluate the data for an entire year. Call Structure Click the Add Data button in the Excel sheet Overview in order to start the Add data function. By clicking the EvaluationButton in the overview table the EvaluationButton_Click() function is called. This function calls the following subfunctions one after each other: Table 5-3 No. Name Function 1. csvimport Separates the data records of the Excel file to be imported and stores it in the Excel sheet DataImport. Separates date and time Removes spaces and in the data records in the Excel sheet DataImport 2. searchmpandyears Searches the data records for years and measuring points included and outputs them on the Excel sheet Overview. Entry ID: 109739772, V1.0, 03/2017 21

5 Mode of Operation of the VBA Macro 5.3.4 Evaluating measuring points The Evaluation function evaluates the data records and updates the diagrams. Call Structure Click the Evaluation button in the Excel sheet Overview in order to start the Evaluation function. In the click event EvaluationButton_Click() of the Overview table the following core functions are called one after another: Table 5-4 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 etc.) and resets the filter in these Excel sheet. 3 Evaluation Separates the data records from the Excel sheet DataImport in the individual months and saves them in the respective Excel sheet (for example, JanData ). 4 hideinactivesheets Hides all months that don t contain a data record. 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. Entry ID: 109739772, V1.0, 03/2017 22

6 Further Notes, Tips & Tricks, etc. 6 Further Notes, Tips & Tricks, etc. Notes For reasons of performance the AutoSave Excel function is disabled for this macro. If required, save the workbook manually. If you evaluate large files and save them afterwards, this takes more time during saving and loading of the Excel workbook. 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. Entry ID: 109739772, V1.0, 03/2017 23

7 Links & Literature 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 Entry ID: 109739772, V1.0, 03/2017 24