[](https://github.com/biosimulators/Biosimulators_utils/releases)
[](https://pypi.org/project/biosimulators-utils/)
[](https://github.com/biosimulators/Biosimulators_utils/actions?query=workflow%3A%22Continuous+integration%22)
[](https://codecov.io/gh/biosimulators/Biosimulators_utils)
[](https://tutorial.biosimulators.org/)
[](#contributors-)
# BioSimulators utils
Command-line application and high-level utilities for reading, writing, validating, and executing [COMBINE/OMEX format](https://combinearchive.org/) files that contain descriptions of simulations in [Simulation Experiment Description Markup Language](https://sed-ml.org/) (SED-ML) format with models in formats such as the [BioNetGen Language](https://bionetgen.org) (BNGL) and the [Systems Biology Markup Language](http://sbml.org) (SBML).
## Installation
### Requirements
* Python >= 3.7
* pip (latest)
### Optional requirements
* [Docker](https://www.docker.com/): required to execute containerized simulation tools
* [Java](https://www.java.com/): required to parse and validate NeuroML/LEMS files
* [Perl](https://www.perl.org/): required to parse and validate BioNetGen files
* [RBApy](https://sysbioinra.github.io/RBApy/): required to parse and validate RBA files
* [XPP](http://www.math.pitt.edu/~bard/xpp/xpp.html): 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](https://www.java.com/) 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](https://github.com/biosimulators/Biosimulators/blob/dev/Dockerfile).
## Tutorials
### Command-line interface
A tutorial for the command-line interface is available [here](https://docs.biosimulators.org/Biosimulators_utils/).
### Python API
Interactive tutorials for using BioSimulators-utils and Python APIs for simulation tools to execute simulations are available online from Binder [here](https://tutorial.biosimulators.org/). The Jupyter notebooks for these tutorials are also available [here](https://github.com/biosimulators/Biosimulators_tutorials).
## API documentation
API documentation is available [here](https://docs.biosimulators.org/Biosimulators_utils/).
## License
This package is released under the [MIT license](LICENSE).
## Development team
This package was developed by the [Karr Lab](https://www.karrlab.org) at the Icahn School of Medicine at Mount Sinai in New York and the [Center for Reproducible Biomedical Modeling](http://reproduciblebiomodels.org) with assistance from the contributors listed [here](CONTRIBUTORS.md).
## Contributing to BioSimulators utils
We enthusiastically welcome contributions to BioSimulators utils! Please see the [guide to contributing](CONTRIBUTING.md) and the [developer's code of conduct](CODE_OF_CONDUCT.md).
## Funding
This work was supported by National Institutes of Health award P41EB023912.
## Questions and comments
Please contact the [BioSimulators Team](mailto:info@biosimulators.org) with any questions or comments.
Raw data
{
"_id": null,
"home_page": "https://github.com/biosimulators/Biosimulators_utils",
"name": "biosimulators-utils",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "systems, biology, modeling, simulation",
"author": "Center for Reproducible Biomedical Modeling",
"author_email": "info@biosimulators.org",
"download_url": "https://files.pythonhosted.org/packages/34/93/b6a2733e24660ccdbd5c1a36ad943a5bc81c69ad56032f5879d80ee7682a/biosimulators_utils-0.2.3.tar.gz",
"platform": null,
"description": "[](https://github.com/biosimulators/Biosimulators_utils/releases)\n[](https://pypi.org/project/biosimulators-utils/)\n[](https://github.com/biosimulators/Biosimulators_utils/actions?query=workflow%3A%22Continuous+integration%22)\n[](https://codecov.io/gh/biosimulators/Biosimulators_utils)\n[](https://tutorial.biosimulators.org/)\n[](#contributors-)\n\n# BioSimulators utils\nCommand-line application and high-level utilities for reading, writing, validating, and executing [COMBINE/OMEX format](https://combinearchive.org/) files that contain descriptions of simulations in [Simulation Experiment Description Markup Language](https://sed-ml.org/) (SED-ML) format with models in formats such as the [BioNetGen Language](https://bionetgen.org) (BNGL) and the [Systems Biology Markup Language](http://sbml.org) (SBML).\n\n## Installation\n\n### Requirements\n* Python >= 3.7\n* pip (latest)\n\n### Optional requirements\n\n* [Docker](https://www.docker.com/): required to execute containerized simulation tools\n* [Java](https://www.java.com/): required to parse and validate NeuroML/LEMS files\n* [Perl](https://www.perl.org/): required to parse and validate BioNetGen files\n* [RBApy](https://sysbioinra.github.io/RBApy/): required to parse and validate RBA files\n* [XPP](http://www.math.pitt.edu/~bard/xpp/xpp.html): required to parse and validate XPP files\n\n### Install latest release from PyPI\n```\npip install biosimulators-utils\n```\n\n### Install latest revision from GitHub\n```\npip install git+https://github.com/biosimulators/Biosimulators_utils.git#biosimulators_utils\n```\n\n### Installation optional features\n\nTo use BioSimulators utils to validate BNGL models, install BioSimulators utils with the `bgnl` option:\n```\npip install biosimulators-utils[bgnl]\n```\n\nTo use BioSimulators utils to validate CellML models, install BioSimulators utils with the `cellml` option:\n```\npip install biosimulators-utils[cellml]\n```\n\nTo use BioSimulators utils to validate LEMS models, install [Java](https://www.java.com/) and then install BioSimulators utils with the `lems` option:\n```\npip install biosimulators-utils[lems]\n```\n\nTo use BioSimulators utils to validate NeuroML models, install BioSimulators utils with the `neuroml` option:\n```\npip install biosimulators-utils[neuroml]\n```\n\nTo use BioSimulators utils to validate SBML models, install BioSimulators utils with the `sbml` option:\n```\npip install biosimulators-utils[sbml]\n```\n\nTo use BioSimulators utils to validate SBML models, install BioSimulators utils with the `smoldyn` option:\n```\npip install biosimulators-utils[smoldyn]\n```\n\nTo use BioSimulators utils to convert Escher metabolic maps to Vega flux data visualizations, install BioSimulators utils with the `escher` option:\n```\npip install biosimulators-utils[escher]\n```\n\nTo use BioSimulators utils to execute containerized simulation tools, install BioSimulators utils with the `containers` option:\n```\npip install biosimulators-utils[containers]\n```\n\nTo use BioSimulators utils to log the standard output and error produced by simulation tools, install BioSimulators utils with the `logging` option:\n```\npip install biosimulators-utils[logging]\n```\n\n## Dockerfile and Docker image\n\nThis package is available in the `ghcr.io/biosimulators/biosimulators` Docker image. This image includes all of the optional dependencies and installation options.\n\nTo install and run this image, run the following commands:\n```\ndocker pull ghcr.io/biosimulators/biosimulators\ndocker run -it --rm ghcr.io/biosimulators/biosimulators\n```\n\nThis 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.\n\nThe Dockerfile for this image is available [here](https://github.com/biosimulators/Biosimulators/blob/dev/Dockerfile).\n\n## Tutorials\n\n### Command-line interface\nA tutorial for the command-line interface is available [here](https://docs.biosimulators.org/Biosimulators_utils/).\n\n### Python API\nInteractive tutorials for using BioSimulators-utils and Python APIs for simulation tools to execute simulations are available online from Binder [here](https://tutorial.biosimulators.org/). The Jupyter notebooks for these tutorials are also available [here](https://github.com/biosimulators/Biosimulators_tutorials).\n\n## API documentation\nAPI documentation is available [here](https://docs.biosimulators.org/Biosimulators_utils/).\n\n## License\nThis package is released under the [MIT license](LICENSE).\n\n## Development team\nThis package was developed by the [Karr Lab](https://www.karrlab.org) at the Icahn School of Medicine at Mount Sinai in New York and the [Center for Reproducible Biomedical Modeling](http://reproduciblebiomodels.org) with assistance from the contributors listed [here](CONTRIBUTORS.md).\n\n## Contributing to BioSimulators utils\nWe enthusiastically welcome contributions to BioSimulators utils! Please see the [guide to contributing](CONTRIBUTING.md) and the [developer's code of conduct](CODE_OF_CONDUCT.md).\n\n## Funding\nThis work was supported by National Institutes of Health award P41EB023912.\n\n## Questions and comments\nPlease contact the [BioSimulators Team](mailto:info@biosimulators.org) with any questions or comments.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "description",
"version": "0.2.3",
"project_urls": {
"Homepage": "https://github.com/biosimulators/Biosimulators_utils",
"Repository": "https://github.com/biosimulators/Biosimulators_utils"
},
"split_keywords": [
"systems",
" biology",
" modeling",
" simulation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "417d8f937bc34c8d35c9203271ae13223a0c49d7a4bf851ff063b15a31fd1555",
"md5": "34696f857cd626e61a4ad2c311a0ed1d",
"sha256": "d6e712f815d7f2535790d5e3917b3f687045a00301552f8fcdb8ca54b2caaf34"
},
"downloads": -1,
"filename": "biosimulators_utils-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "34696f857cd626e61a4ad2c311a0ed1d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 586483,
"upload_time": "2024-10-10T18:39:11",
"upload_time_iso_8601": "2024-10-10T18:39:11.626910Z",
"url": "https://files.pythonhosted.org/packages/41/7d/8f937bc34c8d35c9203271ae13223a0c49d7a4bf851ff063b15a31fd1555/biosimulators_utils-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3493b6a2733e24660ccdbd5c1a36ad943a5bc81c69ad56032f5879d80ee7682a",
"md5": "30060d1680d072aa74c74784b996542d",
"sha256": "11b809b03fcf3ca435b51d94099373c7e6f8588efe66166079b6e1f8e23fb8e0"
},
"downloads": -1,
"filename": "biosimulators_utils-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "30060d1680d072aa74c74784b996542d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 531631,
"upload_time": "2024-10-10T18:39:13",
"upload_time_iso_8601": "2024-10-10T18:39:13.729644Z",
"url": "https://files.pythonhosted.org/packages/34/93/b6a2733e24660ccdbd5c1a36ad943a5bc81c69ad56032f5879d80ee7682a/biosimulators_utils-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 18:39:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "biosimulators",
"github_project": "Biosimulators_utils",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "biosimulators-utils"
}
JSON
