0u812 / tellurium

Python Environment for Modeling and Simulating Biological Systems

  tellurium

Copyright 2014-2017 Kiri Choi, J Kyle Medley, Matthias König, Kaylene Stocking, Caroline Cannistra, Michal Galdzicki, and Herbert Sauro

Introduction

Tellurium is a python environment for reproducible dynamical modeling of biological networks. Tellurium provides the interfacial code to convert between standard formats and utilize powerful libraries without requiring technical expertise, allowing you to focus on what’s important: building better models. Tellurium also provides first-class support for exchangeability via COMBINE archives, allowing you to share your models and simulations with other tools.

Tellurium combines state-of-the-art scientific Python libraries, such as NumPy and SciPy, and includes special-purpose systems biology Python tools. Out of the box, Tellurium includes libroadrunner, antimony, phrasedml, libsbml, and libsedml.

The Tellurium project is funded from the NIH/NIGMS (GM081070).

Documentation

• General: http://tellurium.readthedocs.org/en/latest/
• API: http://tellurium.readthedocs.io/en/latest/_apidoc/tellurium.html
• Webpage: http://tellurium.analogmachine.org/

Usage Example

import tellurium as te

rr = te.loada('''
    model example0
      S1 -> S2; k1*S1
      S1 = 10
      S2 = 0
      k1 = 0.1
    end
''')

result = rr.simulate(0, 40, 500) 
te.plotArray(result)

Installation Instructions

Tellurium can either be installed with a front-end (Notebook, IDE) or as a Python package:

A. Notebook front-end
B. IDE front-end based on Spyder2
C. Python package (pip)

We recommend first-time users choose one of the front-ends, while developers looking to integrate Tellurium use the pip package. The IDE front-end provides a MATLAB like experience with a code editor and Python console. The notebook front-end provides a notebook interface similar to Jupyter, and features notebook cells for inline OMEX, a human-readable representation of COMBINE archives.

---

Front-end 1: Tellurium Notebook

The Tellurium notebook supports Windows 10, Mac OS X 10.10+, Debian 8+, and Fedora 22+. The notebook viewer comes with Python 3.6 (64-bit).

Windows

1. Download Tellurium Notebook for Windows
2. Double-click the installer *.exe to start the installation
3. Follow the instructions

Mac OS X

1. Download Tellurium Notebook for Mac OS X 10.10 or later
2. You may need to disable Gatekeeper
3. Double-click the *.dmg file to open a new window
4. Drag the Tellurium icon to your Applications
5. You can now launch Tellurium from Spotlight or directly from your applications folder

Linux (RedHat)

1. Download Tellurium Notebook (.rpm)
2. Install the package using dnf install Tellurium-2.0.8.rpm
3. You should be able to launch Tellurium from your activities pane. If not, log out and in again or run tellurium from the terminal.

Linux (Debian)

1. Download Tellurium Notebook (.deb)
2. Install the package using dpkg -i Tellurium_2.0.8_amd64.deb
3. You should be able to launch Tellurium from your activities pane. If not, log out and in again or run tellurium from the terminal.

---

Front-end 2: Tellurium Spyder IDE

The Spyder IDE installers are tested with Windows 7+ and Mac OS X 10.9+. Some older Macs cannot run Spyder, regardless of whether the operating system is up-to-date. The IDE comes with Python 2.7 (64-bit).

Windows

1. Download Tellurium IDE for Windows
2. Double-click the installer to start the installation
3. Follow the instructions

NOTE: Installation requires administrative rights. It is recommended to accept the default settings.

Mac OS X (Legacy)

Currently, only a legacy version of the Mac Spyder IDE is available. We recommend using the Notebook front-end on Mac.

1. Download Tellurium IDE for Mac OS X 10.10 or later
2. Double-click the .dmg file to open a new window
3. Double-click the Spyder icon

---

Install via pip (no front-end)

Binary pip packages for Tellurium are available from PyPi and support 64-bit Python versions 2.7, 3.5, and 3.6 for Windows, Mac, and Linux. Pip packages are tested on Fedora 22, Debian 8, Ubuntu 14.04, and Mac OS X 10.10.

The latest package release can be installed via

pip install tellurium

The latest stable version from the repository can be installed via

pip install git+https://github.com/sys-bio/tellurium.git

Legal

The source code for the Tellurium Python package is hosted at https://github.com/sys-bio/tellurium and is licensed under the Apache License, Version 2.0. Tellurium uses third-party dependencies which may be licensed under different terms. Consult the documentation for the respective third-party packages for more details.

TELLURIUM AND ALL SOFTWARE BUNDLED WITH TELLURIUM (HEREAFTER "THE SOFTWARE") IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.