The acquisition of multi-omics data in the context of complex experimental design is a widely used practice to identify features (transcripts, proteins, metabolites,...) and decipher the biological processes they are involved in. The investigation of each omics layer is a good first step to explore and extract relevant biological variability. The statistical integration could then be restrained to pertinent omics levels and features. Such analysis of heterogeneous data remains a technical challenge with the needs of expertise methods and parameters to take into account data specificity. Furthermore, applying different statistical methods from several tools is also a technical challenge in term of data management. In this context, we developed RFLOMICS.
RFLOMICS is an R package and Shiny interface that offers guided, comprehensive, and reproducible analysis within a framework designed to manage multiple omics datasets. The interface provides remarkable flexibility, enabling users to seamlessly navigate between result exploration and visualization.
Specifications:
- Performs complete multi-omics project analysis,
- Support multi-factorial experimental design (up to 3 biological factors),
- Guarantees the relevance of the used methods,
- Reduces the analysis time on the unavoidable steps,
- Ensure the reproducibility of omics analysis,
- Accessible via one and simple user-friendly interface
Constraints:
- 3 types of omics data : RNAseq (read count), metabolomics (abundance) and proteomics (abundance)
- less than 10 datasets per omics type.
- 1 to 3 biological factors
- 1 to 2 batch factors and at least 3 replicates per condition
- Complete (mandatory) and balanced (recommended) design
Repositories:
You can access the rflomics app on Sk8 using this url:
https://rflomics.sk8.inrae.fr/
WARNING: only 2Gb of ram available per app, we recommand using the SK8 solution only if your data have a small number of samples and features.
Download the archive from forgeMIA (tar.gz) or from the github mirror (zip)
You can then install the package from the archive using either the install utility from Rstudio or running the following command:
install.packages("rflomics-master.tar.gz", repos = NULL, type = "source")
In a R console, use the following command to install from either the forgeMIA repository or the github repository:
remotes::install_gitlab(repo = "flomics/rflomics", host = "https://forgemia.inra.fr/")
remotes::install_github("https://github.com/ijpb-bioinformatics/RFLOMICS")
You can clone the repository from forgeMIA using the following command in a shell terminal:
git clone https://forgemia.inra.fr/flomics/rflomics.git
In a R console, set the working directory to the git repository, then install the package:
setwd("rflomics/")
remotes::install_local(upgrade="never")
Rflomics uses the R package MOFA2. This package depends on a python script and this can lead to several issues. The first step is to consult the MOFA2 troubleshooting FAQ on their website.
If none of the proposed solutions are resolving your issues, you can try some additional steps and verifications.
- Install Python or make sure you have it installed.
You can check you have python installed by running which python
in a shell terminal.
On windows, replace with where python
. You should be able to see the path(s) were
Python binaries are installed. You can have multiple python version installed at once.
You have to make sure the one used by R is this correct one.
- Install pip command (if not already done). For windows users, you can use this guide.
- Install mofapy 2: in a shell terminal, run
pip install mofapy2
. - Set the value of the RETICULATE_PYTHON environment variable to a Python binary and restart your session:
- either manually indicate it in your .Rprofile (hidden file)
- or use the following command in a terminal, in the .Rprofile folder:
echo "Sys.setenv(RETICULATE_PYTHON = \"path_to_python_bin\")" >> .Rprofile
- Install MOFA2 using
BiocManager::install("MOFA2")
in R.
You can check your configuration using reticulate::py_config()
in R.
Your Python binary path and mofapy2 path should appear after step 5.
If it's not the case, something went wrong.
To run Rflomics, use the runRFLOMICS() function:
library(RFLOMICS)
runRFLOMICS()
For additional information: vignettes
Artistic-2.0