Chapter 4 Working in RStudio

Once you have created a Workspace, you can create an RStudio cloud environment. This will allow you to interface with data and perform genomics-based analyses with add on packages from the Bioconductor community.

4.1 Launch RStudio Cloud Environment

1. Click on the name of the Workspace you just created. You should be routed to a link that looks like: https://anvil.terra.bio/#workspaces/<billing-project>/<workspace-name>.

2. On the top right, Click the gear icon to access your Cloud Environment options.

   

3. You will see a list of costs because it costs a small amount of money to use cloud computing. Click “CUSTOMIZE”.

   

4. Click on the first drop down menu to see what other software configurations are available.

   

5. Scroll down and select RStudio from the Community-Maintained RStudio Environments section. NOTE: AnVIL is very versatile and can scale up to use very powerful cloud computers. It’s very important that you select the cloud computing environment described here to avoid runaway costs.

   

6. Leave everything else as-is. To create your RStudio Cloud Environment, click on the “CREATE” button.

   

7. Your Cloud Environment will be available in a few minutes after the cloud resources are provisioned and your software starts up. The upper right corner displays the status and should say “Creating” while resources are being provisioned.

   

8. After a few minutes, you will see the status change to “Running”.

   

9. Click on the “R” icon to launch RStudio.

   

10. You should now see the RStudio interface with information about the version printed to the console.

    

4.2 Tour RStudio

Next, we will be using RStudio and the package Glimma to create interactive plots. See this vignette for more information.

1. The Bioconductor team has created a very useful package to programmatically interact with Terra and Google Cloud. Install the AnVIL package. It will make some steps easier as we go along.

   BiocManager::install("AnVIL")

   

2. You can now quickly install precompiled binaries using the AnVIL package’s install() function. We will use it to install the Glimma package and the airway package. The airway package contains a SummarizedExperiment data class. This data describes an RNA-Seq experiment on four human airway smooth muscle cell lines treated with dexamethasone.

{Note: for some of the packages in this class, you will have to install packaged from the CRAN repository, using the install.packages() function. The examples will show you which install method to use.}

```r
AnVIL::install(c("Glimma", "airway"))
```

<img src="resources/images/02-rstudio_files/figure-html//1BLTCaogA04bbeSD1tR1Wt-mVceQA6FHXa8FmFzIARrg_g11f12bc99af_0_56.png" title="Screenshot of the RStudio environment interface. Code has been typed in the console and is highlighted." alt="Screenshot of the RStudio environment interface. Code has been typed in the console and is highlighted." width="480" />

1. Load the example data.

   library(airway)
   data(airway)

   

2. The multidimensional scaling (MDS) plot is frequently used to explore differences in samples. When this data is MDS transformed, the first two dimensions explain the greatest variance between samples, and the amount of variance decreases monotonically with increasing dimension. The following code will launch a new window where you can interact with the MDS plot.

   Glimma::glimmaMDS(assay(airway), group = colData(airway)$dex)

   

3. Change the colour_by setting to “groups” so you can easily distinguish between groups. In this data, the “group” is the treatment.

   

4. You can download the interactive html file by clicking on “Save As”.

   

5. You can also download plots and other files created directly in RStudio. To download the following plot, click on “Export” and save in your preferred format to the default directory. This saves the file in your cloud environment.

   limma::plotMDS(airway)

   

6. You should see the plot in the “Files” pane.

   

7. Select this file and click “More” > “Export”

   

8. Select “Download” to save the file to your local machine.

   

4.3 Pause RStudio

1. The upper right corner reminds you that you are accruing cloud computing costs.

   

2. You should minimize charges when you are not performing an analysis. You can do this by clicking on “Stop cloud environment”. This will release the CPU and memory resources for other people to use. Note that your work will be saved in the environment and continue to accrue a very small cost. Your instructor can delete these environments to stop costs accruing, so it’s a good idea to save code or output somewhere else, such as GitHub or your local machine.

   

4.4 Delete RStudio Cloud Environment

1. Stopping your cloud environment only pauses your work. When you are ready to delete the cloud environment, click on the gear icon in the upper right corner to “Update cloud environment”.

   

2. Click on “Delete Environment Options”.

   

3. If you are certain that you do not need the data and configuration on your disk, you should select “Delete everything, including persistent disk”.

   

4. Select “DELETE”.

   

4.5 Video Guide

In addition to the steps above, you can review this video guide on how to launch RStudio on AnVIL.

The slides for this tutorial are are located here.

sessionInfo()

## R version 4.0.2 (2020-06-22)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.5 LTS
## 
## Matrix products: default
## BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
## LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/liblapack.so.3
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
##  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
##  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## loaded via a namespace (and not attached):
##  [1] knitr_1.33      magrittr_2.0.3  hms_0.5.3       R6_2.4.1       
##  [5] rlang_1.1.0     fastmap_1.1.1   fansi_0.4.1     highr_0.8      
##  [9] httr_1.4.2      stringr_1.4.0   tools_4.0.2     xfun_0.26      
## [13] png_0.1-8       utf8_1.1.4      cli_3.6.1       jquerylib_0.1.4
## [17] htmltools_0.5.5 ottrpal_1.0.1   yaml_2.2.1      digest_0.6.25  
## [21] tibble_3.2.1    lifecycle_1.0.3 bookdown_0.24   readr_1.4.0    
## [25] sass_0.4.5      vctrs_0.6.1     fs_1.5.0        curl_4.3       
## [29] glue_1.4.2      cachem_1.0.7    evaluate_0.20   rmarkdown_2.10 
## [33] stringi_1.5.3   pillar_1.9.0    compiler_4.0.2  bslib_0.4.2    
## [37] jsonlite_1.7.1  pkgconfig_2.0.3

---

All illustrations CC-BY.
All other materials CC-BY unless noted otherwise.