Skip to main content

Latest release PyPI CI status Test coverage All Contributors

BioSimulators-RBApy

BioSimulators-compliant command-line interface to the RBApy simulation program for Resource Balance Analysis (RBA) models.

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

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

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

Installation

BioSimulators-RBApy requires one of the linear programming solvers IBM CPLEX, GLPK, or Gurobi. Note, GLPK is slower than CPLEX and Gurobi. IBM and Gurobi both provide free licenses for academic research.

Install Python package

  1. Install requirements

  2. Install this package

    pip install biosimulators-rbapy

    To use BioSimulators-RBApy with CPLEX, install BioSimulators-RBApy with the cplex option. Note, this requires CPLEX and a CPLEX license:

    pip install rbapy[cplex]

    To use BioSimulators-RBApy with GLPK, install BioSimulators-RBApy with the glpk option. Note, this requires libglpk-dev:

    pip install rbapy[glpk]

    To use BioSimulators-RBApy with Gurobi, install BioSimulators-RBApy with the gurobi option. Note, this requires a Gurobi license:

    pip install rbapy[gurobi]

Install Docker image

docker pull ghcr.io/biosimulators/rbapy

Usage

Local usage

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

BioSimulators-compliant command-line interface to the RBApy simulation program <https://sysbioinra.github.io/RBApy/>.

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

Using BioSimulators-RBApy with a Gurobi license

Gurobi licenses can be used either by setting environment variables prefixed with GRB_ or by saving your license to your home directory (~/gurobi.lic) or the appropriate location for your OS (e.g., /opt/gurobi/gurobi.lic for Linux).

Documentation

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

License

This package is released under the MIT license.

Development team

This package was developed by the Center for Reproducible Biomedical Modeling and the Karr Lab at the Icahn School of Medicine at Mount Sinai in New York with assistance from the contributors listed here.

Questions and comments

Please contact the BioSimulators Team with any questions or comments.

Metadata

Release files for biosimulators-rbapy 0.0.4

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-rbapy 0.0.4
File Size Uploaded Provenance Actions
biosimulators_rbapy-0.0.4.tar.gz 10.4 kB Without provenance Details for biosimulators_rbapy-0.0.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for biosimulators-rbapy 0.0.4
File Interpreter ABI Platform Actions
biosimulators_rbapy-0.0.4-py2.py3-none-any.whl Python 2, Python 3 none any Details for biosimulators_rbapy-0.0.4-py2.py3-none-any.whl

Total release size: 19.8 kB

Release files / biosimulators_rbapy-0.0.4.tar.gz

Download URL biosimulators_rbapy-0.0.4.tar.gz
Size 10.4 kB
Tags Source
SHA-256 checksum
How to use checksums
479ae431fc5709d4dbdf52ede64621434d30088c9b4867052cee308bc05853be
BLAKE2b-256 checksum
How to use checksums
1c07a9f687f254b3ebed90da24485d8687b6a227879824fd9a54ae8e2637a669
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Release files / biosimulators_rbapy-0.0.4-py2.py3-none-any.whl

Download URL biosimulators_rbapy-0.0.4-py2.py3-none-any.whl
Size 9.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
64d347e50610a117b26245b80abf65b358b4fbe21bace7e4dce5e6641571dca2
BLAKE2b-256 checksum
How to use checksums
b0c60be193126764292411901ae3887f9f3bd54a84a45d2aada9db953a483512
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Security for biosimulators-rbapy 0.0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page