OpenModelica is an open-source Modelica-based modeling and simulation environment intended for industrial and academic usage.
wibraun and OpenModelica-Hudson * OMCompiler fb2861e...ecd1fed (1):
  > [cRuntime] fix total simulation time measurement
Latest commit 3689ca2 Oct 16, 2018
Failed to load latest commit information.
.CI Remove working tests from failures Aug 22, 2018
.externalToolBuilders update the Eclipse MDT launchers to agree with the new msys2 Apr 14, 2016
OMCompiler @ ecd1fed * OMCompiler fb2861e...ecd1fed (1): Oct 16, 2018
OMEdit @ b23d97a Updating submodules Oct 11, 2018
OMNotebook @ bec0c66 * OMNotebook c10a192...bec0c66 (1): Feb 15, 2018
OMOptim @ 6cc37d7 * OMOptim 4f4bba2...6cc37d7 (1): Aug 23, 2017
OMPlot @ 8dd29ae * OMPlot 151c704...8dd29ae (1): Oct 3, 2018
OMShell @ f476a5d Updating submodules Feb 1, 2018
OMSimulator @ 8d77f24 * OMSimulator d005ed6...8d77f24 (3): Oct 16, 2018
common @ c9c9085 * common db79fa7... (1): Jul 13, 2018
doc @ d5eccd3 * doc 9aae697...d5eccd3 (2): Sep 29, 2018
libraries @ bcbc063 * libraries bc38980...bcbc063 (1): Oct 10, 2018
testsuite @ f5699c9 Updating submodules Oct 13, 2018
.gitignore change OpenModelicaSetup to OMSetup Jun 18, 2018
.gitmodules Add OMSimulator as submodule Jul 12, 2018
.openmodelica.aspell add cgraphGraphVizFile to the aspell list Aug 2, 2018
.project-sample - add Eclipse files: .project-sample .externalToolBuilders/OMDev-MING… May 12, 2015 Add 50/72 character line commit messages Jun 29, 2015
Jenkinsfile [Jenkins] Build the user's guide Oct 3, 2018 propagate compiler and flags Aug 26, 2018
Makefile.omdev.mingw adaptation to latest msys2 and mingw clang Sep 4, 2018 Fix some lint warnings for Markdown Feb 3, 2018 propagate compiler and flags Aug 26, 2018


OpenModelica is an open-source Modelica-based modeling and simulation environment intended for industrial and academic usage.

Dependencies (Linux/OSX)

Many software packages are included inside the repositories. To get everything running, you will need a few extras:

  • C++11 compiler (if you want a GUI)
  • autoconf, automake, libtool, g++, gfortran (pretty standard compilers)
  • boost (optional; used with configure --with-cppruntime)
  • clang, clang++ (optional, but highly recommended)
  • cmake
  • hwloc (optional; queries the number of hardware CPU cores instead of logical CPU cores)
  • Java JRE (JDK is option; compiles the Java CORBA interface)
  • Lapack/BLAS
  • lpsolve55
  • libhdf5 (optional part of the MSL tables library supported by few other Modelica tools, so it does not do much)
  • libexpat (it's actually included in the FMIL sources which are included... but we do not compile those and it's better to use the OS-provided dynamically linked version)
  • ncurses, readline (optional, used by OMShell-terminal)
  • omniORB (optional; CORBA is used by OMOptim)
  • OpenSceneGraph
  • Qt5 or Qt4, Webkit, QtOpenGL
  • Sundials (optional; adds more numerical solvers to the simulation runtime)

Compilation (Linux/OSX)

> autoconf
> ./configure CC=clang CXX=clang++
> make -j8
> build/bin/omc --version
> (cd testsuite/partest && ./

Compilation (Windows)

Windows instruction are here.

Working with the repository

OpenModelica.git is a superproject. Clone the project using one of:

# Faster pulling by using read-only mirror (low latency in Europe; very important when updating all submodules)
# Replace the pull URL with if you want to pull directly from github
# The default choice is to push to your fork on (SSH). Replace MY_FORK with OpenModelica to push directly to the OpenModelica repositories (if you have access)
> MY_FORK=MyGitHubUserName ; git clone --recursive && (cd OpenModelica && git remote set-url --push origin$MY_FORK/OpenModelica.git && git submodule foreach --recursive 'git remote set-url --push origin `git config --get remote.origin.url | sed s,^.*/,'$MY_FORK'/,`')

If you are a developer and want to track the latest heads, use:

# After cloning
> git submodule foreach --recursive "git checkout master"
# To update; you will need to merge each submodule, but your changes will remain
> git submodule foreach --recursive "git pull"

In order to push to the repository, you will push to your own fork of OMCompiler.git, OMEdit.git, etc. You will need to create a fork of each repository that you want to push to (by clicking the Fork button in the GitHub web interface).

If you do not checkout the repositories for GUI clients (such as OMEdit.git), these directories will be ignored by autoconf and skipped during compilation.

How to contribute to the OpenModelica Compiler


To checkout a minimal version of OpenModelica

> git clone OpenModelica-minimal
> cd OpenModelica-minimal
> git submodule update --init --recursive libraries testsuite OMCompiler common

OpenModelica User's Guide

The User's Guide is automatically generated from the documentation repository.