Closed Loop Discrete Events Simulation

MindSphere

Closed Loop Discrete Events Simulation

System Manual

06/2021

Document History 1Introduction 2User rights in "Closed Loop Discrete Events Simulation" 3

Prerequisites 4User Workflow 5User interface "Home" 6Creating Digital Twin Template 7

Using "Workbench" 8Using "Configuration" 9Importing MindSphere data into Discrete Events Simulation Model 10

Legal informationWarning notice system

This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are graded according to the degree of danger.

DANGERindicates that death or severe personal injury will result if proper precautions are not taken.

WARNINGindicates that death or severe personal injury may result if proper precautions are not taken.

CAUTIONindicates that minor personal injury can result if proper precautions are not taken.

NOTICEindicates that property damage can result if proper precautions are not taken.If more than one degree of danger is present, the warning notice representing the highest degree of danger will be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property damage.

Qualified PersonnelThe product/system described in this documentation may be operated only by personnel qualified for the specific task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified personnel are those who, based on their training and experience, are capable of identifying risks and avoiding potential hazards when working with these products/systems.

Proper use of Siemens productsNote the following:

WARNINGSiemens products may only be used for the applications described in the catalog and in the relevant technical documentation. If products and components from other manufacturers are used, these must be recommended or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance are required to ensure that the products operate safely and without any problems. The permissible ambient conditions must be complied with. The information in the relevant documentation must be observed.

TrademarksAll names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.

Disclaimer of LiabilityWe have reviewed the contents of this publication to ensure consistency with the hardware and software described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this publication is reviewed regularly and any necessary corrections are included in subsequent editions.

Siemens AGDigital IndustriesPostfach 48 4890026 NÜRNBERGGERMANY

Ⓟ 10/2021 Subject to changeCopyright © Siemens AG 2021.All rights reserved

Table of contents

1 Document History.................................................................................................................................. 72 Introduction ........................................................................................................................................... 93 User rights in "Closed Loop Discrete Events Simulation" ..................................................................... 114 Prerequisites ........................................................................................................................................ 135 User Workflow...................................................................................................................................... 156 User interface "Home".......................................................................................................................... 177 Creating Digital Twin Template ........................................................................................................... 198 Using "Workbench" .............................................................................................................................. 25

8.1 User interface "Workbench"................................................................................................ 258.2 Creating and viewing a run ................................................................................................ 268.3 Creating and viewing Study................................................................................................ 30

9 Using "Configuration" .......................................................................................................................... 379.1 Overview........................................................................................................................... 379.2 Creating Digital Twin Instance ............................................................................................ 379.3 Creating a new recipe ........................................................................................................ 38

10 Importing MindSphere data into Discrete Events Simulation Model .................................................. 39

Closed Loop Discrete Events SimulationSystem Manual, 06/2021 3

Table of contents

Closed Loop Discrete Events Simulation4 System Manual, 06/2021

Closed Loop Discrete Events Simulation easily connects production systems with corresponding discrete event simulation models and transforms them into digital twins.



Document History 1Date Changes Link2021-06-28 Updated screenshots for "Creating and

viewing a run" Creating and viewing a run (Page 26)

2021-04-15 Added a chapter for creating a new recipe Creating a new recipe (Page 38)2021-01-14 Updated procedure and screenshots for

"Importing MindSphere data into Dis‐crete Events Simulation Model"

Importing MindSphere data into Dis‐crete Events Simulation Model (Page 39)

2020-12-14 Updated screenshots for "Home", "Work‐bench" and "Configuration"

• User interface "Home" (Page 17)• Using "Workbench" (Page 25)• Using "Configuration" (Page 37)

2020-09-30 Added "Digital Twin Templates", Using "Configuration" and "Enterprise Model Definition" chapters

• Overview (Page 37)• Using "Configuration" (Page 37)• AUTOHOTSPOT

2020-06-29 Updated the screenshot for user inter‐face

User interface "Home" (Page 17)

Updated the procedure to create study and runs

Creating and viewing Study (Page 30)

2020-03-27 New document -


Document History


