Menu
▾
▴
Tree [769730] default tip / History
Andrew Miller
Read Me
CellML DOM API README
---------------------
This is the CellML DOM API, an implementation of the CellML API built on top
of the W3C Document Object Model.
This software requires a recent version of libxml2 to compile correctly.
Please follow the instructions in INSTALL to install this software.
Accessing the API interface reference
-------------------------------------
The CellML API uses IDL (interface definition language) to define all
interfaces available through the API. These IDL files contain documentation of
the interfaces inline, using the doxygen style.
All interfaces live in the interfaces directory, and have a .idl file extension.
For example, the core API interfaces are in interfaces/CellML_APISPEC.idl
You can browse a version of the interface reference documentation (which may
not correspond to the version you have) online at
<http://cellml-api.sourceforge.net/>.
Other documentation, includig information on how to build the API, is available
at that site.
You can also generate the documentation as follows:
cd interfaces
doxygen
Documentation will end up in interfaces/docs/html
Using the test programs
-----------------------
You may want to try out the test programs. To simply run the tests, after
configuring and building the API, you simply need to run:
make check
This will compile and run all tests.
After this, you might want to do some manual tests. Please keep in mind that
the test programs are designed to demonstrate the basics underlying the API, and
not necessarily be useful tools in their own right. For actual modelling work,
we recommend using a tool designed for that purpose, such as OpenCell
(see http://www.opencell.org/).
Some examples:
To try out the procedural code generation facilities in OpenCell:
./CellML2C ./tests/test_xml/SimpleDAE_NonLinear.xml
You might also want to see that code with names rather than array indices:
./CellML2C ./tests/test_xml/SimpleDAE_NonLinear.xml useida
Or perhaps in IDA style, with names...
./CellML2C ./tests/test_xml/SimpleDAE_NonLinear.xml useida usenames
To see the source code for the CellML2C test program in this file:
CCGS/tests/CellML2C.cpp
To try out the CellML Language Export Definition Service (CeLEDS):
./testCeLEDS ./tests/test_xml/SimpleDAE_NonLinear.xml ./CeLEDS/languages/MATLAB.xml
Source code is in CeLEDSExporter/tests/testCeLEDS.cpp
To try running a simulation:
LIBRARY_PATH=`pwd`/.libs ./RunCellML tests/test_xml/SimpleDAE_NonLinear.xml step_type ida
Source code is in CIS/tests/RunCellML.cpp
