forked from kdavies4/ModelicaRes
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
93 lines (73 loc) · 3.67 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
#############
ModelicaRes
#############
`ModelicaRes`_ is a free, open-source tool to manage `Modelica`_ simulations,
interpret results, and create publishable figures. It is currently possible to
- Auto-generate simulation scripts,
- Browse data,
- Perform custom calculations, and
- Produce various plots and diagrams.
The figures are generated via `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`_
interpreter with math and matrix functions from `NumPy`_.
For more information, please see the `main project site`_ or the doc folder of
the package for the full documentation and many examples. The development site
is https://github.com/kdavies4/modelicares.
Installation
~~~~~~~~~~~~
An installable copy of this package can be downloaded from the `main project
site`_ or the `PyPI page`_. After extracting the package, run the set up script
(*setup.py*) from the base folder. On Windows, use the following command::
python setup.py install
On Linux, use::
sudo python setup.py install
The *matplotlibrc* file in the *bin* folder has some recommended revisions to
`matplotlib`_'s defaults. To use it, move or copy the file to the working
directory or `matplotlib`_'s configuration directory. See
http://matplotlib.org/users/customizing.html for details.
Credits
~~~~~~~
The main author is Kevin Davies. Kevin Bandy also helped with the development.
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`_).
License terms and development
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
`ModelicaRes`_ is published under the terms of the BSD license (see
LICENSE.txt). Please share any modifications you make (preferably on a Github
fork from https://github.com/kdavies4/ModelicaRes) so that others may benefit
from your work. If you find a bug, please `report it
<https://github.com/kdavies4/ModelicaRes/issues/new>`_. If you have suggestions
for improvements, please `share them here
<https://github.com/kdavies4/ModelicaRes/wiki/Possible-Enhancements>`_.
See also
~~~~~~~~
The following `Python`_ projects are related:
- `awesim`_: helps run simulation experiments and organize results
- `BuildingsPy`_: supports unit testing
- `DyMat`_: exports `Modelica`_ simulation data to comma-separated values (CSV),
`Gnuplot <http://www.gnuplot.info/>`_, MATLAB®, and `Network Common Data Form
(netCDF) <http://www.unidata.ucar.edu/software/netcdf/>`_
- `PyFMI`_: tools to work with models through the Functional Mock-Up Interface
(FMI) standard
- `pysimulator`_: elaborate GUI; supports FMI
.. _ModelicaRes: http://kdavies4.github.io/ModelicaRes/
.. _Modelica: http://www.modelica.org
.. _matplotlib: http://www.matplotlib.org
.. _Python: http://www.python.org
.. _NumPy: http://numpy.scipy.org
.. _main project site: http://kdavies4.github.io/ModelicaRes/
.. _PyPI page: http://pypi.python.org/pypi/ModelicaRes
.. _awesim: https://github.com/saroele/awesim
.. _BuildingsPy: http://simulationresearch.lbl.gov/modelica/buildingspy/
.. _DyMat: http://www.j-raedler.de/projects/dymat/
.. _PyFMI: https://pypi.python.org/pypi/PyFMI
.. _pysimulator: https://code.google.com/p/pysimulator/