liuxch5 / shinyBN

shinyBN: An online application for interactive Bayesian network inference and visualization

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Introduction


shinyBN is an R/Shiny application for interactive construction, inference and visualization of Bayesian Network, which provide friendly GUI for users lacking of programming skills. It's mainly based on five R packages: bnlearn for structure learning, parameter training, gRain for network inference, and visNetwork for network visualization, pROC and rmda for receiver operating characteristic (ROC) curve and decision curves analysis (DCA) , respectively, which was further wrapped by Shiny, a framework to build interactive web application straight by R.

Get Start


Run APP in R:

Install dependencies:

install.packages("devtools")
library(devtools)

# Packages on CRAN
install.packages(c("shiny","shinydashboard","shinydashboardPlus","sqldf","writexl","readxl","reshape2","DT","bnlearn","ggsci","shinyjqui","ggplot2","visNetwork","pROC","rmda","knitr"))

# Packages on Bioconductor
#  For R version 3.5 or greater, install Bioconductor packages using BiocManager; see https://bioconductor.org/install
if (!requireNamespace("BiocManager", quietly = TRUE)) install.packages("BiocManager")
BiocManager::install(c("gRain","igraph","AnnotationDbi","EBImage"))
# Others
source("http://bioconductor.org/biocLite.R")
biocLite(c("gRain","igraph","AnnotationDbi","EBImage"))


# Packages on Github
install_github(c("ramnathv/rblocks","woobe/rPlotter"))

Install shinyBN from Github:

devtools::install_github('JiajinChen/shinyBN')

Launch the APP in R:

shinyBN::run_shinyBN()

Lauch the APP through browser:

Please visit: https://jiajin.shinyapps.io/shinyBN/ or http://106.15.72.70:3838/shinyBN/

Main Page


How to use


Step 1: Input your Network!

Here, we provide Four type of data input:

  • R Object in R : If you trigger shinyBN in R, you can directly upload your Network exist in R environment(class bn or bn.fit).

  • R Object(.Rdata) : Upload your Network that save as rdata format(class bn or bn.fit).

  • Individual Data(.csv) : Upload individual data and perform structure learning, parameter training in shinyBN.

  • Structure in Excel : Upload a Excel with Network information (see Example).

Step 2: Render your Network!

Once your BN is inputed, the plot would present automatically with default parameters. If you are not satisfied with your graphic appearance, you can render your plot with corresponding settings. Additionally, network layout and legend can be set flexibly. Finally, shinyBN provides high-quality images download in HTML output and Network information in Excel.Because the network plot is based on canvas, it's difficult to get SVG. However, we provide a convenient way to get high-resolution images:

  • Step1 : Download the high pixel network in HTML format from shinyBN.

  • Step2 : Open the HTML file with your browser and adjust the network to the proper size followed by right click to save the image.

    • An Example:

    grab-landing-page

Step 3: Inference!

One of the major functions of Bayesian network is inference. You can query the probability of interested nodes given the values of a set of instantiated nodes. shinyBN allowed users to set multiple instantiated nodes and both marginal probability and joint probability are supported, the inference results will be displayed in bar plot or probabilistic table. Users can set different color representing different threshold to distinguish different levels of outcome probability. In addition, you can download the result through a PDF output interface for High-quality images.

  • An Example of single prediction:

grab-landing-page

shinyBN also allowed user to upload a validation set for batch inference. If your validation set contains outcome label, you can get the receiver operating characteristic (ROC) curve plot and decision curves analysis (DCA) plot. The same, both the plot in high-resolution images and batch prediction result in tables are supported.

  • An Example of batch prediction:

grab-landing-page

Publication

Chen, J., Zhang, R., Dong, X. et al. shinyBN: an online application for interactive Bayesian network inference and visualization. BMC Bioinformatics 20, 711 (2019) doi:10.1186/s12859-019-3309-0

Contact us

If you have any problem or other inquiries you can also email us at ywei@njmu.edu.cn .

About

shinyBN: An online application for interactive Bayesian network inference and visualization

License:Apache License 2.0


Languages

Language:R 100.0%