OpenModelica

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

OpenModelica User's Guide

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

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, autoreconf, automake, libtool, g++, gfortran (pretty standard compilers)
• boost (used by omsimulator and cppruntime, 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
• 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)
• libcurl (libcurl4-gnutls-dev)

Compilation

The OpenModelica Compiler is the core of the OpenModelica project, which is an open-source Modelica-based modeling and simulation environment intended for industrial and academic usage.

Building the OpenModelica Compiler

• Linux/OSX instructions
• Windows instructions
• Windows Subsystem for Linux

Working with the repository

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

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

If you are a developer and want to update your local git repository to the latest developments or latest heads, use:

# After cloning
> cd OpenModelica
> git checkout master
> git pull
> 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"
# Running master on all submodules might lead to build errors
# so use this to make sure you force all submodules to the commits
# from the OpenModelica glue project which are properly tested
> git submodule update --force --init --recursive

In order to push to the repository, you will push to your own fork of OpenModelica.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 OMOptim.git), these directories will be ignored by autoconf and skipped during compilation.

To checkout a specific version of OpenModelica, say tag v1.16.2 do:

> git clone https://github.com/OpenModelica/OpenModelica.git --recursive
> cd OpenModelica
> git checkout v1.16.2
> git submodule update --force --init --recursive

If you have issues building you can try to clean and reset the repository using:

> git clean -fdx
> git submodule foreach --recursive git clean -fdx
> git reset --hard
> git submodule foreach --recursive git reset --hard
> git submodule update --init --recursive

To check your working copy status and the hashes of the submodules, use:

> git status
> git submodule status --recursive

How to contribute to the OpenModelica Compiler

See CONTRIBUTING.md.

To checkout a minimal version of OpenModelica

> git clone https://openmodelica.org/git-readonly/OpenModelica.git OpenModelica-minimal
> cd OpenModelica-minimal
> git submodule update --init --recursive libraries