Skip to content

CBMPy biochemical network simulation program via BioSimulators-compliant command-line interface and Docker container

License

Notifications You must be signed in to change notification settings

biosimulators/Biosimulators_iBioSim

 
 

Repository files navigation

Latest release PyPI CI status Test coverage All Contributors

BioSimulators-iBioSim

BioSimulators-compliant command-line interface to the iBioSim simulation program.

This command-line interface and Docker image enable users to use iBioSim to execute COMBINE/OMEX archives that describe one or more simulation experiments (in SED-ML format) of one or more models (in SBML format).

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

A simple web application and web service for using iBioSim to execute COMBINE/OMEX archives is also available at runBioSimulations.

Installation

Install Docker image

docker pull ghcr.io/MyersResearchGroup/ibiosim

Usage

Local Usage

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

BioSimulators-compliant command-line interface to the [iBioSim](https://github.com/MyersResearchGroup/iBioSim) 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

Usage Through Docker Container

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 COMBINE/OMEX archive ./modeling-study.omex and save its outputs to ./.

docker run \
  --tty \
  --rm \
  --mount type=bind,source="$(pwd)",target=/root/in,readonly \
  --mount type=bind,source="$(pwd)",target=/root/out \
  ghcr.io/MyersResearchGroup/ibiosim:latest \
    -i /root/in/modeling-study.omex \
    -o /root/out

Documentation

Documentation is available at https://docs.biosimulators.org/Biosimulators_iBioSim/.

License

This package is released under the Apache-2.0

Development Team

This package was developed by the Genetic Logic Lab at the University of Colorado Boulder with assistance from the contributors listed here.

Questions and comments

Please contact the Genetic Logic Lab with any questions or comments.