All rights reserved.
THIS PROGRAM IS PROVIDED UNDER THE TERMS OF GPL VERSION 3 LICENSE OR THIS OSMC PUBLIC LICENSE (OSMC-PL). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THE OSMC PUBLIC LICENSE OR THE GPL VERSION 3, ACCORDING TO RECIPIENTS CHOICE.
The OpenModelica software and the OSMC (Open Source Modelica Consortium) Public License (OSMC-PL) are obtained from OSMC, either from the above address, from the URLs: http://www.openmodelica.org or
http://
www.ida.liu.se/projects/OpenModelica
, and in the OpenModelica distribution. GNU version 3 is obtained from: http://www.gnu.org/copyleft/gpl.html.
This program is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, EXCEPT AS EXPRESSLY SET FORTH IN THE BY RECIPIENT SELECTED SUBSIDIARY LICENSE CONDITIONS OF OSMC-PL.
See the full OSMC Public License conditions for more details.
This document is part of OpenModelica: http://www.openmodelica.org
Contact: OpenModelica@ida.liu.se
Modelica® is a registered trademark of the Modelica Association, http://www.Modelica.org
Table of Contents 4
Preface 11
Chapter 1
Introduction 13
1.1 System Overview 14
1.2 Interactive Session with Examples 15
1.2.1 Starting the Interactive Session 15
1.2.2 Using Compiler Debug Trace Flags in Interactive Mode 16
1.2.3 Trying the Bubblesort Function 19
1.2.4 Trying the system and cd Commands 19
1.2.5 Modelica Library and DCMotor Model 20
1.2.6 The val() function 23
1.2.7 BouncingBall and Switch Models 23
1.2.8 Clear All Models 25
1.2.9 VanDerPol Model and Parametric Plot 25
1.2.10 Using Japanese or Chinese Characters 26
1.2.11 Scripting with For-Loops, While-Loops, and If-Statements 27
1.2.12 Variables, Functions, and Types of Variables 28
1.2.13 Getting Information about Error Cause 29
1.2.14 Alternative Simulation Output Formats 29
1.2.15 Using External Functions 29
1.2.16 Using Parallel Simulation via OpenMP Multi-Core Support 29
1.2.17 Loading Specific Library Version 30
1.2.18 Calling the Model Query and Manipulation API 30
1.2.19 Quit OpenModelica 31
1.2.20 Dump XML Representation 32
1.2.21 Dump Matlab Representation 32
1.3 Summary of Commands for the Interactive Session Handler 33
1.4 References 34
Chapter 2
OMEdit – The OpenModelica Connection Editor 35
2.1 Starting OMEdit 35
2.1.1 Microsoft Windows 35
2.1.2 Linux 36
2.1.3 Mac OS X 36
2.2 Introductory Modeling in OMEdit 37
2.2.1 Creating a New File 37
2.2.2 Adding Component Models 38
2.2.3 Making Connections 38
2.2.4 Simulating the Model 40
2.2.5 Plotting Variables from Simulated Models 41
2.3 How to Create User Defined Shapes – Icons 43
2.4 OMEdit Views 45
2.4.1 Modeling View 45
2.4.2 Plotting View 45
2.4.3 Interactive Simulation View 45
2.5 OMEdit Windows/Tabs 46
2.5.1 Library Window 46
2.5.2 Designer Window 47
2.5.3 Plot Variables Window 48
2.5.4 Messages Window 48
2.5.5 Documentation Window 48
2.5.6 Model Browser Window 49
2.6 Dialogs 50
2.6.1 New Model Dialog 50
2.6.2 Simulation Dialog 50
2.6.3 Model Properties Dialog 50
2.6.4 Model Attributes Dialog 51
2.7 Interactive Simulation in OMEdit 52
2.7.1 Invoking Interactive Simulation 52
2.7.2 Interactive Simulation View 52
Chapter 3
2D Plotting and 3D Animation 54
3.1 Enhanced Qt-based 2D Plot Functionality 54
3.2 Simple 2D Plot 55
3.2.1 Plot Functions and Their Options 59
3.2.2 Zooming 61
3.2.3 Plotting all variables of a model 62
3.2.4 Plotting During Simulation 63
3.2.5 Programmable Drawing of 2D Graphics 63
3.2.6 Plotting of Table Data 64
3.3 Java-based PtPlot 2D plotting 65
3.4 3D Animation 66
3.4.1 Object Based Visualization 66
3.4.2 BouncingBall 67
3.4.3 Pendulum 3D Example 69
3.5 References 72
Chapter 4
OMNotebook with DrModelica and DrControl 74
4.1 Interactive Notebooks with Literate Programming 74
4.1.1 Mathematica Notebooks 74
4.1.2 OMNotebook 74
4.2 DrModelica Tutoring System – an Application of OMNotebook 75
4.3 DrControl Tutorial for Teaching Control Theory 81
4.3.1 Feedback Loop 81
4.3.2 Mathematical Modeling with Characteristic Equations 84
4.4 OpenModelica Notebook Commands 90
4.4.1 Cells 90
4.4.2 Cursors 90
4.4.3 Selection of Text or Cells 91
4.4.4 File Menu 91
4.4.5 Edit Menu 92
4.4.6 Cell Menu 92
4.4.7 Format Menu 93
4.4.8 Insert Menu 93
4.4.9 Window Menu 94
4.4.10 Help Menu 94
4.4.11 Additional Features 94
4.5 References 95
Chapter 5
Interactive Simulation 97
5.1 OpenModelica Interactive 97
5.1.1 Interactively Changeable Parameters 97
5.1.2 OpenModelica Interactive Components description 98
5.1.3 Communication Interface 98
5.1.4 Network configuration Settings 99
5.1.5 Interactive Simulation general Procedure 101
5.1.6 Interactive Simulation Example 101
5.2 OPC and OPC UA Interfaces 104
5.2.1 Introduction to the OPC Interfaces 104
5.2.2 Implemented Features 104
5.2.3 Test clients 107
5.2.4 References 107
Chapter 6
Model Import and Export with FMI 1.0 109
6.1 FMI Import 109
6.2 FMI Export 110
Chapter 7
OMOptim – Optimization with OpenModelica 112
7.1 Introduction 112
7.2 Preparing the Model 112
7.2.1 Parameters 112
7.2.2 Constraints 112
7.2.3 Objectives 113
7.3 Set problem in OMOptim 113
7.3.1 Launch OMOptim 113
7.3.2 Create a new project 113
7.3.3 Load models 113
7.3.4 Create a new optimization problem 115
7.3.5 Select Optimized Variables 116
7.3.6 Select objectives 116
7.3.7 Select and configure algorithm 116
7.3.8 Launch 117
7.3.9 Stopping Optimization 117
7.4 Results 117
7.4.1 Obtaining all Variable Values 117
7.5 Window Regions in OMOptim GUI 118
Chapter 8
MDT – The OpenModelica Development Tooling Eclipse Plugin 119
8.1 Introduction 119
8.2 Installation 119
8.3 Getting Started 120
8.3.1 Configuring the OpenModelica Compiler 120
8.3.2 Using the Modelica Perspective 120
8.3.3 Selecting a Workspace Folder 120
8.3.4 Creating one or more Modelica Projects 120
8.3.5 Building and Running a Project 120
8.3.6 Switching to Another Perspective 121
8.3.7 Creating a Package 122
8.3.8 Creating a Class 122
8.3.9 Syntax Checking 123
8.3.10 Automatic Indentation Support 124
8.3.11 Code Completion 124
8.3.12 Code Assistance on Identifiers when Hovering 125
8.3.13 Go to Definition Support 125
8.3.14 Code Assistance on Writing Records 125
8.3.15 Using the MDT Console for Plotting 126
Chapter 9
Modelica Performance Analyzer 128
9.1 Example Report Generated for the A Model 129
9.1.1 Information 129
9.1.2 Settings 129
9.1.3 Summary 129
9.1.4 Global Steps 130
9.1.5 Measured Function Calls 130
9.1.6 Measured Blocks 130
9.1.7 Genenerated XML for the Example 131
Chapter 10
Modelica Algorithmic Subset Debugger 135
10.1 The Eclipse-based Debugging Environment 135
10.2 Starting the Modelica Debugging Perspective 136
10.2.1 Create mos file 136
10.2.2 Setting the debug configuration 137
10.2.3 Setting/Deleting Breakpoints 138
10.2.4 Starting the debugging session and enabling the debug perspective 139
10.3 Debugging OpenModelica 140
10.4 The Debugging Perspective 140
Chapter 11
Interoperability – C, Java, and Python 143
11.1 Calling External C functions 143
11.2 Calling External Java Functions 144
11.3 Python Interoperability 145
Chapter 12
OMPython – OpenModelica Python Interface 147
12.1 About OMPython 147
12.2 Features of OMPython 147
12.3 Using OMPython 147
12.3.1 Test Commands 148
12.3.2 Import As Library 148
12.3.3 Retrieve results from nested dictionaries 148
12.3.4 Set values to nested dictionaries 149
12.3.5 Example 150
12.4 Implementation 151
12.4.1 Client 151
12.4.2 Parser 151
12.4.3 The Simulation Results 153
12.4.4 Record Construction 154
Examples 155
12.4.5 Import As Library 155
12.4.6 Test Commands 157
List of Commands 157
Chapter 13
Frequently Asked Questions (FAQ) 179
13.1 OpenModelica General 179
13.2 OMNotebook 179
13.3 OMDev - OpenModelica Development Environment 180
A.1 OpenModelica 1.8.1, March 2012 181
A.1.1 OpenModelica Compiler (OMC) 181
A.1.2 OpenModelica Notebook (OMNotebook) 182
A.1.3 OpenModelica Shell (OMShell) 182
A.1.4 OpenModelica Eclipse Plug-in (MDT) 182
A.1.5 OpenModelica Development Environment (OMDev) 182
A.1.6 Graphic Editor OMEdit 182
A.1.7 New OMOptim Optimization Subsystem 182
A.1.8 FMI Support 182
A.2 OpenModelica 1.8, November 2011 182
A.2.1 OpenModelica Compiler (OMC) 182
A.2.2 OpenModelica Notebook (OMNotebook) 183
A.2.3 OpenModelica Shell (OMShell) 183
A.2.4 OpenModelica Eclipse Plug-in (MDT) 183
A.2.5 OpenModelica Development Environment (OMDev) 183
A.2.6 Graphic Editor OMEdit 183
A.2.7 New OMOptim Optimization Subsystem 183
A.2.8 FMI Support 183
A.3 OpenModelica 1.7, April 2011 183
A.3.1 OpenModelica Compiler (OMC) 183
A.3.2 OpenModelica Notebook (OMNotebook) 184
A.3.3 OpenModelica Shell (OMShell) 184
A.3.4 OpenModelica Eclipse Plug-in (MDT) 184
A.3.5 OpenModelica Development Environment (OMDev) 184
A.3.6 Graphic Editor OMEdit 184
A.3.7 New OMOptim Optimization Subsystem 184
A.3.8 New Performance Profiler 184
A.4 OpenModelica 1.6, November 2010 184
A.4.1 OpenModelica Compiler (OMC) 185
A.4.2 OpenModelica Notebook (OMNotebook) 185
A.4.3 OpenModelica Shell (OMShell) 185
A.4.4 OpenModelica Eclipse Plug-in (MDT) 185
A.4.5 OpenModelica Development Environment (OMDev) 185
A.4.6 New Graphic Editor OMEdit 185
A.5 OpenModelica 1.5, July 2010 185
A.5.1 OpenModelica Compiler (OMC) 186
A.5.2 OpenModelica Notebook (OMNotebook) 186
A.5.3 OpenModelica Shell (OMShell) 187
A.5.4 OpenModelica Eclipse Plug-in (MDT) 187
A.5.5 OpenModelica Development Environment (OMDev) 187
A.6 OpenModelica 1.4.5, January 2009 187
A.6.1 OpenModelica Compiler (OMC) 187
A.6.2 OpenModelica Notebook (OMNotebook) 187
A.6.3 OpenModelica Shell (OMShell) 187
A.6.4 OpenModelica Eclipse Plug-in (MDT) 187
A.6.5 OpenModelica Development Environment (OMDev) 187
A.1 OpenModelica 1.4.4, Feb 2008 187
A.6.6 OpenModelica Compiler (OMC) 188
A.6.7 OpenModelica Notebook (OMNotebook) 188
A.6.8 OpenModelica Shell (OMShell) 188
A.6.9 OpenModelica Eclipse Plug-in (MDT) 188
A.6.10 OpenModelica Development Environment (OMDev) 188
A.7 OpenModelica 1.4.3, June 2007 188
A.7.1 OpenModelica Compiler (OMC) 188
A.7.2 OpenModelica Notebook (OMNotebook) 189
A.7.3 OpenModelica Shell (OMShell) 189
A.7.4 OpenModelica Eclipse Plug-in (MDT) 189
A.7.5 OpenModelica Development Environment (OMDev) 189
A.8 OpenModelica 1.4.2, October 2006 189
A.8.1 OpenModelica Compiler (OMC) 189
A.8.2 OpenModelica Notebook (OMNotebook) 190
A.8.3 OpenModelica Eclipse Plug-in (MDT) 190
A.8.4 OpenModelica Development Environment (OMDev) 190
A.9 OpenModelica 1.4.1, June 2006 190
A.9.1 OpenModelica Compiler (OMC) 190
A.9.2 OpenModelica Eclipse Plug-in (MDT) 190
A.9.3 OpenModelica Development Environment (OMDev) 190
A.10 OpenModelica 1.4.0, May 2006 190
A.10.1 OpenModelica Compiler (OMC) 191
A.10.2 OpenModelica Shell (OMShell) 191
A.10.3 OpenModelica Notebook (OMNotebook) 191
A.10.4 OpenModelica Eclipse Plug-in (MDT) 191
A.10.5 OpenModelica Development Environment (OMDev) 191
A.11 OpenModelica 1.3.1, November 2005 191
A.11.1 OpenModelica Compiler (OMC) 192
A.11.2 OpenModelica Shell (OMShell) 192
A.11.3 OpenModelica Notebook (OMNotebook) 192
A.11.4 OpenModelica Eclipse Plug-in (MDT) 192
A.11.5 OpenModelica Development Environment (OMDev) 192
B.1 OpenModelica Contributors 2012 193
B.2 OpenModelica Contributors 2011 194
B.3 OpenModelica Contributors 2010 195
B.4 OpenModelica Contributors 2009 197
B.5 OpenModelica Contributors 2008 198
B.6 OpenModelica Contributors 2007 198
B.7 OpenModelica Contributors 2006 199
B.8 OpenModelica Contributors 2005 199
B.9 OpenModelica Contributors 2004 199
B.10 OpenModelica Contributors 2003 199
B.11 OpenModelica Contributors 2002 200
B.12 OpenModelica Contributors 2001 200
B.13 OpenModelica Contributors 2000 200
B.14 OpenModelica Contributors 1999 200
B.15 OpenModelica Contributors 1998 200
Index 201