xia-lab / miRNetR

GNU General Public License v3.0
8 stars 4 forks source link

miRNetR: A companion R package for the miRNet web server

Note - miRNetR is still under development - we cannot guarantee full functionality

Description

miRNetR contains the R functions and libraries underlying the popular miRNet web server. After installing and loading the package, users will be able to reproduce the same results from their local computers using the corresponding R command history downloaded from miRNet, thereby achieving maximum flexibility and reproducibility.

Getting Started

Step 1. Install package dependencies

To use miRNetR , first install all package dependencies. Ensure that you are able to download packages from bioconductor. To install package dependencies, use the pacman R package (for those with >R 3.5.1). Note that some of these packages may require additional library dependencies that need to be installed prior to their own successful installation.

install.packages("pacman")

library(pacman)

pacman::p_load(RSQLite, Cairo, fastmatch, igraph, RJSONIO, foreach, doParallel, preprocessCore, limma, edgeR, HTqPCR, genefilter, prettydoc)

Step 2. Install the package

miRNetR is freely available from GitHub. The package documentation, including the vignettes for each module and user manual is available within the downloaded R package file. If all package dependencies were installed, you will be able to install the miRNetR. Due to issues with Latex, some users may find that they are only able to install miRNetR without any documentation (i.e. vignettes).

Install the package directly from github using the devtools package. Open R and enter:

# Step 1: Install devtools
install.packages("devtools")
library(devtools)

# Step 2: Install miRNetR WITHOUT documentation
devtools::install_github("xia-lab/miRNetR", build = TRUE, build_opts = c("--no-resave-data", "--no-manual", "--no-build-vignettes"), force = TRUE)

# Step 2: Install miRNetR WITH documentation
devtools::install_github("xia-lab/miRNetR", build = TRUE, build_opts = c("--no-resave-data", "--no-manual"), build_vignettes = TRUE, force = TRUE)

Tutorials

For detailed tutorials on how to use miRNetR, please refer to the R package vignettes. Note, the functions below work only if the R package vignettes were built.

Within R:

vignette(package="miRNetR")

Within a web-browser:

browseVignettes("miRNetR")

Citation

miRNetR has been developed by the XiaLab at McGill University. The original manuscript (web-based version) can be found here.

We encourage users to further develop the package to suit their needs. If you use the R package, please cite us:

Chang, L., Zhou, G., Soufan, O. and Xia, J. (2020) miRNet 2.0 - network-based visual analytics for miRNA functional analysis and systems biology. Nucl. Acids Res. (doi: 10.1093/nar/gkaa467)

Chang, L., & Xia, J. (2023). MicroRNA Regulatory Network Analysis Using miRNet 2.0. Methods in molecular biology (Clifton, N.J.), 2594, 185–204. https://doi.org/10.1007/978-1-0716-2815-7_14

Fan Y, Siklenka, K., Arora, SK., Ribeiro, P., Kimmins, S. and Xia, J. (2016) miRNet - dissecting miRNA-target interactions and functional associations through network-based visual analysis. Nucl. Acids Res. 44 W135–141

Bugs or feature requests

To inform us of any bugs or requests, please open a new issue or post on OmicsForum