XPPy is a Python interface for Bard Ermentrout's XPP. XPPy was inspired by a
similar XPP-Matlab interface by Rob Clewley.
The main feature is ability to parse and change XPP's ode and set files, and
run a simulation using XPP. The package contains some data wrapping classes
that aid working with data files produced by XPP (timetraces, allinfo and
bifurcation files files). In addition, it contains additional plotting tools
for matplotlib.
XPPy is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
XPPy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with XPPy in COPYING.txt file. If not, see http://www.gnu.org/licenses/.
Since XPPy is a collection of tools I created on a course of my work, it was primary used by one person, therefore it is not extremely well documented. Nevertheless, there is a Doxygen-generated documentation for the package in the folder doc. You can choose between HTML and LaTeX documentation. To obtain PDF from LaTeX documentation you need to have PDFLaTeX installed. To make PDF file just go to the LaTeX documentation folder and type 'make', e.g.:
cd doc/latex
make
Moreover, every object contains docstring, which more or less explains its purpose.
Before you install XPPy you should install NumPy, which is extensively used
by XPPy. Also if you want to use plotting tools (xppy.utils.plot) you should
have matplotlib. Note that XPPy installation script does not check for those
packages and will install anyway, the error messages will appear when you will
try to import XPPy.
XPPy has a Python distutils setup script. To install XPPy just unpack the source package and change the directory, e.g.
unzip xppy-x.y.z.zip
cd xppy-x.y.z
(where x.y.z is a current version number, e.g. 1.2.3), and type the below command to install the package
python setup.py install
This command will install XPPy in as standard site-packages folder of the Python version used. If you have more then one Python on your machine, it is advisable to check which version is currently used or call a certain version of Python by writing, e.g. python2.6 instead of just python.
If you have some problems or want to know more about the installation process, please check distutils documentation first.
Before you start using XPPy make sure that path to XPP is present in your PATH
variable. Easy way to check that is to type xppaut in the terminal window
anywhere outside the XPP directory, that should open XPP window. If you have
some problems with XPP itself, please refer to XPP documentation.
If you want to refer to XPPy in a publication, you can use
"Nowacki J. XPPy. 2011. Available at: http://seis.bris.ac.uk/~enxjn/xppy/."
or BibTeX:
@misc{xppy,
author = {Nowacki, Jakub},
title = {{XPPy}},
url = {http://seis.bris.ac.uk/~enxjn/xppy/},
year = {2011}
}