OpenModelica ユーザーズガイド和訳 リリース v1.14.1 一般社団法人オープン CAE 学会 2020 年 12 月 19 日 i 目 次 第 1 章 紹介 3 1.1 システム概要 ::::::::::::::::::::::::::::::::::::::::::: 4 1.2 インタラクティブセッションを用いたサンプル :::::::::::::::::::::::: 6 1.3 インタラクティブセッションハンドラに対するコマンドの概要 :::::::::::::::: 26 1.4 コマンドラインからコンパイラを実行する ::::::::::::::::::::::::::: 27 第 2 章 OMEdit - OpenModelica Connection Editor 29 2.1 OMEdit の開始 :::::::::::::::::::::::::::::::::::::::::: 29 2.2 メインウィンドウ＆ブラウザ :::::::::::::::::::::::::::::::::: 31 2.3 パースペクティブ :::::::::::::::::::::::::::::::::::::::: 36 2.4 File(ファイル) メニュー ::::::::::::::::::::::::::::::::::::: 41 2.5 Edit(編集) メニュー ::::::::::::::::::::::::::::::::::::::: 42 2.6 View(ビュー) メニュー :::::::::::::::::::::::::::::::::::::: 42 2.7 Simulation(シミュレーション) メニュー ::::::::::::::::::::::::::::: 43 2.8 Debugger(デバグ) メニュー ::::::::::::::::::::::::::::::::::: 43 2.9 OMSimulator メニュー :::::::::::::::::::::::::::::::::::::: 43 2.10 Tools(ツール) メニュー :::::::::::::::::::::::::::::::::::::: 44 2.11 Help(ヘルプ) メニュー :::::::::::::::::::::::::::::::::::::: 44 2.12 モデルを作成する :::::::::::::::::::::::::::::::::::::::: 45 2.13 モデルのシミュレーション ::::::::::::::::::::::::::::::::::: 47 2.14 シミュレーション結果をプロット :::::::::::::::::::::::::::::::: 51 2.15 再シミュレートするモデル ::::::::::::::::::::::::::::::::::: 52 2.16 3D オブジェクトの可視化 :::::::::::::::::::::::::::::::::::: 53 2.17 リアルタイム FMU のアニメーション :::::::::::::::::::::::::::::: 55 2.18 インタラクティブシミュレーション :::::::::::::::::::::::::::::: 56 2.19 ユーザー定義シェイプの作成方法 - アイコン :::::::::::::::::::::::::: 58 2.20 ドキュメントのグローバルヘッドセクション ::::::::::::::::::::::::: 59 2.21 オプション :::::::::::::::::::::::::::::::::::::::::::: 60 2.22 __OpenModelica_commandLineOptions アノテーション :::::::::::::::::::: 69 2.23 __OpenModelica_simulationFlags アノテーション ::::::::::::::::::::::: 69 2.24 Debugger(デバガ) ::::::::::::::::::::::::::::::::::::::::: 70 2.25 Modelica Standard Library の編集 :::::::::::::::::::::::::::::::: 70 2.26 ステートマシン :::::::::::::::::::::::::::::::::::::::::: 70 2.27 テキストエディタとして OMEdit を使用する :::::::::::::::::::::::::: 71 第 3 章 2D プロット 79 3.1 サンプル ::::::::::::::::::::::::::::::::::::::::::::: 79 3.2 プロットコマンドインターフェース :::::::::::::::::::::::::::::: 80 第 4 章 Solving Modelica Models 83 4.1 Integration Methods :::::::::::::::::::::::::::::::::::::::: 83 4.2 DAE Mode Simulation :::::::::::::::::::::::::::::::::::::: 85 第 5 章 Debugging 87 5.1 The Equation-based Debugger ::::::::::::::::::::::::::::::::::: 87 5.2 The Algorithmic Debugger :::::::::::::::::::::::::::::::::::: 89 第 6 章 Generating Graph Representations for Models 95 第 7 章 FMI and TLM-Based Simulation and Co-simulation of External Models 97 7.1 Functional Mock-up Interface - FMI ::::::::::::::::::::::::::::::: 97 7.2 Transmission Line Modeling (TLM) Based Co-Simulation :::::::::::::::::::: 99 7.3 Composite Model Editing of External Models ::::::::::::::::::::::::::: 100 第 8 章 OMSimulator 117 第 9 章 OpenModelica Encryption 119 9.1 Encrypting the Library :::::::::::::::::::::::::::::::::::::: 119 9.2 Loading an Encrypted Library ::::::::::::::::::::::::::::::::::: 119 9.3 Notes ::::::::::::::::::::::::::::::::::::::::::::::: 119 第 10 章 OMNotebook with DrModelica and DrControl 121 10.1 Interactive Notebooks with Literate Programming ::::::::::::::::::::::::: 121 10.2 DrModelica Tutoring System – an Application of OMNotebook ::::::::::::::::: 122 10.3 DrControl Tutorial for Teaching Control Theory ::::::::::::::::::::::::: 125 10.4 OpenModelica Notebook Commands ::::::::::::::::::::::::::::::: 139 10.5 References ::::::::::::::::::::::::::::::::::::::::::::: 145 第 11 章 Optimization with OpenModelica 147 11.1 Builtin Dynamic Optimization with OpenModelica and IpOpt :::::::::::::::::: 147 11.2 Compiling the Modelica code ::::::::::::::::::::::::::::::::::: 147 11.3 An Example :::::::::::::::::::::::::::::::::::::::::::: 148 11.4 Different Options for the Optimizer IPOPT :::::::::::::::::::::::::::: 150 11.5 Dynamic Optimization with OpenModelica and CasADi ::::::::::::::::::::: 150 11.6 Parameter Sweep Optimization using OMOptim ::::::::::::::::::::::::: 156 第 12 章 Parameter Sensitivities with OpenModelica 163 12.1 Background :::::::::::::::::::::::::::::::::::::::::::: 163 12.2 An Example :::::::::::::::::::::::::::::::::::::::::::: 163 第 13 章 PDEModelica1 169 13.1 PDEModelica1 language elements :::::::::::::::::::::::::::::::: 169 13.2 Limitations :::::::::::::::::::::::::::::::::::::::::::: 170 13.3 Viewing results :::::::::::::::::::::::::::::::::::::::::: 170 第 14 章 MDT – The OpenModelica Development Tooling Eclipse Plugin 171 14.1 Introduction :::::::::::::::::::::::::::::::::::::::::::: 171 14.2 Installation :::::::::::::::::::::::::::::::::::::::::::: 171 14.3 Getting Started :::::::::::::::::::::::::::::::::::::::::: 172 ii 第 15 章 MDT Debugger for Algorithmic Modelica 187 15.1 The Eclipse-based Debugger for Algorithmic Modelica :::::::::::::::::::::: 187 第 16 章 Modelica Performance Analyzer 195 16.1 Profiling information for ProfilingTest ::::::::::::::::::::::::::::::: 196 16.2 Genenerated JSON for the Example :::::::::::::::::::::::::::::::: 199 16.3 Using the Profiler from OMEdit :::::::::::::::::::::::::::::::::: 199 第 17 章 Simulation in Web Browser 201 第 18 章 Interoperability – C and Python 203 18.1 Calling External C functions ::::::::::::::::::::::::::::::::::: 203 18.2 Calling external Python Code from a Modelica model ::::::::::::::::::::::: 204 18.3 Calling OpenModelica from Python Code ::::::::::::::::::::::::::::: 206 第 19 章 OpenModelica Python Interface and PySimulator 209 19.1 OMPython – OpenModelica Python Interface ::::::::::::::::::::::::::: 209 19.2 Enhanced OMPython Features :::::::::::::::::::::::::::::::::: 213 19.3 PySimulator :::::::::::::::::::::::::::::::::::::::::::: 217 第 20 章 OMMatlab – OpenModelica Matlab Interface 219 20.1 Features of OMMatlab :::::::::::::::::::::::::::::::::::::: 219 20.2 Test Commands :::::::::::::::::::::::::::::::::::::::::: 220 20.3 WorkDirectory :::::::::::::::::::::::::::::::::::::::::: 221 20.4 BuildModel :::::::::::::::::::::::::::::::::::::::::::: 221 20.5 Standard get methods ::::::::::::::::::::::::::::::::::::::: 221 20.6 Usage of getMethods ::::::::::::::::::::::::::::::::::::::: 222 20.7 Standard set methods ::::::::::::::::::::::::::::::::::::::: 224 20.8 Usage of setMethods ::::::::::::::::::::::::::::::::::::::: 224 20.9 Advanced Simulation ::::::::::::::::::::::::::::::::::::::: 224 20.10 Linearization ::::::::::::::::::::::::::::::::::::::::::: 225 20.11 Usage of Linearization methods :::::::::::::::::::::::::::::::::: 225 第 21 章 OMJulia – OpenModelica Julia Scripting 227 21.1 Features of OMJulia :::::::::::::::::::::::::::::::::::::::: 227 21.2 Test Commands :::::::::::::::::::::::::::::::::::::::::: 228 21.3 WorkDirectory :::::::::::::::::::::::::::::::::::::::::: 229 21.4 BuildModel :::::::::::::::::::::::::::::::::::::::::::: 229 21.5 Standard get methods ::::::::::::::::::::::::::::::::::::::: 229 21.6 Usage of getMethods ::::::::::::::::::::::::::::::::::::::: 230 21.7 Standard set methods ::::::::::::::::::::::::::::::::::::::: 231 21.8 Usage of setMethods ::::::::::::::::::::::::::::::::::::::: 231 21.9 Advanced Simulation ::::::::::::::::::::::::::::::::::::::: 232 21.10 Linearization ::::::::::::::::::::::::::::::::::::::::::: 232 21.11 Usage of Linearization methods :::::::::::::::::::::::::::::::::: 233 21.12 Sensitivity Analysis :::::::::::::::::::::::::::::::::::::::: 233 21.13 Usage ::::::::::::::::::::::::::::::::::::::::::::::: 234 第 22 章 Jupyter-OpenModelica 235 iii 第 23 章 Scripting API 237 23.1 OpenModelica Scripting Commands ::::::::::::::::::::::::::::::: 237 23.2 Simulation Parameter Sweep ::::::::::::::::::::::::::::::::::: 319 23.3 Examples ::::::::::::::::::::::::::::::::::::::::::::: 319 第 24 章 OpenModelica Compiler Flags 325 24.1 Options :::::::::::::::::::::::::::::::::::::::::::::: 325 24.2 Debug flags :::::::::::::::::::::::::::::::::::::::::::: 345 24.3 Flags for Optimization Modules :::::::::::::::::::::::::::::::::: 352 第 25 章 Small Overview of Simulation Flags 353 25.1 OpenModelica (C-runtime) Simulation Flags ::::::::::::::::::::::::::: 353 第 26 章 Technical Details 363 26.1 The MATv4 Result File Format :::::::::::::::::::::::::::::::::: 363 第 27 章 DataReconciliation 365 27.1 Defining DataReconciliation Problem in OpenModelica :::::::::::::::::::::: 365 27.2 DataReconcilation Support with Scripting Interface :::::::::::::::::::::::: 367 27.3 DataReconciliation Support in OMEdit :::::::::::::::::::::::::::::: 367 27.4 DataReconcilation Results ::::::::::::::::::::::::::::::::::::: 371 第 28 章 Frequently Asked Questions (FAQ) 375 28.1 OpenModelica General :::::::::::::::::::::::::::::::::::::: 375 28.2 OMNotebook ::::::::::::::::::::::::::::::::::::::::::: 375 28.3 OMDev - OpenModelica Development Environment ::::::::::::::::::::::: 376 第 29 章 Major OpenModelica Releases 377 29.1 Release Notes for OpenModelica 2.0.0 :::::::::::::::::::::::::::::: 377 29.2 Release Notes for OpenModelica 1.16.0 :::::::::::::::::::::::::::::: 377 29.3 Release Notes for OpenModelica 1.15.0 :::::::::::::::::::::::::::::: 378 29.4 Release Notes for OpenModelica 1.14.0 :::::::::::::::::::::::::::::: 378 29.5 Release Notes for OpenModelica 1.13.0 :::::::::::::::::::::::::::::: 380 29.6 Release Notes for OpenModelica 1.12.0 :::::::::::::::::::::::::::::: 380 29.7 Release Notes for OpenModelica 1.11.0 :::::::::::::::::::::::::::::: 383 29.8 Release Notes for OpenModelica 1.10.0 :::::::::::::::::::::::::::::: 385 29.9 Release Notes for OpenModelica 1.9.4 :::::::::::::::::::::::::::::: 386 29.10 Release Notes for OpenModelica 1.9.3 ::::::::::::::::::::::::::::::