A repository for differently flavoured WIlsON R-Shiny apps.
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docker Create entrypoint.sh Mar 18, 2019
images rtools install image added Nov 26, 2018
wilson-basic added cran mirror so the packages will be installed without the need … Mar 21, 2019
README.md Update README.md Nov 27, 2018

README.md

WIlsON: Webbased Interactive Omics visualizatioN - The Application

Abstract

This repository contains the reference application of the WIlsON R package. It is primarily intended to empower screening platforms to offer access to pre-calculated HT screen results to the non-computational scientist or enduser. Facilitated by an open file format, WIlsON supports all types of omics screens, serves results via a web-based dashboard, and enables end-users to perform analyses and generate publication-ready plots without any programming skills.

Availability

The WIlsON app can be applied either via a centralized R Shiny server, via applications such as Rstudio, or as a virtualized Docker container for offline usage (Please refer to that repository for a more detailed description).

WIlsON can be tested on our official demonstration server.

The underlying WIlsON R package can be downloaded here.

Please make sure to check our other projects at loosolab.

How to use it?

A detailed description of the WIlsON app can be found in the manual. For a quick start without further reading, a set of tutorial use cases are available.

Data import and our data format CLARION

CLARION: generiC fiLe formAt foR quantItative cOmparsions of high throughput screeNs

CLARION is a data format especially developed to be used with WIlsON, which relies on a tab-delimited table with a metadata header to describe the following columns. It is based on the Summarized Experiment format and supports all types of data which can be reduced to features and their annotation (e.g. genes, transcripts, proteins, probes) with assigned numerical values (e.g. count, score, log2foldchange, z-score, p-value). Most result tables derived from RNA-Seq, ChIP/ATAC-Seq, Proteomics, Microarrays, and many other analyses can thus be easily reformatted to become compatible without having to modify the code of WIlsON for each specific experiment.

Please check the following link for details considering the CLARION format.

Folder structure and data location

The R Shiny WIlsON application consists of the following components.

app.R		-> R code
/data		-> Folder with input file(s) (CLARION format)
/introduction	-> Introduction / Data Format web pages
/www		-> WIlsON logo

How do I load my own data?

Add the file suffix .clarion or .se, and place it/them into the /data folder. Then you reload the app or the R Shiny server. The new dataset can be selected from the apps drop down menue in the feature selection pane!

cp mydata.clarion /srv/shiny-server/sample-apps/data
sudo systemctl stop shiny-server
sudo systemctl daemon-reload
sudo systemctl start shiny-server

For an overview, see also here.

Installation of R Shiny server in “virgin” Debian 9 Linux

Update and install the following Debian packages.

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install r-base libnlopt-dev wget libssl-dev libxml2-dev libcurl4-openssl-dev git gdebi-core

Install R Shiny server according to the manual found here https://www.rstudio.com/products/shiny/download-server/ (make sure to install to global R library, NOT personal!).

Start R and install the WIlsON R package and dependencies (make sure to install to global R library, NOT personal!).

R
install.packages("devtools")
devtools::install_github(repo = "loosolab/wilson", host="github.molgen.mpg.de/api/v3", auth_token = NULL)

Download the WIlsON R application archive from https://github.molgen.mpg.de/loosolab/wilson-apps and unzip. Move wilson-basic folder into R Shiny server apps folder (e.g. /srv/shiny-server/sample-apps/wilson-basic).

Change the owner of the R Shiny apps folder to be the “shiny” user.

sudo chown –R shiny:shiny /srv/shiny-server/sample-apps 

Restart R Shiny server.

sudo systemctl stop shiny-server
sudo systemctl daemon-reload
sudo systemctl start shiny-server

Run app in RStudio

To run this app in your local RStudio you have to install the WIlsON R package and it's dependencies. (NOTE: in case you use MS based OS, Rtools is needed for downloading plots. Make sure to add Rtools to Systempath during installation.)

rtools install

install.packages("devtools")
devtools::install_github(repo = "loosolab/wilson", host="github.molgen.mpg.de/api/v3", auth_token = NULL)

Now either clone the repository and use runApp():

# Switch with setwd into the main folder e.g. wilson-apps.
setwd('yourPath'/wilson-apps)
# Use runApp to run the desired app. E.g. for wilson-basic
shiny::runApp("wilson-basic/")

Or use runUrl():

shiny::runUrl("https://github.molgen.mpg.de/loosolab/wilson-apps/archive/master.zip", subdir = "/wilson-basic")

How to cite

License

This project is licensed under the MIT license.