Introduction 2The Closed Loop Discrete Events Simulation application enables the users to create, manage and run digital twin simulations between physical assets and their models. Once the connection is established between a production model and its corresponding production line, all the simulation analytical tools in Discrete Event Simulation becomes the diagnostic tool for that production line.You can import a time-slotted data file into a Discrete Events Simulation model and run the simulation with real-machine data and behavior. This helps to bring a Discrete Events Simulation model of a production line to life by using real plant floor data as an input to the model.

Once the Digital Twin Templates have been created, this application is used to create Studies and trigger Runs. Runs are used to download time-slotted time series data file which is then provided as an input to the Discrete Events Simulation model. An out of the box connector to Siemens Tecnomatix Plant Simulation™ is provided along with the purchase of this application.

OverviewThe Closed Loop Discrete Events Simulation application has the following features:• Connect discrete events simulation models to the onboarded assets. • Manage simulation model parameter configurations for operational data requests. • Request operational data from onboarded assets for any time period and configuration. • Execute Simulations in interactive and non-interactive mode.• Execute simulations using operational data for playback and analysis. • Interface with any discrete events simulation application using available or custom

connectors.

The Closed Loop Discrete Events Simulation application has the following benefits:• Easily create the mapping and connections between discrete events simulation models and

physical assets on the plant floor. • Optimize simulation models using actual machine data.


• Use discrete events simulation models using real production data for playback scenarios. • Gain insights into real machine behavior. • Obtain transparency and design insights from machine downtime, mean-time-to-repair and

mean-time-between-failures. • Diagnose real-time plant floor issues.

The Closed Loop Discrete Events Simulation application has the following use cases:• Model execution using real production data.• Analyze events (downtime) to optimize the virtual model. • Visualize asset performance using actual data, breakdown frequency, mean-time-to-repair,

etc. • Identify constraints by using tools like Bottleneck Analyzer in Siemens Tecnomatix Plant

Simulation.• Identify critical assets in the production line to assign priority. • Monitor KPI's using Discrete Events Simulation model to identify and determine performance

related issues.• Execute production playback scenarios in fast-forward mode for faster diagnostics and

troubleshooting.

Purchase Closed Loop Discrete Events SimulationThe Closed Loop Discrete Events Simulation is part of the MindSphere Closed Loop Foundation offering. You can use the Closed Loop Discrete Events Simulation application by purchasing the following offerings:• IoT Value Plan• Developer Plan• Closed Loop Foundation

Introduction


User rights in "Closed Loop Discrete Events Simulation" 3

The user rights depend on the following user roles:• Admin• UserThe following table gives an overview of the permissions for different user roles:

Right Admin UserCreate Digital Twin Template ✓ Edit Digital Twin Template ✓ Delete Digital Twin Template ✓ Create Digital Twin Instance ✓ Edit Digital Twin Instance ✓ Delete Digital Twin Instance ✓ Create Study ✓ Delete Study ✓ Create a new run ✓ ✓Delete simulation run ✓ ✓Create a recipe ✓ Edit a recipe ✓ Delete a recipe ✓


User rights in "Closed Loop Discrete Events Simulation"


