In this article, by Hernán G. Resnizky, author of the book Learning Shiny, the main objective will be to learn how to install all the needed components to build an application in R with Shiny. Additionally, some general ideas about what R is will be covered in order to be able to dive deeper into programming using R.
The following topics will be covered:
- A brief introduction to R, RStudio, and Shiny
- Installation of R and Shiny
- General tips and tricks
(For more resources related to this topic, see here.)
As stated on the R-project main website:
“R is a language and environment for statistical computing and graphics.”
R is a successor of S and is a GNU project. This means, briefly, that anyone can have access to its source codes and can modify or adapt it to their needs. Nowadays, it is gaining territory over classic commercial software, and it is, along with Python, the most used language for statistics and data science.
Regarding R’s main characteristics, the following can be considered:
- Object oriented: R is a language that is composed mainly of objects and functions.
- Can be easily contributed to: Similar to GNU projects, R is constantly being enriched by user’s contributions either by making their codes accessible via “packages” or libraries, or by editing/improving its source code. There are actually almost 7000 packages in the common R repository, Comprehensive R Archive Network (CRAN). Additionally, there are R repositories of public access, such as bioconductor project that contains packages for bioinformatics.
- Runtime execution: Unlike C or Java, R does not need compilation. This means that you can, for instance, write 2 + 2 in the console and it will return the value.
- Extensibility: The R functionalities can be extended through the installation of packages and libraries. Standard proven libraries can be found in CRAN repositories and are accessible directly from R by typing install.packages().
R can be installed in every operating system. It is highly recommended to download the program directly from http://cran.rstudio.com/ when working on Windows or Mac OS. On Ubuntu, R can be easily installed from the terminal as follows:
sudo apt-get update sudo apt-get install r-base sudo apt-get install r-base-dev
The installation of r-base-dev is highly recommended as it is a package that enables users to compile the R packages from source, that is, maintain the packages or install additional R packages directly from the R console using the install.packages() command.
To install R on other UNIX-based operating systems, visit the following links:
A quick guide to R
When working on Windows, R can be launched via its application. After the installation, it is available as any other program on Windows. When opening the program, a window like this will appear:
When working on Linux, you can access the R console directly by typing R on the command line:
In both the cases, R executes in runtime. This means that you can type in code, press Enter, and the result will be given immediately as follows:
> 2+2  4
The R application in any operating system does not provide an easy environment to develop code. For this reason, it is highly recommended (not only to write web applications in R with Shiny, but for any task you want to perform in R) to use an Integrated Development Environment (IDE).
As with other programming languages, there is a huge variety of IDEs available for R. IDEs are applications that make code development easier and clearer for the programmer. RStudio is one of the most important ones for R, and it is especially recommended to write web applications in R with Shiny because this contains features specially designed for R. Additionally, RStudio provides facilities to write C++, Latex, or HTML documents and also integrates them to the R code.
RStudio also provides version control, project management, and debugging features among many others.
RStudio for desktop computers can be downloaded from its official website at http://www.rstudio.com/products/rstudio/download/ where you can get versions of the software for Windows, MAC OS X, Ubuntu, Debian, and Fedora.
Quick guide to RStudio
Before installing and running RStudio, it is important to have R installed. As it is an IDE and not the programming language, it will not work at all. The following screenshot shows RStudio’s starting view:
At the first glance, the following four main windows are available:
- Text editor: This provides facilities to write the R scripts such as highlighting and a code completer (when hitting Tab, you can see the available options to complete the code written). It is also possible to include the R code in an HTML, Latex, or C++ piece of code.
- Environment and history: They are defined as follows:
- In the Environment section, you can see the active objects in each environment. By clicking on Global Environment (which is the environment shown by default), you can change the environment and see the active objects.
- In the History tab, the pieces of codes executed are stored line by line. You can select one or more lines and send them either to the editor or to the console. In addition, you can look up for a certain specific piece of code by typing it in the textbox in the top right part of this window.
- Console: This is an exact equivalent of R console, as described in Quick guide of R.
- Tabs: The different tabs are defined as follows:
- Files: This consists of a file browser with several additional features (renaming, deleting, and copying). Clicking on a file will open it in editor or the Environment tab depending on the type of the file. If it is a .rda or .RData file, it will open in both. If it is a text file, it will open in one of them.
- Plots: Whenever a plot is executed, it will be displayed in that tab.
- Packages: This shows a list of available and active packages. When the package is active, it will appear as clicked. Packages can also be installed interactively by clicking on Install Packages.
- Help: This is a window to seek and read active packages’ documentation.
- Viewer: This enables us to see the HTML-generated content within RStudio.
Along with numerous features, RStudio also provides keyboard shortcuts. A few of them are listed as follows:
Complete the code.
Run the selected piece of code. If no piece of code is selected, the active line is run.
Ctrl + Enter
⌘ + Enter
Comment the selected block of code.
Ctrl + Shift + C
⌘ + /
Create a section of code, which can be expanded or compressed by clicking on the arrow to the left. Additionally, it can be accessed by clicking on it in the bottom left menu.
Find and replace.
Ctrl + F
⌘ + F
The following screenshots show how a block of code can be collapsed by clicking on the arrow and how it can be accessed quickly by clicking on its name in the bottom-left part of the window:
Clicking on the circled arrow will collapse the Section 1 block, as follows:
The full list of shortcuts can be found at https://support.rstudio.com/hc/en-us/articles/200711853-Keyboard-Shortcuts.
For further information about other RStudio features, the full documentation is available at https://support.rstudio.com/hc/en-us/categories/200035113-Documentation.
Shiny is a package created by RStudio, which enables to easily interface R with a web browser. As stated in its official documentation, Shiny is a web application framework for R that makes it incredibly easy to build interactive web applications with R.
- It is free not only in terms of money, but as all GNU projects, in terms of freedom. As stated in the GNU main page: To understand the concept (GNU), you should think of free as in free speech, not as in free beer. Free software is a matter of the users’ freedom to run, copy, distribute, study, change, and improve the software.
- All the possibilities of a powerful language such as R is available. Thanks to its contributive essence, you can develop a web application that can display any R-generated output. This means that you can, for instance, run complex statistical models and return the output in a friendly way in the browser, obtain and integrate data from the various sources and formats (for instance, SQL, XML, JSON, and so on) the way you need, and subset, process, and dynamically aggregate the data the way you want. These options are not available (or are much more difficult to accomplish) under most of the commercial BI tools.
Installing and loading Shiny
As with any other package available in the CRAN repositories, the easiest way to install Shiny is by executing install.packages(“shiny”).
The following output should appear on the console:
Due to R’s extensibility, many of its packages use elements (mostly functions) from other packages. For this reason, these packages are loaded or installed when the package that is dependent on them is loaded or installed. This is called dependency. Shiny (on its 0.10.2.1 version) depends on Rcpp, httpuv, mime, htmltools, and R6.
An R session is started only with the minimal packages loaded. So if functions from other packages are used, they need to be loaded before using them. The corresponding command for this is as follows:
When installing a package, the package name must be quoted but when loading the package, it must be unquoted.
After these instructions, the reader should be able to install all the fundamental elements to create a web application with Shiny. Additionally, he or she must have acquired at least a general idea of what R and the R project is.
Resources for Article:
Further resources on this subject:
- R ─ Classification and Regression Trees[article]
- An overview of common machine learning tasks[article]
- Taking Control of Reactivity, Inputs, and Outputs [article]