Repository files navigation

Authors:Roland Keller,Andreas Dräger,Hemil Panchiwala,Shalin Shah,Matthias König,Alexander Dörr,Richard Adams

Contributors to predecessor projects: Philip Stevens, Marcel Kronfeld, Sandra Saliger, Simon Schäfer, Dieudonné Motsou Wouamba, Hannes Borch, Nicolas Le Novère, Max Zwiessele

When using SBSCL in a research work, please cite the following works:

1. Panchiwala, H.; Shah, S.; Planatscher, H.; Zakharchuk, M.; König, M.; Dräger, A. The Systems Biology Simulation Core Library.Bioinformatics, btab669, September 23rd 2021, 2020120296.
2. Keller, R.; Dörr, A.; Tabira, A.; Funahashi, A.; Ziller, M.J.; Adams, R.; Rodriguez, N.; Le Novère, N.; Hiroi, N.; Planatscher, H.; Zell A.; Dräger; A. The systems biology simulation core algorithm. BMC Syst Biol 7, 55 (2013).

The Systems Biology Simulation Core Library (SBSCL) provides an efficient and exhaustive Java™ implementation of methods to interpret the content of models encoded in the Systems Biology Markup Language (SBML) and its numerical solution. This library is based on theJSBML project. It can be used on every operating system for which a Java Virtual Machine is available. Please note that this project does not contain any user interface neither a command-line interface, nor a graphical user interface. This project has been developed as a pure programming library. To support theMIASE effort, it understandsSED-ML files. Its abstract type and interface hierarchy facilitates the implementation of further community standards, such asCellML.

Bio-Informatics, Libraries, Simulations

• Numerical simulation
• Ordinary differential equation solver
• Time-course analysis
• Application programming interface
• Systems Biology Markup Language support along withfbc andcomp extensions
• Stochastic simulations support
• Simulation Experiment Description Markup Language (SED-ML) support

• Systems Biology Markup Language (L1V1 - L3V2)
• SBML models with FBC V1 and V2
• SBML models with comp extensions
• Simulation Experiment Description Markup Language (L1V3)
• COMBINE archive and OMEX format
• All models fromSBML Test Suite andBiGG models
• All models fromStochastic Test Suite

For an introduction on how to use this library for simulation, please refer to theUserGuidelines.md file. There you can find explanations on how to simulate different models and code snippets, including the links to the complete code examples.

To start working on SBSCL, you should first clone the repository and then refer toINSTALL.md which gives instruction to run maven build. Once a maven build is ran, the binaries will be generated in the target folder. This folder will also include a JAR files of the simulation core library to work with.

For an introduction on how things currently work in SBSCL to simulate different models, please refer to the sequence diagrams present in the/dev/diagrams/ where you can understand complete workflow of the library. Once you get familiarized with how things work, please open the javadochomepage where you can find the complete information about the library properly documented. For formatting the code-base, please refer toformatting-guidelines.

Import SBSCL into your project via Maven as follows:

<dependency>  <groupId>org.draegerlab</groupId>  <artifactId>sbscl</artifactId>  <version>2.1</version></dependency>

SeeReleases andMaven Central for the most recent version number.

ADemo Repository provides a few use case examples and an exemplaryPOM file that helps setting up the project.

Further examples can be found directly within this repository in theExamples Package, including:

• How torun models directly from BioModels database
• How torun hierarchically structured models that use the SBML extension package "comp"
• How tolisten to constraint violations
• How to run aflux balance analysis
• How to work with anOMEX archive file
• How to execute a simulation as instructed in aSED-ML file
• How to run adynamic simulation
• How to run astochastic simulation

To compare SBSCL to other simulation engines and to benchmark its predictions and results, a separate project,SBSCL simulator comparison, is available.

Just a brief explanation of the folders and files contained in this distribution.

Most importantly, see

• theINSTALL.md file for instruction to run maven build
• the docs folder containing an exhaustive documentation under apidocs

The package structure in more detail:

 / |- dev                 -> Contains the diagrams and fomatting-guidelines for the developers |- docs                -> Contains code for the maven built website |- modules             -> Contains the code for support of cellDesigner and cytoscape in FERN |- src                 -> The main source folder containing all the code and test files    |- assembly         -> assembly files for maven plugins    |- lib              -> 3rd party libraries needed for compilation and execution    |- main             -> Core java files of simulation library    |- test             -> JUnit test files along with resources required    |- site             -> Contains markup files, old javadoc, site.xml and other website                             resources  |- LICENSE.txt         -> the license, under which this project is distributed |- pom.xml             -> Maven file for building the project |- README.md           -> this file |- UserGuidelines.md   -> Contains the guidelines for using the features of library

Please e-mail any bugs, problems, suggestions, or issues regarding this library to the bug tracker athttps://github.com/draeger-lab/SBSCL/issues

This file is part of Simulation Core Library, a Java-based library for efficient numerical simulation of biological models.

Copyright (C) 2007 jointly held by the individual authors.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation. A copy of the license agreement is provided in the file namedLICENSE.txt included with this software distribution and also available online ashttp://www.gnu.org/licenses/lgpl-3.0-standalone.html.

Please cite the original work and the authors when using this program. See theproject homepage for details.