-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME.Rmd
94 lines (62 loc) · 5.51 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
84
85
86
87
88
89
90
91
92
93
94
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set( # nolint: extraction_operator_linter.
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-", # nolint: nonportable_path_linter.
out.width = "100%"
)
```
# PAVER: Pathway Analysis Visualization with Embedding Representations
<!-- badges: start -->
[![Build Status](https://github.com/willgryan/PAVER/actions/workflows/rworkflows.yml/badge.svg)](https://github.com/willgryan/PAVER/actions/workflows/rworkflows.yml)
[![GitHub License](https://img.shields.io/github/license/willgryan/paver)](https://github.com/willgryan/PAVER/blob/main/LICENSE.md)
[![GitHub Release](https://img.shields.io/github/v/release/willgryan/paver)](https://github.com/willgryan/PAVER/releases/latest)
[![Software DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.8156248-blue?logo=github)](https://doi.org/10.5281/zenodo.8156248)
[![Publication DOI](https://img.shields.io/badge/DOI-10.6026%2F973206300200700-blue?logo=pubmed)](https://doi.org/10.6026/973206300200700)
![Code Coverage](https://img.shields.io/codecov/c/gh/willgryan/paver)
[![PDF Link](https://img.shields.io/badge/PDF-Download-blue?logo=adobeacrobatreader)](https://www.bioinformation.net/020/973206300200700.pdf)
[![Webpage Link](https://img.shields.io/badge/Link-Download-blue?logo=html5)](https://www.bioinformation.net/020/973206300200700.htm)
<!-- badges: end -->
PAVER allows for summary interpretation and visualization of pathway analyses.
## Usage
PAVER is designed to work with the output of pathway analysis tools. The package includes a vignette with an example dataset that explains it's functionality. The R Shiny application for the PAVER R package is hosted at [https://cdrl.shinyapps.io/PAVER/](https://cdrl.shinyapps.io/PAVER/). For more detailed information on PAVER and its functionalities, please read further below and also refer to the article on the Cognitive Disorders Research Laboratory (CDRL) website [here](https://cdrl-ut.org/project/projects_and_posters/paver/).
## Downloads
You may download the latest source release for PAVER [here](https://github.com/willgryan/PAVER/releases/latest). You may also download the latest release of the R Shiny app for the PAVER R package [here](https://github.com/willgryan/PAVER_shiny/releases/latest).
Pre-computed pathway embeddings for use with PAVER are available for download [here](https://github.com/willgryan/PAVER_embeddings).
## Installation
You can install the development version of PAVER from [GitHub](https://github.com/) with:
``` r
if (!requireNamespace("remotes", quietly = TRUE))
install.packages("remotes")
remotes::install_github("willgryan/PAVER")
```
## Example
PAVER offers different visualizations for exploring and interpreting pathway clusters.
The theme plot is a scatter plot showing all pathways in the dataset, colored by theme. The theme plot is useful for identifying pathways that are similar to each other, and for identifying pathways that are outliers. The theme plot can be generated using the `PAVER_theme_plot` function.
[![A UMAP plot showing clustering of themes](man/figures/README-theme_plot.jpg)](man/figures/README-theme_plot.jpg)
The heatmap plot shows the enrichment scores for each pathway in each cluster. The heatmap plot is useful for quantitatively identifying identifying differences in pathway regulation across different pathway analyses. The heatmap plot can be generated using the `PAVER_hunter_plot` function.
[![A heatmap showing the relative enrichment scores of pathways](man/figures/README-hunter_plot.jpg)](man/figures/README-hunter_plot.jpg)
## Authors
- **William G Ryan V** - E-mail: [[email protected]](mailto:[email protected])
- **Ali Sajid Imami** - E-mail: [[email protected]](mailto:[email protected])
- **Hunter Eby** - E-mail: [[email protected]](mailto:[email protected])
- **John Vergis** - E-mail: [[email protected]](mailto:[email protected])
- **Xiaolu Zhang** - E-mail: [[email protected]](mailto:[email protected])
- **Jarek Meller** - E-mail: [[email protected]](mailto:[email protected])
- **Rammohan Shukla** - E-mail: [[email protected]](mailto:[email protected])
- **Robert McCullumsmith** - E-mail: [[email protected]](mailto:[email protected])
## Acknowledgements
PAVER was supported by NIH NIGMS T32-G-RISE grant number 1T32GM144873-01, NIH NIMH grant number R01MH107487, NIH NIMH grant number R01MH121102, and NIH NIA grant number R01AG057598.
## Contact
For technical issues, please start a new issue on this [repository](https://github.com/willgryan/PAVER/issues). For technical questions, please contact [[email protected]](mailto:[email protected]).
For the corresponding author, please contact [[email protected]](mailto:[email protected]).
## Citation
If you use PAVER in your work, please cite the following article:
_[Interpreting and visualizing pathway analyses using embedding representations with PAVER](https://www.bioinformation.net/020/973206300200700.pdf)_\
_[Ryan et al. Bioinformation 20(7): 700-704 (2024)](https://www.bioinformation.net/020/973206300200700.pdf)_
## Contributing
We welcome anyone wishing to contribute, report issues or seek support for PAVER. Please note, PAVER is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By contributing to this project, you agree to abide by its terms.