R¶

The R logo, from https://www.r-project.org/logo/

R is a programming language for statistical computing and data visualization (from Wikipedia).

Here we discuss:

the R programming language
the R interpreter
R packages
R software development
How to install personal packages

flowchart TD

    subgraph r[R]
      r_interpreter[the R interpreter]
      r_packages[R packages]
      r_language[the R programming language]
      r_dev[R software development]
      rstudio[RStudio]

      interpreted_language[Interpreted]
      cran[CRAN]
    end

    subgraph uppmax_modules[UPPMAX modules]
      r_module[R]
      r_packages_module[R_packages]
      rstudio_module[RStudio]
    end


    r_language --> |has| r_dev
    r_language --> |is| interpreted_language
    r_language --> |uses| r_packages
    interpreted_language --> |done by| r_interpreter
    r_packages --> |maintained by| cran
    r_dev --> |commonly done in| rstudio

    r_interpreter --> r_module
    r_packages --> r_packages_module
    rstudio --> rstudio_module

    rstudio_module --> |automatically loads latest| r_packages_module
    r_packages_module --> |automatically loads corresponding version of| r_module

the R programming language¶

R is 'a programming language for statistical computing and data visualization') and is of the most commonly used programming languages in data mining, analysis and visualization.

R is an interpreted language; users can access it through the R interpreter.

R is a dynamically typed programming language with basic built-in data structures are (among others): vectors, arrays, lists, and data frames. and its supports both procedural programming and object-oriented programming.

R has many user-created R packages to augment the functions of the R language, most commonly hosted on CRAN. These packages offer statistical techniques, graphical devices, import/export, reporting (RMarkdown, knitr, Sweave), etc.

the R interpreter¶

The R interpreter is the program that reads R code and runs it. Commonly, 'the programming language R' and 'the R interpreter' are use as synonyms.

To load the latest version of the R interpreter, do:

module load R/4.3.1

Do I really need to load an R module?

We strongly recommend loading an R module.

If you do not load an R module, you will be using the version of R used by the UPPMAX systems.

Sometimes that may work.

If not, load an R module.

Need a different version?

If you need a different R version, use the following command to see which versions of the R interpreter are installed on UPPMAX:

module spider R

Then start the R interpreter with:

R packages¶

R packages extend what R can do. The most common repository for R packages is CRAN. As these packages are so common, UPPMAX provides most of CRAN packages in one module, called R_packages

To load the latest version of the pre-installed R packages, do:

module load R_packages/4.3.1

This will automatically load the corresponding version of the R interpreter.

Do I really need to load the R_packages module?

We strongly recommend loading the R_packages module.

If you do not load the R_packages module (nor the R module), you will be using the version of R used by the UPPMAX systems.

Sometimes that may work.

If not, load the R_packages module.

Need a different version?

If you need a different package version, use the following command to see which versions of the R packages are installed on UPPMAX:

module spider R_packages

R software development¶

RStudio in action on Bianca using the remote desktop environment

RStudio in action on Bianca using the remote desktop environment

Software development is commonly done in a so-called Integrated Development Environment, abbreviated 'IDE.

RStudio is the most commonly used IDE for R software development. See the UPPMAX page about RStudio on how to use.

How to install personal packages¶

First load R_packages to make sure that the package is not already installed!

To install personal packages in your own home directory you type

install.packages("package_name")

as usual. That will install all your packages under the path ~/R/[arch]/[version of R]/. Then you can load it by just doing library(package_name) or require(package_name) in the R environment.

You can also specify a specific folder for where to put your packages, with

install.packages("package_name", lib="~/some/path/under/your/home/directory/")

But to then be able to find the package inside the R environment you need to either export the R_LIBS_USER environment variable, or specify the flag lib.loc when calling require/library, e.g.

library(package_name, lib.loc='~/some/path/under/your/home/directory')

Notice that if you are planning on running R on different clusters then it is probably wisest to manually specify the installation directory, and to have separate directories for each cluster. This is because some of the clusters have different architectures, and this will render some packages unusable if you compile them on one system but try to run them on the other.

Technicalities¶

As of this writing, our most recent installations are

R/4.3.1
R_packages/4.3.1
RStudio/2023.06.2-561

If you need an older version, do module avail R or R_packages or RStudio to see older versions as well.

Note that R_packages/4.3.1 contains 23475 packages, nearly all packages available on CRAN and BioConductor, as well as several custom packages installed from Github and other repositories. See module help R_packages/4.3.1 and R_packages for more information.

What R packages are in the omnibus `R_packages` modules?¶

R_PACKAGES/4.1.1¶

As of 2021-11-11 there are a total of 21659 R packages installed. A total of 21740 packages are available in CRAN and BioConductor. 18022 CRAN packages are installed, out of 18348 available. 3382 BioConductor-specific packages are installed, out of 3392 available. 255 other R packages are installed. These are not in CRAN/BioConductor, and instead are hosted on github or elsewhere.

These R packages are available as part of the R_packages/4.1.1 module as installed on rackham, bianca and snowy, which requires and loads the R/4.1.1 module. When the R_packages/4.1.1 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

To use some R packages from this module, other modules may need to be loaded. For example, to use the Rmpi package, the openmpi/3.1.5 module must be loaded after loading R_packages/4.0.4.
See module help R_packages/4.1.1 for more information.

R_PACKAGES/4.0.4¶

As of 2021-04-16 there are a total of 20663 CRAN and BioConductor packages installed, out of 20751 packages available. 17354 CRAN packages are installed, out of 17428 available. 3309 BioConductor-specific packages are installed, out of 3323 available.

These R packages are available as part of the R_packages/4.0.4 module as installed on rackham, bianca and snowy, which requires and loads the R/4.0.4 module. When the R_packages/4.0.4 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

