UCSCXenaShiny is an R package for interactively exploring UCSC Xena.
It is mainly designed to provide a web app (built on the top of {shiny}
framework and {UCSCXenaTools}
package) for downloading,
analyzing and visualizing datasets from UCSC
Xena.
Please cite the following article when you used UCSCXenaShiny in your study:
Wang, S.; Xiong, Y.; Gu, K.; Zhao, L.; Li, Y.; Zhao, F.; Li, X.; Liu, X. UCSCXenaShiny: An R Package for Exploring and Analyzing UCSC Xena Public Datasets in Web Browser. Preprints 2020, 2020070179 (doi: 10.20944/preprints202007.0179.v1).
If you don't want to install R and packages locally, or you have no programming experience, try using this tool on Hiplot platform: https://shiny.hiplot.com.cn/ucsc-xena-shiny/.
You can install stable release of UCSCXenaShiny from CRAN with:
install.packages("UCSCXenaShiny")
You can install the development version of UCSCXenaShiny from Github with:
remotes::install_github("openbiox/XenaShiny")
Or Gitee (for Chinese users):
remotes::install_git("https://gitee.com/XenaShiny/UCSCXenaShiny")
First load package:
library(UCSCXenaShiny)
Start Shiny in your R console (ignore this if you just want to use functions in this package):
app_run()
# At default, the Shiny is running under client mode
# It means the data queried from remote UCSC Xena server will
# be saved to temporary directory determined by R
# If you frequently use this tool or deploy this tool as a web service for multiple users
# It is recommended to run it with 'server' mode
# i.e.,
#
# app_run("server")
If you want deploy UCSC Xena Shiny with Shiny Server, please copy App.R
and www/
directory under shinyapp
.
xena.runMode
on the top of App.R
is recommended to set as "server"
instead of "client"
(default).
For advanced users, examples for illustrating useful functions to obtain and analyze data are described in vignette.
All exported data and functions are organized at here.
xena.cacheDir
and xena.zenodoDir
are two options to control where to store data.
e.g.,
options(xena.cacheDir = "/home/xxx/xena_data")
Option xena.runMode
can be used to control the way how the Shiny works.
It can be 'client' or 'server'. You can directly set it in app_run()
.
MIT © Openbiox