inst/app/tools/help/about.md

In bioCancer: Interactive Multi-Omics Cancers Data Visualization and Analysis

bioCancer - Interactive Multi-Assay Cancer Genomics Data Visualisation

bioCancer is a platform-independent browser-based interface for Cancer Genomics Data analytics in R, based on the Shiny package.

bioCancer is a collaborative project. In part, it is inspired from radiant developed by Dr. Vincent Nijs.

Key features

• Explore: Quickly and easily summarize, visualize, and analyze your data
• Cross-platform: It runs in a browser on Windows, Mac, and Linux
• Reproducible: Recreate results and share work with others as a state file or an Rmarkdown report
• Context: Data and examples focus on Cancer genomics data

Explore

bioCancer is interactive. Results update immediately when inputs are changed (i.e., no separate dialog boxes). This greatly facilitates exploration and understanding of the data.

Cross-platform

bioCancer works on Windows, Mac, or Linux. It can run without an Internet connection and no data will leave your computer. You can also run the app as a web application on a server.

Note: For Windows users with data that contain multibyte characters please make sure your data are in ANSI format so R(adiant) can load characters correctly.

Reproducible

Simply saving output is not enough. You need the ability to recreate results for the same data and/or when new data become available. Moreover, others may want to review your analysis and results. Save and load the state of the application to continue your work at a later time or on another computer. Share state files with others and create reproducible reports using Rmarkdown. See also the section on Saving and loading state below

Programming

Although bioCancer's web-interface can handle quite a few data and analysis tasks, at times you may prefer to write your own code. bioCancer provides a bridge to programming in R(studio) by exporting the functions used for analysis. For more information about programming with bioCancer see the programming page on the documentation site.

Context

bioCancer focuses on Cancer Genomics data visualisation and Genes Classifications.

How to install bioCancer

• Required: R version 3.2 or later
• Required: A modern browser (e.g., Chrome or Safari). Internet Explorer (version 11 or higher) should work as well
• Recommended: Rstudio

To install the latest version for Windows of Mac with complete documentation for off-line access open R(studio) and copy-and-paste the command below:

bioCancer is under development:

 devtools::install_github("kmezhoud/bioCancer")
 library("bioCancer")

When bioCancer starts you will see a table of available Cancer Studies. To close the application click on Quit in the Navigation bar and then click the Quit button on the left of the screen. The bioCancer process will stop and the browser window will close (or gray-out).

Documentation

Documentation and tutorials are available in the bioCancer web interface (the ? icons and the Help menu).

Saving and loading state from bioCancer

To save your analyses save the state of the app to a file by clicking on the icon in the navbar and then on Save state (see also the Data > Manage tab). You can open this state file at a later time or on another computer to continue where you left off. You can also share the file with others that may want to replicate your analyses. As an example, load the state_file RadiantState.rda through the Data > Manage tab. Go to Data > View, Data > Visualize to see some of the settings. There is also a report in R > Report that was created using the bioCancer interface. The html file RadiantState.html contains the output.

Loading and saving state also works with Rstudio. If you start bioCancer from Rstudio and use > Stop to stop the app, lists called r_data and r_state will be put into Rstudio's global workspace. If you start bioCancer again using bioCancer() it will use these lists to restore state. This can be convenient if you want to make changes to a data file in Rstudio and load it back into Radiant. Also, if you load a state file directly into Rstudio it will be used when you start Radiant to recreate a previous state.

numericInput("sm_comp_value", "Comparison value:", state_init('sm_comp_value',sm_args$comp_value))

Acknowledgment

The Workspace panel of bioCancer is adapted from radiant.data. I would like to thank Dr. Vincent Nijs for sharing his work for R community.

License

bioCancer is licensed under the AGPLv3. The documentation and videos on this site and the bioCancer help files are licensed under the creative commons attribution, non-commercial, share-alike license CC-NC-SA.

As a summary, the AGPLv3 license requires, attribution, including copyright and license information in copies of the software, stating changes if the code is modified, and disclosure of all source code.

© Karim Mezhoud (2017)

bioCancer documentation built on Nov. 8, 2020, 6:26 p.m.