User interface

The Kappa User Interface (KUI) integrates the simulator with a variety of analysis tools. It provides some graphics to facilitate reasoning about a Kappa model and its behavior.

A UI is always work in progress and there are several interesting Kappa tools that have not yet been integrated. Feedback is important to us.

Detailed documentation for the KUI is forthcoming...

Try Kappa Online

Follow this link to access the browser-based version.

Warning: In this online version, all computation occurs inside your browser using its javascript interpreter! This setup is therefore slow and should be used only as a simple playground.

Download the app

An app is provided for MacOSX (Kappapp.app) and Windows (KappaBin.zip). Computation occurs there at native speed of your CPU. Sorry, linux users should, for now, use geek mode.

Note that the binaries of the command line versions of the Kappa tools are located inside the app directory. ("Inspect package content" of Kappapp.app under MacOSX). This is an easy way of installing the command line tools.

Geek mode

Read in the development section to know how to compile the Kappa REST service on your computer. Launch it (by typing WebSim in a terminal). Now, if you add ?host=http://localhost:8080/ to the URL of the KUI like that, simulation and analyses run directly on your CPU!

Warning: Hopefully not too often but sometime the communication protocol change and the online KUI is aways running the most recent master branch so get sure that you're using the most recnet server...

Programatic interface

Kappa is available as an API from a python. This the kappy package (available in pip). A toy minimal session in ipython using looks like:

In [2]: import kappy

In [3]: model_text = "%agent: A(x)\nA(x[.]), A(x[.]) <-> A(x[1]), A(x[1]) @ 1e-2,1\n%plot: |A(x[.])|\n%init: 100 A()"

In [4]: kappa_client = kappy.KappaStd()

In [5]: kappa_client.add_model_string(model_text)
Out[5]: [...]

In [6]: kappa_client.project_parse()
Out[6]: [...]

In [7]: kappa_client.simulation_start(kappy.SimulationParameter(.1,"[T] > 10"))
Out[7]: {'simulation_artifact_simulation_seed': 297327779}

In [8]: kappa_client.wait_for_simulation_stop()
Out[8]: [...]

In [9]: kappa_client.simulation_plot()
Out[9]:
  [6.7, 48.0],
[...]
  [0.4, 60.0],
  [0.3, 50.0],
  [0.2, 64.0],
  [0.1, 62.0],
  [0.0, 100.0]]}