Download & installation guide

Downloads are available for the following platforms:

Documentation

Myokit's documentation is available online. The source code used to generate this documentation can be downloaded here:

Documentation sources (1.25.2)

To rebuild the documentation, the python package sphinx is required.

Updating

To update Myokit, simply download the new source files and copy them over the existing ones. Starting from Myokit 1.9.9, an update tool is available as part of the myo script.

Latest sources (1.25.2)

If you are updating to version 1.18.6 or higher and had previously made changes to settings.py, please update the configuration file myokit.ini (details here).

Configuration files

Myokit stores user-specific settings in configuration files using the extension .ini. On Linux and Mac, these files are located in the user home directory, in the hidden subdirectory ~/.myokit. Users of WinPython will find this directory in the WinPython settings directory. Windows users with a different Python distribution will find the .myokit directory in their user directory.

Single-cell simulations

Single-cell simulations in Myokit are run using the CVODE integrator from Sundials. On most linux systems, this can be installed through a package manager. If you have installed Sundials, but Myokit has trouble finding its header files (with filenames ending in .h), please check the paths specified in myokit.ini (see above ).

If you get an error saying the shared libraries can't be found, please check your LD settings on Linux and Mac or your Path environment variable on Windows.

For more help, contact Michael Clerx (michael@myokit.org) or checkout out the mailing list

Multi-cell simulations with OpenCL

The installation procedure for OpenCL is specific to the used hardware and operating system. In general, you'll need to install two things:

  1. An OpenCL implementation. Different implementations are available from different vendors, usually bundled as an SDK.
  2. An OpenCL supporting driver for the hardware you want to run the code on (Modern drivers tend to support OpenCL already, so you might be able to skip this step).

OpenCL drivers are specific to the device (CPU or GPU) you're using. It is possible to install drivers for several devices side by side. OpenCL implementations are device independent, and you can use the version supplied by any vendor.

For details on installing OpenCL, check with the vendor of your hardware.

Once OpenCL has been installed, Myokit will need to know where it can find the required binaries and header files. The standard configuration files makes a few common guesses, but if Myokit says it cannot find CL/cl.h, you'll need to check the paths given in myokit.ini (see above ).

If you get an error saying the shared libraries cannot be found, please check your LD settings on Linux and Mac or the environment variable Path on Windows.

For more help, contact Michael Clerx (michael@myokit.org) or checkout out the mailing list.