CoRegFlux

Pauline Trébulle, Daniel Trejo-Banos, Mohamed Elati

December 2018

This Vignette accompanies the CoRegFlux package. It can be used either to get some additional information about the methods or to get examples of the use of the functions. Feel free to ask any question to the package maintainer (coregflux at gmail dot com).

1 Installation

Install CoRegFlux:

if(!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")
BiocManager::install("CoRegFlux")

Load CoRegFlux:

library(CoRegFlux)

2 Introduction

The CoRegFlux package aims at providing tools to integrate reverse engineered gene regulatory networks and gene-expression into metabolic models to improve prediction of phenotypes, both for metabolic engineering, through transcription factor or gene (TF) knock-out or overexpression in various conditions as well as to improve our understanding of the interactions and cell inner-working. The following figure summarize the different functions available in the package to constraint the genome-scale metabolic model with gene expression for wild-type or mutants or to run a complete simulation using those constraints.

Summary of CoRegFlux functions and features

3 Data requirement

To use all CoRegFlux features you will need:

  1. A genome-scale metabolic model for your model organism as a modelOrg object (see sybilSBML for import) containing gene-association rules for reactions
  2. Condition-specific gene expression data / gene states for which the transcription factor influence, a statistical value estimating the TF activity in each sample, will be calculated
  3. A gene regulatory network (GRN) as a coregnet objet (see the CoRegNet package for more information about network inference)
  4. A large gene expression matrix to train the model

Examples data are provided with the package, including genome-scale metabolic model iMM904 for Saccharomyces Cerevisiae (SC), a gene regulatory network build for SC from the m3D database as described in Trejo Banos et al., “Integrating transcriptional activity in genome-scale models of metabolism”, BMC Systems Biology 2017, as well as a subset of the m3D dataset to train the model and provide gene expression data. To study others organims or another regulatory network, you will need to build a GRN using the CoRegNet package and/or choose relevant datasets.

4 User guide

4.1 Computing Influence using CoRegNet package function

Here are the main functionalities of CoRegFlux

4.2 Predict gene state/gene expression level from a condition specific experiment using a linear model

4.3 Simulations

For each simulation step, the function receives a metabolic model and performs:

The simulation result is a list containing:

The fluxes for the simulation time are stored in a matrix which row names are the fluxes reaction id.

To have access to the gprRules users can use the sybil package, which returns a vector of size equal to the number of fluxes and the associated genes.

If you only wish to know which gene affects which reaction; the sybil objects have a slot for obtaining the flux-gene matrix.

4.4 Constraining the model

When provided with different kind of constraints, CoRegFlux process the given information in the following order:

The different functions used by CoRegFlux to constraint the model are individually accessible to allow the combination of CoRegFlux’s models with other algorithms and parameters, provided by sybil for instance. A model can be constrain iteratively through the different function. In that case, the recommended order is as follows: uptake constraint, gene expression, TF KO or OV, gene KO or OV.

4.4.5 Constraining the model according to gene expression, TF KO or OV, gene KO or OV to run various FBA using sybil

The different functions used by CoRegFlux to constraint the model are individually accessible to allow the combination of CoRegFlux’s models with other algorithms and parameters, provided by sybil for instance. A model can be constrain iteratively through the different function. In that case, the recommended order is as follows: uptake constraint, gene expression, TF KO or OV, gene KO or OV.

4.5 From observations to fluxes

Here we will compute the fluxes from the observed growth rates (which can be obtained directly from the growth curves)

Assuming we have an observed growth rate of 0.3

Given that the fba solution is not unique, if you wish to see the intervals of maximum and minimum allowed fluxes for a reaction, flux variability analysis should be used

It worth noting that none of the two methods guarantee that the observed growth rate will be reached.

This could mean that the uptake rates for the limiting substrates (most commonly glucose uptake rate) does not allow for higher growth.

To constraint the model using the substrate uptake rate, the user must also provide the metabolites_rates argument

4.5.1 Adjusting the fluxes bounds based on observed growth rates, and visualized its effects on metabolic genes

During this step, you might get a message from R.cache to choose where the cached files should be saved. Since those files are only temporary files, you can create a dedicated folder in your working directory which you can remove afterward, or pick a location near the installation folder of the R.cache package.

4.6 Calibration: identifying the softplus parameter using bayesian optimization

To translate the gene expression to fluxes in the GEM, CoRegFlux use the softplus function

where \(\theta\) is the softplus parameter applied to all fluxes, \(gpr_{i}\left(X\right)\) is the result of evaluating the gene-protein-reaction rules for a set of gene expression levels of the metabolic genes \(X\). These rules relate genes to reactions and are logical form. CoRegflux transform these rules as follows

Given a known growth rate and predicted gene expressions obtained through the function predict_linear_model_influence, the users have the possibility to adjust the softplus parameter \(\theta\) to calibrate the integration of the gene expression in the GEM. This step requires the installation of the package rBayesianOptimization.

5 Session Info

sessionInfo()
# R version 3.6.0 (2019-04-26)
# Platform: x86_64-pc-linux-gnu (64-bit)
# Running under: Ubuntu 18.04.2 LTS
# 
# Matrix products: default
# BLAS:   /home/biocbuild/bbs-3.9-bioc/R/lib/libRblas.so
# LAPACK: /home/biocbuild/bbs-3.9-bioc/R/lib/libRlapack.so
# 
# locale:
#  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=C              
#  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
#  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
#  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
# [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
# 
# attached base packages:
# [1] stats     graphics  grDevices utils     datasets  methods   base     
# 
# other attached packages:
#  [1] ggplot2_3.1.1   glpkAPI_1.3.1   latex2exp_0.4.0 sybil_2.1.5    
#  [5] lattice_0.20-38 CoRegNet_1.22.0 arules_1.6-3    Matrix_1.2-17  
#  [9] shiny_1.3.2     igraph_1.2.4.1  CoRegFlux_1.0.0
# 
# loaded via a namespace (and not attached):
#  [1] Rcpp_1.0.1        pillar_1.3.1      compiler_3.6.0   
#  [4] later_0.8.0       plyr_1.8.4        R.methodsS3_1.7.1
#  [7] R.utils_2.8.0     tools_3.6.0       digest_0.6.18    
# [10] tibble_2.1.1      evaluate_0.13     gtable_0.3.0     
# [13] R.cache_0.13.0    rlang_0.3.4       pkgconfig_2.0.2  
# [16] yaml_2.2.0        parallel_3.6.0    xfun_0.6         
# [19] withr_2.1.2       dplyr_0.8.0.1     stringr_1.4.0    
# [22] knitr_1.22        tidyselect_0.2.5  grid_3.6.0       
# [25] glue_1.3.1        R6_2.4.0          rmarkdown_1.12   
# [28] purrr_0.3.2       magrittr_1.5      scales_1.0.0     
# [31] promises_1.0.1    htmltools_0.3.6   assertthat_0.2.1 
# [34] colorspace_1.4-1  mime_0.6          xtable_1.8-4     
# [37] httpuv_1.5.1      labeling_0.3      stringi_1.4.3    
# [40] lazyeval_0.2.2    munsell_0.5.0     crayon_1.3.4     
# [43] R.oo_1.22.0