XPP WINDOWS INSTALL

These instructions were obtained from the OSU math department web site

Step 0: If you are just upgrading to the newest XPP version jump to Step 2.
Step 1: You must install an X11 server, Xming or you can get an older one from my web page. It is also useful to download the additional X11 fonts from here
- After downloading the two X11 programs, runs them to install on your computer. You can use the default / full installation settings for both the Xming program and the Xming fonts - just make sure that the "Normal PuTTY Link SSH client" option is selected in the Xming program installation settings. I usually include a Desktop shortcut.
- Run the Xming program from (Start) --> All Programs / All Apps --> Xming --> Xming
- Verify the Xming program is running by looking for the "X" icon in the Windows Taskbar Notifications Area.
Step 2: Download XPPAUT "xppwin.zip"
- Extract / unzip the downloaded "xppwin.zip" file, by right-clicking on the file and then clicking to "Extract All...", which will reveal an "xppall" folder.
- Right-click to "Copy" the extracted "xppall" folder, then open your computer's "C:" drive and right-click in a blank space to "Paste" the folder in the root of the "C:" drive. IMPORTANT: The "xppall" folder must be placed so that the full path to the folder is"C:\xppall"
- Extra Step on Windows 8/10(?):
  - Open the "xppall" folder, find and right-click on the "xppaut.exe" file / application, then click to open its "Properties"
  - On the "General" tab under "Security:", click the "Unblock" button to allow the application to run.
  - Click "OK" to close the properties window
- Open the "xppall" folder, find the "xpp - Shortcut" file, right-click on the file to "Copy" the shortcut, and then right-click on a blank space of the Desktop to "Paste" the shortcut on the Desktop.
- To use XPP / XPPAUT, drag and drop ODE files onto the "xpp - Shortcut" on your Desktop.

The best way to use XPP is from the command line as this gives you many more options and much more flexibility.

Here is how to do it.

Click on "Start" and Search Programs for "command prompt" and click on it to bring up a terminal
Click on the terminal to start typing. Navigate to the "xppall" folder by typing:
cd C:/xppall
Test it by typing:
xpp ode/lecar.ode
to load up the good old lecar.ode file
You can directly access the xppaut.exe file from the command line as well but you should be sure to set the proper X11 Display. The xpp.bat file does this for you as well as setting a HOME directory and some other stuff that is largely irrelevant unless you want to call the help stuff from within XPP. For example, you may want to edit this file to set the HOME directory to, say C:\Users\bard or whatever your HOME is.

Customizing defaults

You may want to customize your defaults so that XPP looks the way you want it to when you run it. I generally get rid of some defaults (such as the Bell) and make the fonts bigger so I can see them. This is done by creating a plain text file in your HOME directory called .xpprc . You can use Notepad or any plain text editor to create the file but make sure it is plain text and make sure that the .txt extension is left off. If you are using the commandline, then there is a very simple text editor called edit that can be called from the commmand line is is perfect for this sort of thing. I provide the following example ( .xpprc ) in Windows:

@ bell=0,grads=0,dwcolor=ffffee,forecolor=222200

@ ps_lw=15,ps_color=1,ps_font=Helvetica,ps_fsize=18

@ tutorial=0

This automatically turns the bell off, the fancy menus (grads) off, and the tutorial off. I also change the drawing window color from white to a kind of ivory and the drawing foreground color to a brown. Finally, I change some of the postscript defaults. You can find out more about these options in the xpp_sum.pdf document. The only way to change the fonts and the colors of XPP is via the .xpprc file or through the command line since these are processed before the X11 server starts. Sorry.

Creating your own ODE files

ODE files are just descriptions of what you want to solve. They are plain text files that have the extension .ode but can have any extension you want as XPP ignores it. There are a few rules that are really important to understand:

XPP is case-insensitive so that aBc and ABC are the same to XPP.
There should be a space after the "@" symbol in all options statements
It is generally bad to put spaces between parameter/initial conditions and their values (although this is now OK), so write iapp=0.1 instead of iapp = 0.1
Any line beginning with # is a comment
Always end your ODE file with done If you do you can write lots of instructions after this that will be ignored by the program but may be useful for the user who reads the ODE file.
There is a specific order to the way things are evaluated in ODEs.
- Expressions of the form name=expression are evaluated first and in the order they are written, so if one expression makes a reference to another, then make sure they are ordered appropriately
- Expressions like special name=expression like convolutions etc.
- Differential algebraic expressions
- Calls to C code via the export command
- Right hand sides of the ODEs
- Auxilliary quantities

Look at the many examples to see how to construct your own ODE files.

XPP WINDOWS INSTALL

Customizing defaults

Creating your own ODE files

There are many XPP tutorials out there to help you get started