A package that creates a python implementation of an SBML model.
SBMLtoODEpy is a software package that converts Systems Biology Markup Language (SBML) models into Python classes that can be rapidly incorporated into biomedical systems modeling projects written in Python, such as the multiscale simulation platform CompuCell3D, or used simulated directly as ordinary equations models in Python.
Steve M. Ruggiero and Ashlee N. Ford Versypt (firstname.lastname@example.org), School of Chemical Engineering, Oklahoma State University
The simplest use of this package is to use the ParseAndGenerate function to quickly create a python implementation of an SBML model.
import sbmltoodepy ParseAndCreateModel(inputFilePath, jsonFilePath = None, outputFilePath = None, className = "SBMLmodel")
The parameters are:
- inputFilePath: The file path of the SBML model.
- jsonFilePath: An optional file path that if provided is where the function will create a json file containing all of the model elements. If not provided, a json file will not be created.
- outputFilePath: An optional file path of where the python model implementation will be created. If not provided, the output path will be assumed to be the same as the input but with a .py extension.
- className: The name of the class defined by the file created by this function.
This creates a new python file containing a class implementing the SBML model.
To run the model, instantiate the class and call the RunSimulation method with the desired timestep deltaT and optional specification of tolerances.
model = SBMLmodel() model.RunSimulation(deltaT, absoluteTolerance = 1e-12, relativeTolerance = 1e-6)
SBMLtoODEpy requires either Python version 3.5, 3.6, or 3.7. SBMLtoODEpy can be downloaded using pip:
pip install sbmltoodepy
Alternatively, SBMLtoODEpy can be installed from its source code by running the setup.py file included.
python setup.py install
To test the package, use the TestPackage function.
import sbmltoodepy sbmltoodepy.utilities.TestPackage()
The TestPackage function raises a warning about trying to set a constant species and 6 numbers.
These are the average relative errors for species, parameters, and compartments between the model results generated using SBMLtoODEpy and results calculated by COPASI for six different models provided in the sbmltoodepy/sbml_files subdirectory: Smallbone2013, Borisov2009, Guyton1972, Kerkhoven2013, Waugh2006, and Zi2011, respectively. These examples are discussed in more detail in the tutorial.
Supporting Python packages
The following Python packages were used in this project and are needed to generate and run python models:
For more information on using this package, click here to see the tutorial.
For more information on SBML, including specifications and other software that supports SBML, click here for the SBML web site
For a good source of SBML models, the BioModels repository is a great place to search.
For this project's code documentation, click here.
For this project's github repository, click here.
The software package described here was made possible in part by funding through the award for project number HR17-057, from the Oklahoma Center for the Advancement of Science and Technology.
To contribute a change, users can contact Ashlee Ford Versypt by email email@example.com or submit a pull request.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size sbmltoodepy-1.0.4.tar.gz (78.5 kB)||File type Source||Python version None||Upload date||Hashes View hashes|