tlubitz / SBtab

SBtab - Table format for Systems Biology:
www.sbtab.net
MIT License
6 stars 8 forks source link

SBtab - Table format for Systems Biology

Python code and example files by Timo Lubitz, Elad Noor, Jens Hahn, Frank Bergmann (2018).

Data tables in the form of spreadsheets or delimited text files are the most utilised data format in Systems Biology. However, they are often not sufficiently structured and lack clear naming conventions that would be required for modelling. We propose the SBtab format as an attempt to establish an easy-to-use table format that is both flexible and clearly structured. It comprises defined table types for different kinds of data; syntax rules for usage of names, shortnames, and database identifiers used for annotation; and standardised formulae for reaction stoichiometries. Predefined table types can be used to define biochemical network models and the biochemical constants therein. The user can also define own table types, adjusting SBtab to other types of data.

The SBtab specification can be found on the SBtab homepage. The homepage also provides various information on example files, frequently asked questions, online tools, and tutorials.


SBtab comes along with software tools which can be employed in 3 different ways:

  1. In the online interface or as home server version
    ![SBtab online](https://github.com/tlubitz/SBtab/blob/master/documentation/sbtab_screen.png) You can use the software tools that come with SBtab in the convenient online interface on https://www.sbtab.net. The page is built with the Python web framework web2py. If you want to run the web2py application on your own home server, you can download it from this repository's directory SBtab/python/web_version. Change to this directory to find more information on the usage.
  2. ---
  3. As a Python3 package (pip installer)
    ![Pip Installer Logo](https://github.com/tlubitz/SBtab/blob/master/python/web_version/static/images/logo_pypi.png) The tools can be employed as a Python3 package. It needs to be installed via [pypi](https://pypi.org/project/sbtab/). Please type on your commandline

    > sudo pip3 install sbtab You will then be able to import the SBtab library into your Python3 modules by adding > import sbtab to them. See the code examples in this repository's directory SBtab/python. Also, you will find further information on the usage in the [SBtab specification](https://www.sbtab.net/sbtab/default/downloads.html#spec). **Please note that the directory SBtab/pypi_installer only holds the files for the pip installer build up and is not required at all for users that want to employ SBtab.**
  4. ---
  5. From the commandline (for experienced users)
    ![Python Logo](https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg) You can employ the SBtab commandline tools from the directory SBtab/python. To use this option, you will have to install the required packages on your own and put the Python modules to their according directory. Details on the usage of the commandline tools you can find in the directory SBtab/python.

The SBtab repository consists of the following directories and contents:

R
SBtab interface for the language R. See directory for details on the usage.

definition table:
Default definitions of predefined SBtab table types.

excel:
Windows installer and source code for the excel add-in (courtesy of Frank T. Bergmann). Works for SBtab version 1.0 and the .xls format.

sbtab examples:
Example SBtab files. These files can also be found including explanatory words in the online SBtab Download Section

python: