Skip to main content

A small package to convert ODEs specified in a YAML file to SBML/PEtab

Project description

yaml2sbml logo

CI codecov Documentation Status Codacy Badge PyPI DOI

Table of contents


yaml2sbml is a small package in Python to convert an ODE model specified in a YAML file into SBML for ODE simulation and into PEtab for parameter fitting. yaml2sbml offers:

  • a translator of ODE models specified in YAML into SBML/PEtab via a Python and a command-line interface;
  • a format validator for the input YAML; and
  • a model editor, which provides a simplified interface to generate, import and export YAML models.


yaml2sbml can be installed from PyPI with

pip install yaml2sbml

For more info see the docs.

Getting Started

Basic Syntax


A YAML model can be translated to SBML/PEtab in Python via

import yaml2sbml

# SBML conversion
yaml2sbml.yaml2sbml(yaml_dir, sbml_dir)

#PEtab conversion

Command-Line Interface

and in the command-line via

# SBML conversion
yaml2sbml <yaml_dir> <sbml_dir>

#PEtab conversion
yaml2petab <yaml_dir> <output_dir> <sbml_name>

Format Validation

Format validation is possible in Python via yaml2sbml.validate_yaml and in the command-line via yaml2sbml_validate.

How to cite

yaml2sbml is published in the Journal of Open Source Software.

When using yaml2sbml in your project, please cite

  • Vanhoefer J., Matos, M. R. A., Pathirana, D., Schälte, Y. and Hasenauer, J. (2021). yaml2sbml: Human-readable and -writable specification of ODE models and their conversion to SBML. Journal of Open Source Software, 6(61), 3215,
  doi = {10.21105/joss.03215},
  url = {},
  year = {2021},
  publisher = {The Open Journal},
  volume = {6},
  number = {61},
  pages = {3215},
  author = {Jakob Vanhoefer and Marta R. A. Matos and Dilan Pathirana and Yannik Schälte and Jan Hasenauer},
  title = {yaml2sbml: Human-readable and -writable specification of ODE models and their conversion to SBML},
  journal = {Journal of Open Source Software}


If you have a question regarding the tool: Please drop us an issue or a mail, we are happy to help.

Project details

Download files

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

Source Distribution

yaml2sbml-0.2.5.tar.gz (22.8 kB view hashes)

Uploaded source

Built Distribution

yaml2sbml-0.2.5-py3-none-any.whl (24.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page