{"id":37083742,"url":"https://github.com/r-costa/sbml2hyb","last_synced_at":"2026-01-14T10:13:35.460Z","repository":{"id":57792362,"uuid":"501372731","full_name":"r-costa/sbml2hyb","owner":"r-costa","description":"sbml2hyb is a tool for SBML compatible hybrid modelling of biological systems","archived":false,"fork":false,"pushed_at":"2024-10-11T22:13:27.000Z","size":33270,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-25T04:51:31.564Z","etag":null,"topics":["bioprocess","converter","gui","hybrid-model","interface","keras-tensorflow","neural-network","python","sbml-model","systems-biology"],"latest_commit_sha":null,"homepage":"https://doi.org/10.6084/m9.figshare.21803316.v1","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r-costa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-08T18:47:39.000Z","updated_at":"2024-10-11T22:13:30.000Z","dependencies_parsed_at":"2024-07-14T15:16:21.708Z","dependency_job_id":null,"html_url":"https://github.com/r-costa/sbml2hyb","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/r-costa/sbml2hyb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-costa%2Fsbml2hyb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-costa%2Fsbml2hyb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-costa%2Fsbml2hyb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-costa%2Fsbml2hyb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r-costa","download_url":"https://codeload.github.com/r-costa/sbml2hyb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-costa%2Fsbml2hyb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28416690,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioprocess","converter","gui","hybrid-model","interface","keras-tensorflow","neural-network","python","sbml-model","systems-biology"],"created_at":"2026-01-14T10:13:34.786Z","updated_at":"2026-01-14T10:13:35.453Z","avatar_url":"https://github.com/r-costa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SBML2HYB \u003cimg align=\"right\" src=\"https://github.com/rs-costa/sbml2hyb/blob/main/img/sbml2hyb_logo.png\" width=\"200\" /\u003e\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7293206.svg)](https://doi.org/10.5281/zenodo.7293206) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Documentation Status](https://readthedocs.org/projects/sbml2hyb/badge/?version=latest)](https://sbml2hyb.readthedocs.io/en/latest/?badge=latest) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![PyPI version](https://badge.fury.io/py/sbml2hyb.svg)](https://badge.fury.io/py/sbml2hyb)\n\n## Overview\nHybrid modelling combine parametric functions (derived from knowledge) and nonparametric functions (derived from data) in the same model structure.\nThe sbml2hyb tool is a stand-alone executable application for [SBML](https://synonym.caltech.edu/) compatible hybrid modelling. The tool is written in Python and is intended as an interface to convert existing SBML models into a hybrid model (combines mechanistic equations and machine learning techniques).\n\nThe new internal hybrid model format HMOD (intermediate format — enables communication between the essential components of the mechanistic and hybrid models) can be translated to SBML and vice-versa in sbml2hyb. See [HMOD](https://github.com/rs-costa/sbml2hyb/blob/main/models/chassagnole1standard.hmod) file example.\n\nSee our [publication](https://www.mdpi.com/2673-2688/4/1/14) that used sbml2hyb for Systems Biology applications.\n\n________________________________________________________________\n\n## Quick start guide\n### Installation\n- Users have two options to install sbml2hyb:\n\n(i) As a typical stand-alone executable Windows application; download the [files](https://figshare.com/ndownloader/files/38688132). After saving the Windows folder where you prefer on your computer, double-click the executable (`sbml2hyb_exe.exe`) file to open the tool. It works also on [macOS](https://figshare.com/ndownloader/files/38688432) system. \n\n(ii) As a Python package (pip installer); run the following command via `pip`:\n`pip install sbml2hyb`\n- sbml2hyb is written in Python (requires version 3.8 or higher).\n- Alternatively, you can clone this GitHub repository to a location on your computer's file system and then run `sbml2hyb.py` from the command-line.\n\nAfter installing the package the user can simply import the library and call it. This is an example on how to use:\n\n      from sbml2hyb import sbml2hyb\n\n### Package Dependencies\n- tkinter 3.10.7  \n- Pillow 9.0  \n- libsbml 5.19.6 \n- Python 3.8.2\n- Tensorflow 2.10.0\n\n### Getting Started\n#### ►  How to use SBML2HYB\n\nThe users can use sbml2hyb either via the command line interface or via a graphical user interface (GUI) that allows to convert SBML files into HMOD files and vice versa. \nOnce the simple Graphical User Interface (GUI) window opens, click the *\"Translate SBML file\"* or *\"Translate HMOD file\"* button, to find the SBML or HMOD mechanistic model file you want to convert on the tool, respectively. After few seconds, the user get the final output in the main panel of the GUI. Here, the user can save (click *\"Save file\"* button) the standard model file (.xml or .hmod). \n\nThe user can then add the information of the neural network component (Click *\"Add ML\"* button) into the HMOD/SBML model format (note that first the user needs to load a mechanistic HMOD/SBML model file). Once the user do this, they need select the *\"inputs\"* and *\"outputs\"* options of the neural network, and the Keras H5 file (i.e., add the ML component information). Click the *\"Confirm\"* button. Finally, the resulting hybrid model in HMOD (or SBML) format can then be reconverted in SBML (or HMOD), respectively. Click *\"Translate HMOD file\"* or *\"Translate SBML file\"* button. \n\nNOTE: To generate an Keras H5 file that serves as a blueprint of the machine learning segment of a hybrid model, the Keras library from Tensorflow should be used (see [instructions](https://github.com/r-costa/sbml2hyb/blob/main/createH5_instructions.txt) and an example as [notebook](https://github.com/rs-costa/sbml2hyb/blob/main/models/keras_H5/create_keras_h5.ipynb)).\n\nVisit also the documentation of the tool hosted on [Read the Docs](https://sbml2hyb.readthedocs.io/en/latest/index.html#).\n\n#### ►  Creating a hybrid SBML model\n\nExample: *Park\u0026Ramirez* model\n\nYou can view the mechanistic model SBML file input for this example in a [separate file](https://github.com/rs-costa/sbml2hyb/blob/main/models/parkramstandard.xml). The screenshot below (Figure 1) illustrates the output of the *Park\u0026Ramirez* [mechanistic HMOD model](https://github.com/r-costa/sbml2hyb/blob/main/models/parkramstandard.hmod) after the SBML conversion. The user select then the model *\"inputs\"* (*S*) and *\"outputs\"* (*miu*, *vPM*, *VPT*) options of the neural network, and the [Keras H5 file](https://github.com/r-costa/sbml2hyb/blob/main/models/Park_Keras.h5) (Figure 2) to convert directly to the hybrid model. You can view the resulting final hybrid HMOD file from the tool [here](https://github.com/rs-costa/sbml2hyb/blob/main/models/parkramhyb.hmod) and printscreens below (Figure 3). The hybrid model in HMOD format is then reconverted in the [hybrid SBML model](https://github.com/rs-costa/sbml2hyb/blob/main/models/parkramhyb.xml). \n\n\u003cdiv align=\"center\"\u003e Figure 1. \u003c/div\u003e\n\n![alt text](https://github.com/rs-costa/sbml2hyb/blob/main/img/Figure1.PNG)\n\n\u003cdiv align=\"center\"\u003e Figure 2. \u003c/div\u003e\n\n![alt text](https://github.com/rs-costa/sbml2hyb/blob/main/img/Figure2.PNG)\n\n\u003cdiv align=\"center\"\u003e Figure 3. \u003c/div\u003e\n\n![alt text](https://github.com/rs-costa/sbml2hyb/blob/main/img/Figure_3.png)\n\n## ☼ Citation\nPlease cite our paper if you use SBML2HYB in your research:\n\nJosé Pinto*, Rafael S. Costa*†, L. Alexandre, J. Ramos, Rui Oliveira, *SBML2HYB: a Python interface for SBML compatible hybrid modelling.*                  Bioinformatics (2023) | DOI: https://doi.org/10.1093/bioinformatics/btad044, PMID: 36661327\n\n## ⸎ Developed at\n- NOVA School of Science and Technology, Universidade NOVA de Lisboa\n\n*Authors:* [Rafael Costa](https://github.com/r-costa)\n\n![alt text](https://github.com/rs-costa/sbml2hyb/blob/main/img/logo_new.png)\n\n## ⁇ Help\nIf you have any trouble using the tool or suggestions, please contact:  rs [dot] costa [at] fct [dot] unl [dot] pt OR open an [issue](https://github.com/r-costa/sbml2hyb/issues).\n\n## License\nThis work is licensed under a \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0.html\"\u003e GNU Public License (version 3.0).\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-costa%2Fsbml2hyb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr-costa%2Fsbml2hyb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-costa%2Fsbml2hyb/lists"}