Skip to content

Commit cb5ebb5

Browse files
author
Dilawar Singh
committed
updated readme for this repo.
1 parent 120b519 commit cb5ebb5

File tree

1 file changed

+3
-169
lines changed

1 file changed

+3
-169
lines changed

README.rst

Lines changed: 3 additions & 169 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)