Learn R Programming

WIlsON: Webbased Interactive Omics visualizatioN - The R Package

Abstract

Objective

High-throughput (HT) studies of complex biological systems generate a massive amount of so called omics data. The results are typically summarized using spreadsheet like data formats. Visualization of this data is a key aspect of both, the analysis and the understanding of biological systems under investigation. While users have many visualization methods and tools to choose from, the challenge is to properly handle these tools and create clear, meaningful, and integrated visualizations based on pre-processed datasets.

Results

The WIlsON R package employs the R Shiny and Plotly web-based frameworks using a client-server based approach comprising a range of interface and plotting modules. These can be joined to allow a user to select a meaningful combination of parameters for the creation of various plot types (e.g. bar, box, line, scatter, heat). The modular setup of elements assures a concise code base and simplifies maintenance. An app thus created can be mounted on an R Shiny Server or inside R Studio. Data must be supplied server-side using a custom tab-delimited format derived from the SummarizedExperiment format (Clarion) and can principally originate from any analysis (e.g. RNA-Seq, ChIP-Seq, Mass Spectrometry, Microarray) that results in numeric data (e.g. count, score, log2foldchange, zscore, pvalue) attributed to a feature (e.g. gene, transcript, probe, protein).

Conclusions

The WIlsON R package includes a toolbox of R Shiny modules that can be used to construct a wide array of web-interfaces for plotting feature-based data.

Availability

All components of the WIlsON R package have been implemented in an integrated web application that is available for download from the Github repository wilson-apps and can be tested on our official demonstration server.

Usage instructions can be found in the extensive documentation.

Get a Docker container here.

Please make sure to check our other projects at loosolab.

Organization and Philosophy

Visualizations are organized hierarchically as Shiny modules, such that larger visualizations are built from small, general, and reusable components.

Installation

The module source code is made available as an R package and can be installed locally with

install.packages("BiocManager")
BiocManager::install("wilson")

On Windows, make sure that Rtools are available. Only versions < 2.3.1.

To enable interactive plot downloads install Orca.

CLARION input format

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.

How to cite

Schultheis H, Kuenne C, Preussner J, Wiegandt R, Fust A, Bentsen M, Looso M. WIlsON: Webbased Interactive Omics VisualizatioN. (2018), doi: https://doi.org/10.1093/bioinformatics/bty711

License

This project is licensed under the MIT license.

Copy Link

Version

Install

install.packages('wilson')

Monthly Downloads

258

Version

2.4.2

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Hendrik Schultheis

Last Published

April 19th, 2021

Functions in wilson (2.4.2)

equalize

Method to get equalized min/max values from vector
columnSelectorUI

columnSelector module UI representation
columnSelector

columnSelector module server logic
forceArgs

Force evaluation of the parent function's arguments.
andUI

AND module UI representation
install_app

Download and install Wilson Apps
divergingPalettes

Function to generate diverging (two-sided) color palettes (e.g. for log2fc, zscore)
download

and

AND module server logic
markerUI

marker module UI representation
marker

marker module server logic
categoricalPalettes

Function to generate categorical (qualitative) color palettes
global_cor_heatmapUI

global correlation heatmap module UI representation
global_cor_heatmap

global correlation heatmap module server logic
Clarion

Clarion R6-class definition
create_pca

Method for pca creation.
orNumeric

orNumeric module server logic
label

label module server logic
transformation

transformation module server logic
tobias_parser

TOBIAS TFBS table to clarion parser
heatmapGuide

heatmap module guide
limitUI

limit module UI representation
heatmapUI

heatmap module UI representation
log_message

logger message convenience function
create_scatterplot

Method for scatter plot creation
orNumericUI

orNumeric module UI representation
create_geneview

Method for geneView creation
featureSelector

featureSelector module server logic
create_heatmap

Method for heatmap creation
featureSelectorUI

featureSelector module UI representation
labelUI

label module UI representation
geneView

geneView's module server logic
geneViewGuide

geneView module guide
featureSelectorGuide

featureSelector module guide
limit

limit module server logic
global_cor_heatmap_guide

global correlation heatmap module guide
heatmap

heatmap module server logic
parse_MaxQuant

Converting MaxQuant Output file proteinGroups.txt to CLARION format by creating a headline of metadata for each column
geneViewUI

geneView's module UI representation
orTextualUI

orTextual module UI representation
scatterPlotGuide

scatterPlot module guide
scatterPlotUI

scatterPlot module UI representation
orTextual

orTextual module server logic
scatterPlot

scatterPlot module server logic
pcaUI

pca module UI representation
release_questions

Defines additional questions asked before CRAN submission. DO NOT EXPORT!
searchData

Function to search data for selection
transformationUI

transformation module UI representation
sequentialPalettes

Function to generate sequential (one-sided) color palettes (e.g. for expression, enrichment)
pca

pca module server logic
set_logger

set a log4r logger used within the package
parser

Method to parse input file.
pcaGuide

pca module guide
colorPicker

colorPicker module server logic
colorPickerUI

colorPicker module UI representation