Prerequisites 4This section assumes that Siemens Tecnomatix Plant Simulation™ version 15.1 is being used to model and simulate the shop floor. Enterprise systems administrator needs to download the connector package from Siemens GTAC download area and follow the instructions provided inside the package to install the connector, which is mandatory for the Closed Loop application. Out-of-the-box connector is provided for Siemens Tecnomatix Plant Simulation™ V15.1 with Closed Loop Discrete Events Simulation.Access to the GTAC download site requires an upgrade of the support account. If you have not upgraded your support account, please contact your MindSphere tenant administrator to get your SoldTo ID and Webkey access code. To upgrade your support account, refer Webkey Self Service (https://www2.industrysoftware.automation.siemens.com/webkey/).

ProcedureTo create a closed loop connection, proceed with the following steps:1. In Tecnomatix Plant Simulation™ application, use the MindSphere interface to export the file

that contains machine and properties information.2. Create Digital Twin Template for the asset types. For more information on creating Digital

Twin Template, refer to the chapter "Creating Digital Twin Template".3. In Closed Loop Foundation, use the file exported earlier to map properties between machine

assets and Siemens Tecnomatix Plant Simulation™ model. For more information on mapping, refer to the chapter "Creating Digital Twin Template".

4. Save the template.

ResultThe setup is now ready to be used.


https://www2.industrysoftware.automation.siemens.com/webkey/

Prerequisites


User Workflow 5This section provides details about end to end workflow of Closed Loop Discrete Events Simulations.

① Open the desired plant simulation model② Click "Closed Loop Adapter" icon③ Click "Open MindSphere Adapter" button④ Run MindSphere adapter from Launchpad⑤ Select the desired asset (plant and production line)⑥ Select the desired Digital Twin Template file and asset variables to capture⑦ Select time window for data file and prepare and download the file⑧ Save the data file on Plant simulation machine and open the Plant Simulation window⑨ Click "Import MindSphere data file" button⑩ Run the simulation model with real asset data⑪ Run analytical tool to reduce production cost and maximize efficiency


User Workflow


User interface "Home" 6The following graphic shows the "Closed Loop Discrete Events Simulation" screen:

1 2 3

① Main navigation area ② List of available Digital Twin Templates along with a filter for Digital Twin Template selection③ Latest Runs and Schedules information

See alsoCreating and viewing a run (Page 26)Creating and viewing Study (Page 30)Creating Digital Twin Instance (Page 37)Creating Digital Twin Template (Page 19)


User interface "Home"


Creating Digital Twin Template 7To create and configure a new Digital Twin Template, proceed with the following steps:1. In "Closed Loop Discrete Events Simulation", click "New Digital twin Template" from "Home"

page.2. In the "Details" page,

– In the "Enterprise Application" field, choose the enterprise application from the dropdown– In the "Selected Enterprise Model" field, click "Select Model". Click "Search" to select the

Enterprise model definition file from the existing list. To select the file from your local system, click "Browse Models" and select the file from your system

– Enter the Name and Description for the Digital Twin Template– Click "choose" to upload an icon for the Digital Twin Template– Click "Proceed to next step"


3. In the "Resource Statistics" page,– Enter the Lower Limit and Upper Limit for the required resources– If required, update the Display Name– Click "Proceed to next step"

4. In the "Energy Statistics" page,– Enter the Lower Limit and Upper Limit for the required resources– If required, update the Display Name– Click "Proceed to next step"

Creating Digital Twin Template


5. In the "Mappings" page, – Click "Add a mapping"– Choose the Asset type from the dropdown– Select "Map directly" or "Map with recipe"

If "Map directly", choose a variable from the dropdown.If you select "Map with recipe", choose a recipe from the dropdown or create a new recipe. For more information, refer "Creating a new recipe (Page 38) " .

– Choose the virtual variables– Click "Add Mapping"

The created mapping is displayed on the screen.To delete the mapping, click the "delete" icon next to the mapping in the "Mapping Overview" section.

6. Click "Save" to save the Digital Twin Template.Note• The assets shared from other tenants (shared assets) are visible in the "Asset type"

dropdown, and support the creation of Digital Twin Templates, Digital Twin Instances. It is also possible to run simulation on shared assets.

• A physical variable can be mapped to a single virtual variable.• A virtual variable can be mapped to a single physical variable in a given Asset.• Duplicate mappings are not allowed.



Parameters of new Digital Twin TemplateThe following table describes the parameters of the the new Digital Twin Template:

Parameter DescriptionDetailsEnterprise Application Select the Enterprise Application from the dropdown.Selected Enterprise Model Select the Enterprise Model Definition fileName Name of the Digital Twin TemplateDescription Description for the Digital Twin TemplateData Mapping Create mapping between the virtual and the physical variables Resource Statistics/Energy StatisticsLower Limit Enter the lower limit for the resourceUpper Limit Enter the upper limit for the resourceDisplay Name Add/update the Display name for the resourceMappingAsset type Select the asset type from the dropdownVirtual variables Select the virtual variables from the dropdown



ResultThe Digital Twin Template is successfully created and is visible in the "Home" screen. The details, Resource statistics, Energy statistics and mapping details of the Digital twin template is displayed in the "Details" tab of the "Configuration" screen.





Using "Workbench" 88.1 User interface "Workbench"

The "Workbench" tab displays the available Runs, schedules and Studies for the selected Digital Twin Template.It is also possible to create a run for the selected study.The following graphic shows the "Workbench" screen:

① Selected Digital Twin Template② Selected asset③ Tabs available in "Workbench"④ Runs for the selected Digital Twin Template⑤ Latest Runs and Schedules details


8.2 Creating and viewing a run

Creating a new runTo create a new Run for an existing Study, proceed with the following steps:1. In "Closed Loop Discrete Events Simulation", click "Workbench".2. Select the required Digital Twin Template and asset from the top navigation.3. In "Workbench", click "Add Run" from any of the these tabs- "Runs" or "Studies".4. From the drop-down, select the Study or Studies for which the run needs to be created.

Batch mode creates schedule to run simulations periodically either in batch mode (no manual intervention) or interactive mode.If "Run in Batch Mode" toggle button is enabled, the simulations will be executed in non-interactive mode. It also imports the HTML report of the simulation which can be viewed in the application.

5. Enter the name and description for the new run.6. To execute the simulation, proceed with the following:

– To execute the simulation immediately, enable the "Run Simulation Now" toggle button.Expand the "Simulation" button and select the Start Date and End Date and the start and end time. After creation, this run will be displayed in the "Runs" tab.

– To execute the simulation once in the future, disable the "Run Simulation Now" toggle button. Expand "Simulation" tab and select the "Onetime" radio button.Select the Simulation Start Time, Start and End dates, and From and To time range.

– To execute the simulation at a particular time everyday, disable the "Run Simulation Now" toggle button and select the "Daily" radio button.Select the valid From and Valid until dates from the date picker. Select the Simulation Start Time, From and To time from the drop-down. After creation, this run will be displayed in the "Schedules" tab.

– To execute the simulation on an hourly basis, disable the "Run Simulation Now" toggle button and select the "Hourly" radio button. Select the Valid From and Valid Until dates from the date picker. Select the Simulation Start Time, and the time intervals for which the simulation should be executed from the "Every" drop down menu.

7. Click Ok.8. Click "Simulate".You can Refresh, rerun or delete the run by clicking .

Using "Workbench"8.2 Creating and viewing a run


Note• The application displays an error if the following conditions are not met:

– If the Run name is not unique– If non-numerical value is entered in nano seconds– If there is no time-series data to export

• A Run cannot be created if a Digital Twin Instance is not available for a Digital Twin Template.

The created run is displayed in the "Runs" tab.



Viewing charts and reportsFor any asset configured for a specific Digital Twin template, the Runs data can be viewed in "Workbench" in the "Runs" tab.The created runs are listed in the "Runs" tab of the "Workbench" screen. The runs can be in any of the following states:

States Color codesPass GreenSubmitted YellowError BlackFailed Red

On clicking the required run, the run details are displayed.

In addition, you can Refresh, Download or Rerun the run by clicking next to the specific run.To delete a run, check the checkbox next to that run and click "Delete runs". It is possible to multi-delete the runs. The Simulation statistics can be viewed by clicking the icon.



The transformation data can be viewed by clicking the icon.



8.3 Creating and viewing StudyNoteDigital Twin Template, variable mapping and Digital Twin Instance need to be configured in Closed Loop Foundation before creating a Study. For more information, refer to the "Closed Loop Foundation" document.

Using "Workbench"8.3 Creating and viewing Study


Creating a new StudyTo prepare data for simulation, proceed with the following steps:1. In "Closed Loop Discrete Events Simulation", click "Create Study" by using any of the following

ways:– From "Home" tab: click the required Digital Twin Template. Click and click "Create Study".– From "Configuration" tab: From top navigation, select the required Digital Twin template

from the drop-down. Click "Studies" tab. Click "Create Study".2. In "Studies" tab, click "Create Study".3. In "Study Details" page, enter the Study Name and Study Description. Click "Proceed to next

step".



4. In "Resource Statistics" page, select the required resources, enter the Lower Limit and Upper Limit. Click "Proceed to next step".



5. In "Energy Statistics" page, select the required resources, enter the Lower Limit and Upper Limit. Click "Proceed to next step".



6. In the "Mapping" page, select the required mappings available in the list by clicking the checkbox next to each mapping. Enter the "Scaling Factor".

7. Click Save.The created Study will be displayed in the "Studies" tab.

Note• The application displays an error if the following conditions are not met:

– If the data is not provided in the right format– If the Study name is not unique for the selected asset

Viewing studyThe created Study can be viewed in the "Studies" tab in "Workbench" and "Configuration".



On clicking the show/hide button next to the study, the related runs for that study is displayed.On clicking on the study, the Study details will be displayed.





Using "Configuration" 99.1 Overview

The Digital Twin Template allows you to connect the virtual simulation model to the onboarded asset or assets in MindSphere. This mapping allows the link between the signal/parameter in the virtual model and the measurable variable from the aspect of the asset type. The mapping also saves the data type and units for the both virtual and physical models. The Digital Twin Template and the instance can then be used to set up the configuration for a simulation run. Once the simulation is executed, the foundation provides services to establish the traceability between the simulation and the simulation result. For more information on creating a Digital Twin Template and an instance, refer Creating Digital Twin Template (Page 19) and Creating Digital Twin Instance (Page 37).

9.2 Creating Digital Twin InstanceDiscete Events Simulation application allows you to create multiple Digital Twin Instances. To create and configure a new Digital Twin Instance, proceed with the following steps:1. In Closed Loop Discrete Events Simulation, select "Configuration".2. From the top navigation, select the template for which the Digital Twin Instance needs to be

created.3. Select "Instances" and click "Digital Twin Instances".4. Enter the Virtual Instance Name. 5. Select the Asset from the dropdown.6. Click Save.

Parameters of new Digital Twin InstanceThe following table describes the parameters of the new Digital Twin Instance:

Parameter DescriptionAssets Select the asset from the dropdownVirtual Instance ID ID of virtual instanceVirtual Instance Name Name of the virtual instance


9.3 Creating a new recipeRecipes are chain of operations. Each operation is a function. This application enables the user to create a recipe from the "Configuration" tab. The following section describes the procedure to create a recipe.

ProcedureTo create a new recipe, proceed with the following steps:1. In the "Configuration" tab, click "Recipes". Click "Add a recipe".2. To create a recipe from the existing recipes, choose a recipe from the available list.

To create a new recipe, click "Create a new Recipe".3. Enter the name for the recipe. 4. Choose the asset type from the dropdown.5. Enter the description for the recipe.6. In the Transformations section, select the Function from the dropdown.7. Choose the Input variable and enter the name for the output function.

Add a new recipe step if applicable.8. Click Save.

ResultThe recipe is created successfully and is displayed on the Recipes screen.

Using "Configuration"9.3 Creating a new recipe


Importing MindSphere data into Discrete Events Simulation Model 10

This section assumes that the connector is set up on user’s machine.An out-of-the-box connector is provided for Siemens Tecnomatix Plant Simulation™ version 16.0.5.2151 with Closed Loop Discrete Events Simulation application. To set up connector, please follow the deployment guide packaged along with the connector downloaded from GTAC.Once the connector is deployed, perform the following steps to run the simulation. To load the Digital Twin Templates, it is first required to set the access token.The "Settings" tab allows the user to configure objects, attributes to be included in the model definition file, and excluded from the available list of objects. 1. In the "MindSphere Interface", open any Digital Twin and select "Settings".2. Click "Set Access Token". 3. If the access token is copied already, then the values are populated in the related fields in the

"MindSphere Access Token" section. Else, navigate to the "Closed Loop Discrete Events Simulation" application and click "Copy access information".

If the MindSphere Interface throws an error while fetching the Digital Twin Templates, it is recommended to copy the latest token from the application. This is because this token expires every 30 minutes.


4. In the "MindSphere Interface" and in the "Settings" tab, click "Set Access Token" to populate the fields with the related data.

Importing MindSphere data into Discrete Events Simulation Model


5. In the "MindSphere" tab, click "Load(Digital Twin Templates)" to load the related Digital Twin Templates.

6. Select the required run from the table. Click the "Load" button next to Simulation Package, to load the selected run in the simulation model. The "Active" checkbox is automatically selected.

ResultYou can now perform different analysis like Bottleneck Analysis, Production playback, etc.





Documents

Closed Loop Discrete Events Simulation