Skip to main content

description

Project description

Latest release PyPI CI status Test coverage Binder All Contributors

BioSimulators utils

Command-line application and high-level utilities for reading, writing, validating, and executing COMBINE/OMEX format files that contain descriptions of simulations in Simulation Experiment Description Markup Language (SED-ML) format with models in formats such as the BioNetGen Language (BNGL) and the Systems Biology Markup Language (SBML).

Installation

Requirements

  • Python >= 3.7
  • pip (latest)

Optional requirements

  • Docker: required to execute containerized simulation tools
  • Java: required to parse and validate NeuroML/LEMS files
  • Perl: required to parse and validate BioNetGen files
  • RBApy: required to parse and validate RBA files
  • XPP: required to parse and validate XPP files

Install latest release from PyPI

pip install biosimulators-utils

Install latest revision from GitHub

pip install git+https://github.com/biosimulators/Biosimulators_utils.git#biosimulators_utils

Installation optional features

To use BioSimulators utils to validate BNGL models, install BioSimulators utils with the bgnl option:

pip install biosimulators-utils[bgnl]

To use BioSimulators utils to validate CellML models, install BioSimulators utils with the cellml option:

pip install biosimulators-utils[cellml]

To use BioSimulators utils to validate LEMS models, install Java and then install BioSimulators utils with the lems option:

pip install biosimulators-utils[lems]

To use BioSimulators utils to validate NeuroML models, install BioSimulators utils with the neuroml option:

pip install biosimulators-utils[neuroml]

To use BioSimulators utils to validate SBML models, install BioSimulators utils with the sbml option:

pip install biosimulators-utils[sbml]

To use BioSimulators utils to validate SBML models, install BioSimulators utils with the smoldyn option:

pip install biosimulators-utils[smoldyn]

To use BioSimulators utils to convert Escher metabolic maps to Vega flux data visualizations, install BioSimulators utils with the escher option:

pip install biosimulators-utils[escher]

To use BioSimulators utils to execute containerized simulation tools, install BioSimulators utils with the containers option:

pip install biosimulators-utils[containers]

To use BioSimulators utils to log the standard output and error produced by simulation tools, install BioSimulators utils with the logging option:

pip install biosimulators-utils[logging]

Dockerfile and Docker image

This package is available in the ghcr.io/biosimulators/biosimulators Docker image. This image includes all of the optional dependencies and installation options.

To install and run this image, run the following commands:

docker pull ghcr.io/biosimulators/biosimulators
docker run -it --rm ghcr.io/biosimulators/biosimulators

This image includes this package, as well as standardized Python APIs for the simulation tools validated by BioSimulators. Because this image aims to incorporate as many simulation tools as possible within a single Python environment, this image may sometimes lag behind the latest version of this package.

The Dockerfile for this image is available here.

Tutorials

Command-line interface

A tutorial for the command-line interface is available here.

Python API

Interactive tutorials for using BioSimulators-utils and Python APIs for simulation tools to execute simulations are available online from Binder here. The Jupyter notebooks for these tutorials are also available here.

API documentation

API documentation is available here.

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 in New York and the Center for Reproducible Biomedical Modeling with assistance from the contributors listed here.

Contributing to BioSimulators utils

We enthusiastically welcome contributions to BioSimulators utils! Please see the guide to contributing and the developer's code of conduct.

Funding

This work was supported by National Institutes of Health award P41EB023912.

Questions and comments

Please contact the BioSimulators Team with any questions or comments.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

biosimulators_utils-0.2.3.tar.gz (531.6 kB view details)

Uploaded Source

Built Distribution

biosimulators_utils-0.2.3-py3-none-any.whl (586.5 kB view details)

Uploaded Python 3

File details

Details for the file biosimulators_utils-0.2.3.tar.gz.

File metadata

  • Download URL: biosimulators_utils-0.2.3.tar.gz
  • Upload date:
  • Size: 531.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/6.5.0-1025-azure

File hashes

Hashes for biosimulators_utils-0.2.3.tar.gz
Algorithm Hash digest
SHA256 11b809b03fcf3ca435b51d94099373c7e6f8588efe66166079b6e1f8e23fb8e0
MD5 30060d1680d072aa74c74784b996542d
BLAKE2b-256 3493b6a2733e24660ccdbd5c1a36ad943a5bc81c69ad56032f5879d80ee7682a

See more details on using hashes here.

File details

Details for the file biosimulators_utils-0.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for biosimulators_utils-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d6e712f815d7f2535790d5e3917b3f687045a00301552f8fcdb8ca54b2caaf34
MD5 34696f857cd626e61a4ad2c311a0ed1d
BLAKE2b-256 417d8f937bc34c8d35c9203271ae13223a0c49d7a4bf851ff063b15a31fd1555

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page