Skip to main content

A set of metabolic model analysis tools for PySCeS.

Project description

Documentation Status

PySCeSToolbox

This is a set of metabolic model analysis tools for PySCeS.

PySCeSToolbox currently provides tools for:

  • Generalised supply-demand analysis.

  • Symbolic metabolic control analysis and control pattern analysis.

  • Generating model schemas from metabolic models.

  • Distinguishing between thermodynamic and kinetic contributions towards reaction rate.

  • Interactive plotting

PySCeSToolbox was designed to be used within the Jupyter notebook, but most of the core features should work in a normal Python script.

Documentation can be found at http://pyscestoolbox.readthedocs.io. While all major tools have been documented, the documentation is still a work in progress. A PDF copy of the documentation is also included in the site-packages/psctb/docs subfolder of the Python prefix where PySCeSToolbox is installed.

Contents of README

Requirements

An abbreviated list of requirements is given below. Python dependencies will be installed automatically when installing PySCeSToolbox via pip. For detailed operating system specific instructions on installing the requirements see the documentation at http://pyscestoolbox.readthedocs.io/.

Notes:

Required packages should automatically download and install when using the commands specified under Installation below.

Maxima is only a requirement for SymCA.

Installation

Note: Detailed installation instructions are provided here.

The latest release of PySCeSToolbox can be installed from PyPi by running the following commands in the terminal (or Windows equivalent):

pip install pyscestoolbox

To enable widgets you may need to run the following commands:

jupyter nbextension enable --py --sys-prefix widgetsnbextension
jupyter nbextension install --py --user d3networkx_psctb
jupyter nbextension enable --py --user d3networkx_psctb

The latest development version can be installed from GitHub with:

pip install git+https://github.com/PySCeS/PySCeSToolbox.git

For the pre-2015-11-11 version:

pip install git+https://github.com/exe0cdc/ipython-d3networkx.git
pip install git+https://github.com/PySCeS/PySCeSToolbox.git@f63b5ab660f103105750159885608a5f48de1551

Basic usage

To start a PySCeSToolbox session in a Jupyter notebook:

  1. Start up the Jupyter Notebook using the jupyter notebook command in the terminal

  2. Create a new notebook by clicking the New button on the top right of the window and selecting Python 3

  3. Run the following three commands in the first cell:

import pysces
import psctb
%matplotlib inline

Model files must be placed in ~/Pysces/psc/ if using Linux or macOS, and in C:\Pysces\psc\ for Windows (PySCeS version < 0.9.8) or C:\Users\<username>\Pysces\psc (PySCeS version 0.9.8+).

Important notices

For readers of “Tracing regulatory routes in metabolism using generalised supply-demand analysis” published in BMC Systems Biology

To use the Jupyter notebook file included as “Additional file 5” in the paper, please install the latest version of PySCeSToolbox specified under Installation.

The two PySCeS MDL model files included as “Addition file 1” and “Addition file 2” are required to run the notebook. They should be renamed to “Hoefnagel_moiety_ratio.psc” and “Curien.psc”, respectively. Further instructions are included within the notebook and on this page.

Changes:

Because this project is undergoing development, future changes might break older scripts. These types of changes will be kept to a minimum and will be documented here.

Changes on 2017-02-09: Full cross compatibility

On 2017-02-09 Symca support via Maxima has been added to PySCeSToolbox on Windows. A configuration file located at C:\Pysces\psctb_config.ini can be used to specify the path to maxima.bat. By default, however, PySCeSToolbox should detect the path to maxima.bat automatically if it has been installed using the default options. This change should have no impact on any older scripts save for making them platform independent.

Changes on 2017-02-02: Dropped IPython Notebook 3.x.x support

As of 2017-02-02 IPython Notebook 3.x.x support has been dropped in favour of Jupyter 4.x.x. This should not affect the functioning of scripts (save for those based on versions before that of 2015-11-11). PySCeSToolbox will however require the Jupyter Notebook as of this date in order to use its interactive features. Note that ipywidgets (an automatically installed requirement for the Jupyter notebook) needs you to run the command “jupyter nbextension enable --py --sys-prefix widgetsnbextension” before enabling widgets in the notebook.

Changes on 2015-11-11: API changes

Major changes were made on 2015-11-11 that might break scripts coded before this date. These changes are related to the naming of methods and fields. For scripts older than 2015-11-11 we recommend using an older version of PySCeSToolbox (noted under Installation). Manual porting of scripts is also possible with details of necessary changes outlined under Porting scripts to latest version.

Porting scripts to latest version

Method and variable names and the analysis objects they belong to that were changed on 2015-11-11 are documented in the tables below. To port any older script simply change the old name of any method/variable to the new name.

RateChar

Old name

New Name

save

save_session

load

load_session

plot_data

scan_results

mca_data

mca_results

plot_decompose

do_mca_scan

Thermokin

Old name

New Name

reactions

reaction_results

mca_data

ec_results

reaction name*

J_reaction name

par_scan

do_par_scan

*reaction name refers to the naming of a reaction as it is defined in the model file.

Symca

Old name

New Name

CC

cc_results

CCn*

cc_results_n

save

save_session

load

load_session

par_scan

do_par_scan

*CCn refers to any of the additional result dictionaries that are created when an internal metabolite is fixed and the internal_fixed paramenter of do_symca is set to True

Data2D

Old name

New Name

plot_data

scan_results

save_data

save_results

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyscesToolbox-0.9.0.post1.tar.gz (929.1 kB view details)

Uploaded Source

Built Distribution

PyscesToolbox-0.9.0.post1-py3-none-any.whl (928.9 kB view details)

Uploaded Python 3

File details

Details for the file PyscesToolbox-0.9.0.post1.tar.gz.

File metadata

  • Download URL: PyscesToolbox-0.9.0.post1.tar.gz
  • Upload date:
  • Size: 929.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.9

File hashes

Hashes for PyscesToolbox-0.9.0.post1.tar.gz
Algorithm Hash digest
SHA256 0dc0e52b41753aa22c5e0a6c6db48143c4128fef978813af9dab884a4789887c
MD5 280871aa183b4fa170462822d8534211
BLAKE2b-256 ee22d69cdec898da6e836fac0222320f4c3e10d9221f40140392c390675245f1

See more details on using hashes here.

File details

Details for the file PyscesToolbox-0.9.0.post1-py3-none-any.whl.

File metadata

  • Download URL: PyscesToolbox-0.9.0.post1-py3-none-any.whl
  • Upload date:
  • Size: 928.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.9

File hashes

Hashes for PyscesToolbox-0.9.0.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 d350138fe0b237f92fe0e1888559db8f0c10f357f05f05bbd238a273d7f0f162
MD5 db792eba6a2158649b3b4bf483e3024c
BLAKE2b-256 9ef0ab74045514b6eae5badd7bb7da4dae929ce06dacbb9cabf9150516be06d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page