BioSimulators-BioNetGen

BioSimulators-compliant command-line interface and Docker image for the BioNetGen simulation program.

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

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

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

Installation

Install Python package

After installing BioNetGen, use pip to install this package as illustrated below.

pip install biosimulators-bionetgen

Install Docker image

docker pull ghcr.io/biosimulators/bionetgen

Usage

Local usage

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

BioSimulators-compliant command-line interface to the BioNetGen simulation program <https://bionetgen.org>.

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/biosimulators/bionetgen:latest \
    -i /root/in/modeling-study.omex \
    -o /root/out

Documentation

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

License

This package is released under the MIT license.

Development team

This package was developed by the Karr Lab at the Icahn School of Medicine at Mount Sinai, Ali Sinan Saglam in the Faeder Lab at the University of Pittsburgh, and the Center for Reproducible Biomedical Modeling with assistance from the contributors listed here.

Questions and comments

Please contact the BioSimulators Team with any questions or comments about the command-line program or Docker image. Please contact Ali Sinan Saglam with any questions or comments about BioNetGen.

Metadata

Release files for biosimulators-bionetgen 0.1.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for biosimulators-bionetgen 0.1.20
File	Size	Uploaded
biosimulators_bionetgen-0.1.20.tar.gz	15.6 kB	Feb 25, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for biosimulators-bionetgen 0.1.20
File	Interpreter	ABI	Platform	Reset
biosimulators_bionetgen-0.1.20-py2.py3-none-any.whl 16.7 kB Feb 25, 2022	Python 2, Python 3	none	any	Details

Total release size: 32.4 kB

Release files / biosimulators_bionetgen-0.1.20.tar.gz

Download URL	biosimulators_bionetgen-0.1.20.tar.gz
Size	15.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`8f38a10d489f15109a87ad6ef0ad9ecfa3ff2a2e3c301308ceb48e4e55d1ee3c`
BLAKE2b-256 checksum How to use checksums	`ea992a0be8f4dd25cfb6c070b21dea224fd1e0b6923fe179b121b7133fbf4ef6`
Upload date	Feb 25, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10`

Release files / biosimulators_bionetgen-0.1.20-py2.py3-none-any.whl

Download URL	biosimulators_bionetgen-0.1.20-py2.py3-none-any.whl
Size	16.7 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`560a7159552bad2501e4a03bc90a95fba0dbb12ed86a88f58a5d3bf17a8c916a`
BLAKE2b-256 checksum How to use checksums	`2e78ed8ea5d76c14cba0aa3c2ad407ba0e3b2f86648513d9083b89b3ebf5ca9a`
Upload date	Feb 25, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10`