To use some R packages from this module, other modules may need to be loaded. For example, to use the Rmpi package, the openmpi/3.1.5 module must be loaded after loading R_packages/4.0.4.
See module help R_packages/4.0.4 for more information.

R_PACKAGES/4.0.0¶

As of 2021-02-24 there are a total of 18652 CRAN and BioConductor packages installed, out of 20422 packages available. 14839 CRAN packages are installed, out of 17165 available. 3217 BioConductor-specific packages are installed, out of 3257 available.

These R packages are available as part of the R_packages/4.0.0 module as installed on rackham, bianca and snowy, which requires and loads the R/4.0.0 module. When the R_packages/4.0.0 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

See module help R_packages/4.0.0 for more information.

R_PACKAGES/3.6.1¶

As of 2019-09-18 there are a total of 17657 packages available in this module. This includes 14579 CRAN packages installed, out of 14913 available; and 3054 BioConductor-specific packages installed, out of 3079 available. These R packages are available as part of the R_packages/3.6.1 module as installed on rackham, bianca and snowy, which requires and loads the R/3.6.1 module. When the R_packages/3.6.1 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

See module help R_packages/3.6.1 for more information.

R_PACKAGES/3.6.0¶

As of 2019-05-14 there are a total of 17257 packages available. This includes 13769 CRAN packages installed, out of 14178 available; and 3031 BioConductor-specific packages installed, out of 3079 available. These R packages are available as part of the R_packages/3.6.0 module as installed on rackham, bianca and snowy, which requires and loads the R/3.6.0 module. When the R_packages/3.6.0 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

See module help R_packages/3.6.0 for more information.

R_PACKAGES/3.5.2¶

As of 2019-02-08 there are a total of 16642 packages available. This includes 13355 CRAN packages installed, out of 13683 available; and 2933 BioConductor-specific packages installed, out of 2959 available. These R packages are available as part of the R_packages/3.5.2 module as installed on rackham, bianca and snowy, which requires and loads the R/3.5.2 module. When the R_packages/3.5.2 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

See module help R_packages/3.5.2 for more information.

R_PACKAGES/3.5.0¶

With its 3.5.0 version, R_packages now attempts to install all available R packages from both CRAN and BioConductor.

As of 2018-06-26 there are a total of 14532 packages available. This includes 11734 CRAN packages installed, out of 12867 available; and 2798 BioConductor-specific packages installed, out of 2843 available. These R packages are available as part of the R_packages/3.5.0 module as installed on rackham, bianca and snowy, which requires and loads the R/3.5.0 module. When the R_packages/3.5.0 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

See module help R_packages/3.5.0 for more information.

R_packages/3.4.3¶

A large number of R packages are available as part of the R_packages/3.4.3 module as installed on rackham and bianca, which requires and loads the R/3.4.3 module. When the R_packages/3.4.3 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

R_packages/3.4.0¶

A large number of R packages are available as part of the R_packages/3.4.0 module, which requires and loads the R/3.4.0 module. When the R_packages/3.4.0 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

R_packages/3.3.2¶

A large number of R packages are available as part of the R_packages/3.3.2 module, which requires and loads the R/3.3.2 module. When the R_packages/3.3.2 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these packages will be available via library(package-name).

R_packages/3.3.1¶

A large number of R packages are available as part of the R_packages/3.3.1 module, which requires and loads the R/3.3.1 module. When the R_packages/3.3.1 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these should be available via library(package-name).

R_packages/3.3.0¶

A large number of R packages are available as part of the R_packages/3.3.0 module, which requires and loads the R/3.3.0 module. When the R_packages/3.3.0 module is loaded, it adds a directory to the R_LIBS_SITE environment variable. Within R, these should be available via library(package-name).

Learning R¶

Starter R courses¶

The Carpentries teaches basic lab skills for research computing, such as:

Experienced R courses¶

CodeRefinery develops and maintains training material on software best practices for researchers that already write code. Their material addresses all academic disciplines and tries to be as programming language-independent as possible:

CodeRefinery lessons

Aalto Scientific Computing:

Data analysis workflows with R and Python

R¶

the R programming language¶

the R interpreter¶

R packages¶

R software development¶

How to install personal packages¶

Technicalities¶

What R packages are in the omnibus `R_packages` modules?¶

R_PACKAGES/4.1.1¶

R_PACKAGES/4.0.4¶

R_PACKAGES/4.0.0¶

R_PACKAGES/3.6.1¶

R_PACKAGES/3.6.0¶

R_PACKAGES/3.5.2¶

R_PACKAGES/3.5.0¶

R_packages/3.4.3¶

R_packages/3.4.0¶

R_packages/3.3.2¶

R_packages/3.3.1¶

R_packages/3.3.0¶

Learning R¶

Starter R courses¶

Experienced R courses¶

Overview of NAISS centers and their documentation about R¶

Links¶

R¶

the R programming language¶

the R interpreter¶

R packages¶

R software development¶

How to install personal packages¶

Technicalities¶

What R packages are in the omnibus R_packages modules?¶

R_PACKAGES/4.1.1¶

R_PACKAGES/4.0.4¶

R_PACKAGES/4.0.0¶

R_PACKAGES/3.6.1¶

R_PACKAGES/3.6.0¶

R_PACKAGES/3.5.2¶

R_PACKAGES/3.5.0¶

R_packages/3.4.3¶

R_packages/3.4.0¶

R_packages/3.3.2¶

R_packages/3.3.1¶

R_packages/3.3.0¶

Learning R¶

Starter R courses¶

Experienced R courses¶

Overview of NAISS centers and their documentation about R¶

Links¶

What R packages are in the omnibus `R_packages` modules?¶