-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.Rmd
83 lines (52 loc) · 4.18 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# RAMEN <a href="https://github.com/ErickNavarroD/RAMEN"><img src="man/figures/logo.png" align="right" height="150"/></a>
<!-- badges: start -->
<!-- badges: end -->
## Overview
Regional Association of Methylome variability with the Exposome and geNome (RAMEN) is an R package whose goal is to identify Variable Methylated Regions (VMRs) in microarray DNA methylation data. Additionally, using Genotype (G) and Environmental (E) data, it can identify which G, E, G+E or GxE model better explains this variability.
## Installation
You can install the development version of RAMEN from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("ErickNavarroD/RAMEN")
```
## Core functions
RAMEN consists of six main functions:
- `findVMRs()` identifies Variable Methylated Regions (VMRs) in microarrays
- `summarizeVMRs()`summarizes the regional methylation state of each VMR
- `findCisSNPs()` identifies the SNPs in *cis* of each VMR
- `selectVariables()` conducts a LASSO-based variable selection strategy to identify potentially relevant *cis* SNPs and environmental variables
- `lmGE()` fits linear single-variable genetic (G) and environmental (E), and pairwise additive (G+E) and interaction (GxE) linear models and select the best explanatory model per VMR.
- `nullDistGE()` simulates a delta R squared null distribution of G and E effects on DNAme variability. Useful for filtering out poor-performing best explanatory models selected by *lmGE()*.
Altogether, these functions create a pipeline that takes a set of individuals with genotype, environmental exposure and DNA methylation information, and generates an estimation of the contribution of the genotype and environment to its DNA methylation variability. Functions that conduct computationally intensive tasks are compatible with parallel computing.
<img src="man/figures/RAMEN_pipeline.png" width="600"/>
## Usage
For a detailed tutorial on how to use RAMEN, please check the package's vignette or [website](https://ericknavarrod.github.io/RAMEN/articles/RAMEN.html).
## Variations to the standard workflow
Besides using RAMEN for completing the analysis mentioned above, the package provides individual functions that could help users in other tasks, such as:
- Reduction of tests prior to an EWAS or differential methylation analysis (i.e., conducting the analyses on identified VMRs to reduce redundant tests by grouping nearby correlated CpGs and to avoid tests in non-variant regions)
- Fit additive and interaction models given a set of variables of interest and select the best explanatory model for DNAme data.
- Quickly identify SNPs in *cis* of CpG probes for variable reduction during mQTL analyses.
- Get the median correlation of probes in regions of interest (with `medCorVMR()`).
## How to get help for RAMEN
If you have any question about RAMEN usage, please post an issue in this github repository so that future users also benefit from the discussion As an alternative option, you can contact Erick Navarro-Delgado at [erick.navarrodelgado\@bcchr.ca](mailto:[email protected]){.email}.
## Acknowledgments
I want to thank Dr. Keegan Korthauer and Dr. Michael S. Kobor for their supervision, feedback and support throughout the development of this package. Also, I want to thank the members of the Kobor and Korthauer lab for their comments and discussion.
The RAMEN package logo was created by Carlos Cortés-Quiñones and Dorothy Lin. Carlos created the drawing, and Dorothy refined the logo and did the lettering.
## Funding
This work was supported by the University of British Columbia, the BC Children's Hospital Research Institute and the Social Exposome Cluster.
## Citing RAMEN
The manuscript detailing RAMEN and its use is currently under preparation. For more information about this please contact Erick I. Navarro-Delgado at [erick.navarrodelgado\@bcchr.ca](mailto:[email protected]){.email}.
## Licence
GPL (\>= 3)