Skip to content

ijpb-bioinformatics/RFLOMICS

Repository files navigation

⚠️ THIS PROJECT HAS BEEN MOVED TO GITHUB: RFLOMICS ⚠️

RFLOMICS: R package and Shiny interface for Integrative analysis of omics data

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:

Use Rflomics

SK8 platform

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.

Locally

Install from archive

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")

Install from forgeMIA or github using remotes

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")

Install with git repository

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")

Troubleshooting MOFA2

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.

  1. 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.

  1. Install pip command (if not already done). For windows users, you can use this guide.
  2. Install mofapy 2: in a shell terminal, run pip install mofapy2.
  3. 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
  1. 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.

Run Rflomics

To run Rflomics, use the runRFLOMICS() function:

library(RFLOMICS)
runRFLOMICS()

For additional information: vignettes

Licence

Artistic-2.0

Contact and support

ijpb-bioinfo-team (ijpb-bioinfo-team@inrae.fr)

References

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages