The FunctionalCuration project is an add-on to Chaste aiming to provide a framework for a coherent approach to model fitting, simulation, comparison and validation. It does this by separate model structure (described in CellML) from details of the experimental scenario to apply to a model. Experiments are described in a protocol language extending SED-ML. For more details see the FunctionalCuration wiki pages.
The inaugural paper on Functional Curation is “High throughput functional curation of cellular electrophysiology models”, published in Prog Biophys Mol Biol in 2011, and the linked wiki page gives details of how to reproduce the results from that paper, having installed the necessary Chaste components and dependencies as set out below.
For work on applying Functional Curation to the cell-based side of Chaste, see our paper in ICCS2013.
This project requires the Chaste source tree to be installed, and you to have write access to your local copy, in order to be usable. You will thus need to install Chaste’s dependencies and build the Chaste software yourself. The easiest way to do this is using an Ubuntu machine (or an Ubuntu virtual machine) as discussed on InstallGuides/UbuntuPackage. For manual installation of each dependency, on any version of Linux, see DeveloperInstallGuide. Note that you will require those Chaste dependencies marked as ‘cardiac only’, and that this project requires at least version 1.39 of the Boost libraries. In order to generate result figures automatically, you will also need to install Gnuplot.
Note that it is advisable to install the source tree on local disk, rather than an NFS mount: we have experienced occasional problems in the latter case, depending on Linux distribution and version. Compiling Chaste is also fairly disk intensive, so benefits from local storage.
Having installed (and ideally tested!) the Chaste source tree, unpack this project
as <Chaste>/projects/FunctionalCuration
. It is crucial to match the folder name
and location, or the project will not work.
If you wish to work with the latest version of the Chaste and project code, you can obtain them from the Chaste repository using the following commands:
Use your email address as the password for the ‘anonymous’ account.
Source code for the project is contained in the src
folder, and tests of its
functionality in tests
. Annotated CellML files suitable for use with the framework
are in cellml
. Some additional interesting locations are:
tests/protocols
contains example protocolssrc/proto/library
contains protocol libraries with functions available to all protocolssrc/proto/parsing/protocol.rnc
is a schema for the protocol XML languageSee the sub-page for our main paper for details of how to reproduce its results. There are also many tests covering the lower-level functionality available for use by protocols. Run all the default tests with:
If you have multiple cores available, you can build in parallel with (using 4 cores for example):
To build an executable that can run a single protocol on a single model, do:
The executable will appear at projects/FunctionalCuration/apps/src/FunctionalCuration
.
You’ll need the environment variable LD_LIBRARY_PATH
set up as described in the Chaste
documentation in order to run it, since it needs to find the Chaste libraries and their
dependencies.
For further information on using Chaste generally, see our extensive guide material. You may also wish to look at some of the basic user tutorials.