ModelicaRes
===========

**Python utilities to set up and analyze Modelica simulation experiments**

The goal of ModelicaRes is to provide an open-source tool to effectively
manage Modelica_ simulations, interpret results, and create publishable
figures.  It is currently possible to auto-generate simulation scripts, run
model executables with varying parameters, browse data, perform calculations,
and produce various plots and diagrams.  The figures are generated by
matplotlib_, which offers a rich set of plotting routines.  ModelicaRes
includes convenient functions to automatically pre-format and label some
figures, like xy plots, Bode and Nyquist plots, and Sankey diagrams.
ModelicaRes can be scripted or run from a Python_ command-line interpreter with
math and matrix functions from NumPy_.

.. image:: doc/_static/browse.png
   :scale: 45 %
   :alt: variable browser

.. image:: examples/PID-nyquist.png
   :scale: 35 %
   :alt: example for modelicares.LinRes.nyquist()

The `main project site <http://kdavies4.github.com/ModelicaRes>`_ includes the
full documentation and many examples.  The development site is
https://github.com/kdavies4/modelicares.

The authors are Kevin Davies and Kevin Bandy.  Third-party code has been
included from Jason Grout (`ArrowLine
<http://old.nabble.com/Arrows-using-Line2D-and-shortening-lines-td19104579.html>`_
class), Jason Heeris (`efficient base-10 logarithm
<http://www.mail-archive.com/matplotlib-users@lists.sourceforge.net/msg14433.html>`_),
Richard Murray (`python-control
<http://sourceforge.net/apps/mediawiki/python-control>`_), and Joerg Raedler
(method to expand a Modelica_ variable tree, from `DyMat
<http://www.j-raedler.de/projects/dymat/>`_)

To install on Linux using a downloaded copy, do the following from the base
folder::

   $ python ./setup.py build
   $ sudo python ./setup.py install

.. _Modelica: http://www.modelica.org/
.. _Python: http://www.python.org/
.. _matplotlib: http://www.matplotlib.org/
.. _NumPy: http://numpy.scipy.org/
