Tutorial#

BioSimulators-COPASI is available as a command-line program and as a command-line program encapsulated into a Docker image.

Creating COMBINE/OMEX archives and encoding simulation experiments into SED-ML#

Information about how to create COMBINE/OMEX archives which can be executed by BioSimulators-COPASI is available here.

A list of the algorithms and algorithm parameters supported by COPASI is available at BioSimulators.

Conventions for values of changes to algorithm parameters#

This package follows SED-ML conventions for Boolean-, integer- and float-valued parameters.

New values of parameter KISAO_0000534 (list of deterministic reactions) of KISAO_0000563 (hybrid RK-45 method) should be JSON-encoded lists of the SBML ids of the reactions which should be deterministically simulated using the RK-45 portion of the method. For example, the following SED-ML indicates that the RK-45 partition should consist of the reactions that have the SBML ids reaction_1 and reaction_2.

<algorithm kisaoID="KISAO:0000563">
  <algorithmParameter kisaoID="KISAO:0000534" value="[\"reaction_1\", \"reaction_2\"]" />
</algorithm>

Command-line program for executing COMBINE/OMEX archives#

The command-line program can be used to execute COMBINE/OMEX archives that describe simulations as illustrated below.

usage: biosimulators-copasi [-h] [-d] [-q] -i ARCHIVE [-o OUT_DIR] [-v]

BioSimulators-compliant command-line interface to the COPASI <http://copasi.org> simulation program.

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           full application debug mode
  -q, --quiet           suppress all console output
  -i ARCHIVE, --archive ARCHIVE
                        Path to OMEX file which contains one or more SED-ML-
                        encoded simulation experiments
  -o OUT_DIR, --out-dir OUT_DIR
                        Directory to save outputs
  -v, --version         show program's version number and exit

For example, the following command could be used to execute the simulations described in ./modeling-study.omex and save their results to ./:

biosimulators-copasi -i ./modeling-study.omex -o ./

Docker image with a command-line entrypoint#

The entrypoint to the Docker image supports the same command-line interface described above.

For example, the following command could be used to use the Docker image to execute the same simulations described in ./modeling-study.omex and save their results to ./:

docker run \
    --tty \
    --rm \
    --mount type=bind,source="$(pwd),target=/tmp/working-dir \
    ghcr.io/biosimulators/copasi:latest \
        -i /tmp/working-dir/modeling-study.omex \
        -o /tmp/working-dir

Command-line program for correcting COMBINE/OMEX archives created by COPASI#

The fix-copasi-generated-combine-archive command-line program can be used to align COMBINE/OMEX archives created by COPASI with the specifications of the OMEX manifest and SED-ML formats.

usage: fix-copasi-generated-combine-archive [-h] [-d] [-q] -i IN_FILE -o OUT_FILE

Correct a COPASI-generated COMBINE/OMEX archive to be consistent with the specifications of the OMEX manifest and SED-ML formats

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           full application debug mode
  -q, --quiet           suppress all console output
  -i IN_FILE, --in-file IN_FILE
                        Path to COMBINE/OMEX file to correct
  -o OUT_FILE, --out-file OUT_FILE
                        Path to save the corrected archive

For example, the following command could be used to correct the example COPASI-generated archive in the tests/fixtures directory:

fix-copasi-generated-combine-archive \
    -i tests/fixtures/copasi-34-export.omex \
    -o tests/fixtures/copasi-34-export-fixed.omex