Skip to content

XPP Lab v0.1.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Oct 10:00
· 34 commits to main since this release
v0.1.1
0d83722

XPP Lab 0.1.1: XPPAUT 8.0's engine, giving the same numbers as XPPAUT, with a desktop app for Windows, macOS and Linux and a Python package. It needs no X server, compiler or Terminal.

New in 0.1.1

  • A new name: XPP Lab. Another project already goes by XPP Studio, so this one is now XPP Lab. The Python package is xpplab (pip install xpplab, import xpplab), the MCP server xpplab-mcp, and the app xpplab. The old repository address leads here. The app keeps the settings and window layout of 0.1.0; examples you edited and saved with 0.1.0 stay in Documents/XPP Studio.
  • AUTO no longer leaves a model broken. When a continuation failed, XPPAUT's AUTO interface left the parameter at AUTO's last trial value: NaN when it stopped with MX, or a value far outside the window after a jump. Every later run of the model was then wrong. Running AUTO on every example model found this in 39 of them, coaster2D among them (#8). The parameters now return to their values after every run.
  • A singular matrix ends only the continuation. In 7 example models AUTO meets a singular matrix and, as in XPPAUT, tries to end the program; the engine then stopped working until the model was loaded again. Now only the continuation stops, and the points computed so far stay in the diagram.
  • The bifurcation plot fits its axes to the points inside the window AUTO was asked to cover, so one stray point no longer sets the scale.

Download and run

Your computer Download The first time you open it
Windows 10 or 11, 64-bit XPPLab-Windows-x64.zip Unzip it anywhere and run xpplab.exe. If Windows says "Windows protected your PC", click More info, then Run anyway.
macOS 11 or later, Apple silicon or Intel XPPLab-macOS.dmg Open it and drag the app to Applications. On macOS 15 and later, open the app once, then click Open Anyway in System Settings > Privacy & Security. On macOS 14 and earlier, Control-click the app and choose Open.
Linux, x86-64 (built on Ubuntu 22.04) XPPLab-Linux-x86_64.tar.gz tar xzf XPPLab-Linux-x86_64.tar.gz, then run XPPLab-Linux-x86_64/xpplab.

The warnings appear because the apps are not yet signed with a paid certificate. The checksums at the end let you check a download.

Try it: the Morris-Lecar model opens. Press Run, open the Phase Plane tab, tick Nullclines, then drag the iapp slider. The File menu opens the other 150 example models that come with XPPAUT, and F1 opens the manual and its tutorial.

Python

The same engine, with AUTO, from Python 3.9 or newer on any of the three systems:

pip install xpplab==0.1.1

Then see the Python guide.

What's inside

  • XPPAUT 8.0's own engine. Every example model gives the same output as unmodified XPPAUT, digit for digit. The only changes fix genuine bugs, listed in upstream-issues.
  • Phase plane:
    • nullclines and the direction field;
    • equilibria by stability, and the manifolds of saddles;
    • click-to-start trajectories.
  • Bifurcations: AUTO without the dialogs. A table of special points, and for each one the continuations that make sense.
  • Workspace: a slider for every parameter, with live re-simulation, plus parameter sweeps, Range, and boundary-value problems.
  • 3D view and the Animator: XPPAUT's .ani files, played over the run.
  • Analysis:
    • phase response curves and the H function;
    • spectra, histograms, correlations and the Liapunov exponent;
    • fitting to data.
  • Editor, command window and figure export. The editor's errors point at the line, and the command window takes XPPAUT's two-key commands. Figures export as PNG and SVG, data as CSV.

Found a problem, or a model that works in XPPAUT but not here? Please open an issue.

XPP Lab is free software under the GPL. It is an independent rebuild of G. Bard Ermentrout's XPPAUT, and is not endorsed by him; see THIRD-PARTY-NOTICES.md for the work of others that it contains.

Checksums (SHA-256)

99693a3cde15563e70692006ce47d400e2651f23883b309d80fb5857ae493fc2  XPPLab-Linux-x86_64.tar.gz
e57385135b0d8044eef5976775b4ba203890eee44804a0a7c147684420832ed8  XPPLab-Windows-x64.zip
3209ea1fd359e97a498a3153f421be00ff0814f5d44ca54c0f61a9e0ceb69e6c  XPPLab-macOS.dmg
8021779e597103dff53a331f07ff217c6ac15c4666f6db5f5c8811f54fac8e93  xpplab-0.1.1-py3-none-macosx_10_13_universal2.whl
8d4b88e892fdac969036cdd1ba3f181b5b3c954cf0cd0f12947c3f3b97ec402a  xpplab-0.1.1-py3-none-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
4acd02e2ffb04ab94a4760940a0481396e977fdb53832b69f307456678c0aa35  xpplab-0.1.1-py3-none-win_amd64.whl

Full Changelog: v0.1.0...v0.1.1

Assets 9
Loading