@@ -3,173 +3,7 @@ PyDSTool
33
44|buildstatus |_ |coverage |_
55
6- *This is a beta release version. *
6+ *This is a fork of https://github.com/robclewley/pydstool. * It has diverged a
7+ bit. The purpose is to keep a personal copy compatible with python3.6+.
78
8- PyDSTool is a sophisticated & integrated simulation and analysis environment
9- for dynamical systems models of physical systems (ODEs, DAEs, maps, and hybrid
10- systems).
11-
12- PyDSTool is platform independent, written primarily in Python with some
13- underlying C and Fortran legacy code for fast solving. It makes extensive use
14- of the numpy and scipy libraries. PyDSTool supports symbolic math,
15- optimization, phase plane analysis, continuation and bifurcation analysis, data
16- analysis, and other tools for modeling -- particularly for biological
17- applications.
18-
19- The project is fully open source with a BSD license, and welcomes contributions
20- from the community.
21-
22- See more at `pydstool.sourceforge.net <http://pydstool.sourceforge.net >`__.
23-
24- --------------
25-
26- Requirements
27- ~~~~~~~~~~~~
28-
29- * `Python <http://www.python.org >`__ 2.7 or 3.3+;
30- * `numpy <http://www.numpy.org >`__;
31- * `scipy <http://www.scipy.org >`__.
32-
33- Dopri/Radau and AUTO interface requirements
34- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
35-
36- * `swig <http://www.swig.org >`__ > 2.0;
37- * C compiler (e.g, gcc or clang);
38- * GNU Fortran compiler (Radau only).
39-
40- Optional requirements
41- ^^^^^^^^^^^^^^^^^^^^^
42-
43- * `matplotlib <http://www.matplotlib.org >`__
44- Matplotlib is needed for plotting functionality and running many of the examples.
45-
46- Recommended
47- ^^^^^^^^^^^
48-
49- * `ipython <http://www.ipython.org >`__
50-
51- Installation
52- ~~~~~~~~~~~~
53-
54- Debian/Ubuntu
55- ^^^^^^^^^^^^^
56-
57- * install necessary packages:
58-
59- ::
60-
61- sudo apt-get update
62- sudo apt-get install -qq gfortran swig
63- sudo apt-get install -qq python-numpy python-scipy python-matplotlib
64-
65- * install ``PyDSTool ``:
66-
67- ::
68-
69- sudo python setup.py install
70-
71- or
72-
73- ::
74-
75- sudo python setup.py develop
76-
77- Run without ``sudo `` and add flag ``--user `` to install for local
78- user only.
79-
80- Getting started and documentation
81- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
82-
83- See the `online documentation <http://pydstool.sourceforge.net >`__,
84- particularly the GettingStarted and Tutorials pages! Please report bugs
85- and suggestions using the user forum linked to there.
86-
87- Tests and examples
88- ~~~~~~~~~~~~~~~~~~
89-
90- Running examples
91- ^^^^^^^^^^^^^^^^
92-
93- Examples can be found in the ``examples `` directory. Some examples can
94- only be run once, others have produced their output, for instance
95- HH\_ loaded.py, HH\_ loaded\_ dopri.py. Several of the examples require an
96- external compiler. An easy way to run all the examples in an appropriate
97- order is to run the script 'run\_ all\_ tests.py':
98-
99- ::
100-
101- cd examples
102- python run_all_tests.py
103-
104- There is a simple option in that file that you may need to edit in order
105- to select whether the external compiler tests should be run (in case you
106- do not have ``gcc `` and ``gfortran `` working on your system).
107-
108- Note that on some platforms you will see an error report when the script
109- tries to automatically close matplotlib graph windows, to the effect of:
110-
111- ::
112-
113- "Fatal Python error: PyEval_RestoreThread: NULL tstate"
114-
115- This error can be ignored. You may also have to close the plot windows
116- yourself before the script can continue. This will depend on your
117- platform and settings.
118-
119- Running test suite
120- ^^^^^^^^^^^^^^^^^^
121-
122- To run test suite, install `py.test <http://www.pytest.org >`__ and
123- `mock <http://www.voidspace.org.uk/python/mock/ >`__, using ``pip ``:
124-
125- ::
126-
127- sudo pip install py.test mock
128-
129- or package manager:
130-
131- ::
132-
133- sudo apt-get install python-pytest python-mock
134-
135- Then run:
136-
137- ::
138-
139- python setup.py test
140-
141-
142- Getting coverage report
143- ^^^^^^^^^^^^^^^^^^^^^^^
144-
145- * install ``pytest-cov ``
146-
147- ::
148-
149- sudo pip install pytest-cov
150-
151- * run ``py.test ``
152-
153- ::
154-
155- py.test --cov PyDSTool --cov-report html --cov-config .coveragerc
156-
157- * open file ``htmlcov/index.html `` in your browser
158-
159- Credits
160- ~~~~~~~
161-
162- Coding and design by Robert Clewley, Erik Sherwood, Drew LaMar, Vladimir
163- Zakharov, and John Guckenheimer, except where otherwise stated in the
164- code or documentation. (Several other open source codes have been
165- redistributed here under the compatible licenses.)
166-
167- --------------
168-
169-
170-
171- .. |buildstatus | image :: https://travis-ci.org/robclewley/pydstool.svg?branch=master
172- .. _buildstatus : https://travis-ci.org/robclewley/pydstool
173-
174- .. |coverage | image :: https://coveralls.io/repos/robclewley/pydstool/badge.png?branch=master
175- .. _coverage : https://coveralls.io/r/robclewley/pydstool?branch=master
9+ You should checkout the original repository for official version.
0 commit comments