Using R#

R is available as a modules and it is also an interactive app on Open OnDemand (OOD). You can also use R with Anaconda.

See also

Our Conda page and official Anaconda documentation.

Using R on Open OnDemand#

The Open OnDemand application offers several different versions of R accessed through an interactive session with RStudio server in a Rocker Container. Each version of R is available as a different flavor whereby different packages are pre-installed. We host three flavors whose package-lists build on one another in the following order: RStudio < Tidyverse < Geospatial.

In addition to different R packages you will find additional package requirements (e.g, compilers) also present in the three flavors in increasing order.

Important

If you have tried to install a package in the RStudio or Tidyverse flavors and recieve an error message saying a necessary compiler is missing (e.g., glibc, CMAKE, zlib) or other “compilation failed” message. Please try to install the package again in the Geospatial flavor. If this still returns an error reach out to rchelp@northeastern.edu

Creating a Packrat Environment#

If you work with R packages, using a Packrat environment can be a helpful way to access packages across different sessions in the Open OnDemand app, between the Open OnDemand app and the command line, or between the different R flavors. Use the procedure below to create a Packrat environment on Discovery.

After you create a new directory for your R project, you can then use Packrat to store your package dependencies inside it.

We recommend making your Packrat directory in /work (preferred) or /home

  1. Connect to Discovery via ssh.

  2. Type module load R/4.2.1.

  3. Create a new directory for your R project by typing, mkdir /work/<groupname>/<username>/<directoryname> where <groupname> is your group name, <username> is your username, and <directoryname> is the name of the directory you want to create for your R project. For example, /work/coolsciencegroup/j.smith/packrat_r.

  4. Create a new directory for your R project by typing, mkdir <directoryname>

  5. Open the R interface and install Packrat:

   install.packages("packrat") # install in a local directory, as you cannot install as root

  1. Initialize the environment where R packages will be written to:

   packrat::init("/work/<groupname>/<yourusername>/<directoryname>")

You can then install R packages that you need. For example, to install a package called rtracklayer, type the following:

if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("rtracklayer")

When using RStudio in the OOD App:

The instructions below can be applied on any RStudio “flavor” available (i.e., RStudio, Geospatial, and Tidyverse). Once a Packrat snapshot is created it can easily be transferred between flavors and even machines (e.g., personal laptop, Discovery).

  1. Launch an RStudio instance on the OOD. Specify the flavor and other parameters as usual.

  2. In the RStudio console type: install.packages("packrat").

Note

This will install by default in $HOME/R/x86_64-pc-linux-gnu-library/<version>/ as long as you don’t have previous environments or those have been turned off (see below). For Packrat installation, it is best to specify a “project folder” in your $HOME, /scratch or /work directory (if you do not have /work please see Data Storage Options). The location /tmp/Rtmp8CbQCA/downloaded_packages would not work because /tmp corresponds to the compute node that you were on while running the R session. Optimally, you would like to have the Packrat location in a persistent place so that all packages and libraries are available to you at all times regardless of the compute node you are on.

  1. Create a Packrat project directory at the desired location by selecting “New Folder” in the “Files” tab in the lower right hand side of the RStudio screen. Alternatively, use mkdir in the terminal tab on the lower left-hand side of the RStudio screen. For example: mkdir projectfolder.

  2. In the RStudio console, initialize the Packrat. If your current directory is the project folder (i.e., getwd() == Packrat project folder) you can omit the path here.

packrat::init("<path-to-project-folder>")

  1. You can now record all the currently installed packages to your Packrat with the snapshot command. This may take some time if you have installed a lot of packages.

packrat::snapshot()

  1. And now you can check on the status of your Packrat with:

packrat::status()

  1. Now turn Packrat on. Packrat will now stay on for all your RStudio sessions and across the RStudio flavors (RStudio, geospatial, and tidyverse).

packrat::on()

  1. You can now install packages as normal. You should see the installation location for your Packrat project folder. For example: “Installing package into /work/groupname/username/packrat_R/”

install.packages("viridis")

Packrat Tips#

  • At any time you can check the status of your Packrat with packrat::status().

  • Packrat can be toggled on and off with packrat::on() and packrat::off(), respectively.

  • To disconnect Packrat and allow for package installation outside your packrat project folder: packrat::disable(project = NULL, restart = TRUE), where project refers to the current Packrat project folder, and restart = TRUE will restart the R session.

  • To re-initialize Packrat run: packrat::init("<path-to-packrat-project-folder>"). This will automatically restart your R session.

  • A package can be removed from Packrat via: remove.packages("viridis), but will remain in your Packrat snapshot and can be restored with: Packrat::restore().

  • The function packrat::clean(dry.run=T) will list any unused packages that were installed in your snapshot. You can remove them with: packrat::clean().

Note

For most cases, having a single Packrat directory is sufficient, unless you notice specific package conflicts or need different versions of the same package. A single Packrat directory also saves from having to install the same dependencies multiple times in different locations.

If the installation location is not setting to your project folder you may need to turn off these environments. In some cases, these folders could also be present in your /work/groupname/<project-name> directory.

mv ~/.rstudio ~/.rstudio-off
mv ~/.local ~/.local-off
mv ~/ondemand ~/ondemand.off
mv ~/.Rprofile ~/.Rprofile.off
mv ~/.Rhistory ~/.Rhistory.off