Skip to main content

Utilities to set up and analyze Modelica simulation experiments

Project description

Utilities to set up and analyze Modelica simulation experiments

ModelicaRes is a free, open-source tool to manage Modelica simulations, interpret results, and create publishable figures. It can be used to

  • generate simulation scripts,
  • load and browse data,
  • perform custom calculations,
  • filter and sort groups of results,
  • produce various plots and diagrams, and
  • export data to various formats via pandas.

The figures are generated via matplotlib, which offers a rich set of plotting routines. ModelicaRes has methods to automatically create and label xy plots, Bode and Nyquist plots, and Sankey diagrams. ModelicaRes can be scripted or used in an interactive Python session with math and matrix functions from NumPy.

Currently, ModelicaRes only loads Dymola/OpenModelica-formatted results (*.mat), but the loading functions are modular so that other formats can be added easily.

Please see the tutorial, which is available as an IPython notebook or online as a static page. For the full documentation and many more examples, see the main website.


The easiest way to install this package is to use pip:

pip install modelicares

On Linux, it may be necessary to have root privileges:

sudo pip install modelicares

Another way is to download and extract a copy of the package. The main website, the GitHub repository, and the PyPI page have copies which include the source code as well as examples and supporting files to build the documentation and run tests. Once you have a copy, run the following command from the base folder:

python install

Or, on Linux:

sudo python install

Some of the required packages may not install automatically.

The matplotlibrc file file has some recommended revisions to matplotlib’s defaults. To use it, copy it to the working directory or matplotlib’s configuration directory. See for details.


The main author is Kevin Davies. Code has been included from:

Suggestions and bug fixes have been provided by Arnout Aertgeerts, Kevin Bandy, Thomas Beutlich, Moritz Lauster, Martin Sjölund, Mike Tiller, and Michael Wetter.

License terms and development

ModelicaRes is published under a BSD-compatible license. Please share any modifications you make (preferably as a pull request to the master branch of the GitHub repository) in order to help others. There are useful development scripts in the hooks folder. If you find a bug, please report it. If you have suggestions, please share them.

See also

  • awesim: helps run simulation experiments and organize results
  • BuildingsPy: supports unit testing
  • DyMat: exports Modelica simulation data to comma-separated values (CSV), Gnuplot, MATLAB®, and Network Common Data Form (netCDF)
  • PyFMI: tools to work with models through the Functional Mock-Up Interface (FMI) standard
  • PySimulator: elaborate GUI; supports FMI

Project details

Release history Release notifications

History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ModelicaRes-0.12.0.tar.gz (1.5 MB) Copy SHA256 hash SHA256 Source None Jun 5, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page