R (programming language)

R

R terminal
Paradigms	Multi-paradigm: procedural, object-oriented, functional, reflective, imperative, array
Designed by	Ross Ihaka and Robert Gentleman
Developer	R Core Team
First appeared	August 1993 (1993-08)
Stable release	4.4.2  / 31 October 2024 (31 October 2024)
Typing discipline	Dynamic
Platform	arm64 and x86-64
License	GPL-2.0-or-later
Filename extensions	.r .rdata .rhistory .rds .rda
Website	www.r-project.org
Influenced by
Lisp S Scheme
Influenced
Julia pandas
R Programming at Wikibooks

R is a programming language for statistical computing and data visualization. It has been adopted in the fields of data mining, bioinformatics, and data analysis.

The core R language is augmented by a large number of extension packages, containing reusable code, documentation, and sample data.

R software is open-source and free software. It is licensed by the GNU Project and available under the GNU General Public License. It is written primarily in C, Fortran, and R itself. Precompiled executables are provided for various operating systems.

As an interpreted language, R has a native command line interface. Moreover, multiple third-party graphical user interfaces are available, such as RStudio—an integrated development environment—and Jupyter—a notebook interface.

History

Ross Ihaka, co-originator of R

Robert Gentleman, co-originator of R

R was started by professors Ross Ihaka and Robert Gentleman as a programming language to teach introductory statistics at the University of Auckland. The language was inspired by the S programming language, with most S programs able to run unaltered in R. The language was also inspired by Scheme's lexical scoping, allowing for local variables.

The name of the language, R, comes from being both an S language successor as well as the shared first letter of the authors, Ross and Robert. In August 1993, Ihaka and Gentleman posted a binary of R on StatLib — a data archive website. At the same time, they announced the posting on the s-news mailing list. On December 5, 1997, R became a GNU project when version 0.60 was released. On February 29, 2000, the first official 1.0 version was released.

Packages

Main article: R package

Violin plot created from the R visualization package ggplot2

R packages are collections of functions, documentation, and data that expand R. For example, packages add report features such as RMarkdown, Quarto, knitr and Sweave. Packages also add the capability to implement various statistical techniques such as linear, generalized linear and nonlinear modeling, classical statistical tests, spatial analysis, time-series analysis, and clustering. Easy package installation and use have contributed to the language's adoption in data science.

Base packages are immediately available when starting R and provide the necessary syntax and commands for programming, computing, graphics production, basic arithmetic, and statistical functionality.

The Comprehensive R Archive Network (CRAN) was founded in 1997 by Kurt Hornik and Friedrich Leisch to host R's source code, executable files, documentation, and user-created packages. Its name and scope mimic the Comprehensive TeX Archive Network and the Comprehensive Perl Archive Network. CRAN originally had three mirrors and 12 contributed packages. As of 16 October 2024, it has 99 mirrors and 21,513 contributed packages. Packages are also available on repositories R-Forge, Omegahat, and GitHub.

The Task Views on the CRAN web site list packages in fields such as finance, genetics, high-performance computing, machine learning, medical imaging, meta-analysis, social sciences, and spatial statistics.

The Bioconductor project provides packages for genomic data analysis, complementary DNA, microarray, and high-throughput sequencing methods.

The tidyverse package bundles several subsidiary packages that provide a common interface for tasks related to accessing and processing "tidy data", data contained in a two-dimensional table with a single row for each observation and a single column for each variable.

Installing a package occurs only once. For example, to install the tidyverse package:

> install.packages("tidyverse")

To load the functions, data, and documentation of a package, one executes the library() function. To load tidyverse:

> # Package name can be enclosed in quotes
> library("tidyverse")

> # But also the package name can be called without quotes
> library(tidyverse)

Interfaces

R comes installed with a command line console. Available for installation are various integrated development environments (IDE). IDEs for R include R.app (OSX/macOS only), Rattle GUI, R Commander, RKWard, RStudio, and Tinn-R.

General purpose IDEs that support R include Eclipse via the StatET plugin and Visual Studio via R Tools for Visual Studio.

Editors that support R include Emacs, Vim via the Nvim-R plugin, Kate, LyX via Sweave, WinEdt (website), and Jupyter (website).

Scripting languages that support R include Python (website), Perl (website), Ruby (source code), F# (website), and Julia (source code).

General purpose programming languages that support R include Java via the Rserve socket server, and .NET C# (website).

Statistical frameworks which use R in the background include Jamovi and JASP.

Community

The R Core Team was founded in 1997 to maintain the R source code. The R Foundation for Statistical Computing was founded in April 2003 to provide financial support. The R Consortium is a Linux Foundation project to develop R infrastructure.

The R Journal is an open access, academic journal which features short to medium-length articles on the use and development of R. It includes articles on packages, programming tips, CRAN news, and foundation news.

The R community hosts many conferences and in-person meetups. These groups include:

• UseR!: an annual international R user conference (website)
• Directions in Statistical Computing (DSC) (website)
• R-Ladies: an organization to promote gender diversity in the R community (website)
• SatRdays: R-focused conferences held on Saturdays (website)
• R Conference (website)
• posit::conf (formerly known as rstudio::conf) (website)

Implementations

The main R implementation is written primarily in C, Fortran, and R itself. Other implementations include:

• pretty quick R (pqR), by Radford M. Neal, attempts to improve memory management.
• Renjin is an implementation of R for the Java Virtual Machine.
• CXXR and Riposte are implementations of R written in C++.
• Oracle's FastR is an implementation of R, built on GraalVM.
• TIBCO Software, creator of S-PLUS, wrote TERR — an R implementation to integrate with Spotfire.

Microsoft R Open (MRO) was an R implementation. As of 30 June 2021, Microsoft started to phase out MRO in favor of the CRAN distribution.

Commercial support

Although R is an open-source project, some companies provide commercial support:

• Revolution Analytics provides commercial support for Revolution R.
• Oracle provides commercial support for the Big Data Appliance, which integrates R into its other products.
• IBM provides commercial support for in-Hadoop execution of R.

Examples

Hello, World!

"Hello, World!" program:

> print("Hello, World!")
[1] "Hello, World!"

Basic syntax

The following examples illustrate the basic syntax of the language and use of the command-line interface. (An expanded list of standard language features can be found in the R manual, "An Introduction to R".)

In R, the generally preferred assignment operator is an arrow made from two characters <-, although = can be used in some cases.

> x <- 1:6 # Create a numeric vector in the current environment
> y <- x^2 # Create vector based on the values in x.
> print(y) # Print the vector’s contents.
[1]  1  4  9 16 25 36

> z <- x + y # Create a new vector that is the sum of x and y
> z # Return the contents of z to the current environment.
[1]  2  6 12 20 30 42

> z_matrix <- matrix(z, nrow = 3) # Create a new matrix that turns the vector z into a 3x2 matrix object
> z_matrix 
     [,1] [,2]
[1,]    2   20
[2,]    6   30
[3,]   12   42

> 2 * t(z_matrix) - 2 # Transpose the matrix, multiply every element by 2, subtract 2 from each element in the matrix, and return the results to the terminal.
     [,1] [,2] [,3]
[1,]    2   10   22
[2,]   38   58   82

> new_df <- data.frame(t(z_matrix), row.names = c("A", "B")) # Create a new data.frame object that contains the data from a transposed z_matrix, with row names 'A' and 'B'
> names(new_df) <- c("X", "Y", "Z") # Set the column names of new_df as X, Y, and Z.
> print(new_df)  # Print the current results.
   X  Y  Z
A  2  6 12
B 20 30 42

> new_df$Z # Output the Z column
[1] 12 42

> new_df$Z == new_df['Z'] && new_df[3] == new_df$Z # The data.frame column Z can be accessed using $Z, ['Z'], or [3] syntax and the values are the same. 
[1] TRUE

> attributes(new_df) # Print attributes information about the new_df object
$names
[1] "X" "Y" "Z"

$row.names
[1] "A" "B"

$class
[1] "data.frame"

> attributes(new_df)$row.names <- c("one", "two") # Access and then change the row.names attribute; can also be done using rownames()
> new_df
     X  Y  Z
one  2  6 12
two 20 30 42

Structure of a function

One of R's strengths is the ease of creating new functions. Objects in the function body remain local to the function, and any data type may be returned. In R, almost all functions and all user-defined functions are closures.

Create a function:

# The input parameters are x and y.
# The function returns a linear combination of x and y.
f <- function(x, y) {
  z <- 3 * x + 4 * y

  # an explicit return() statement is optional, could be replaced with simply `z`
  return(z)
}

Usage output:

> f(1, 2)
[1] 11

> f(c(1, 2, 3), c(5, 3, 4))
[1] 23 18 25

> f(1:3, 4)
[1] 19 22 25

It is possible to define functions to be used as infix operators with the special syntax `%name%` where "name" is the function variable name:

> `%sumx2y2%` <- function(e1, e2) {e1 ^ 2 + e2 ^ 2}
> 1:3 %sumx2y2% -(1:3)
[1]  2  8 18

Since version 4.1.0 functions can be written in a short notation, which is useful for passing anonymous functions to higher-order functions:

> sapply(1:5, \(i) i^2)    # here \(i) is the same as function(i) 
[1]  1  4  9 16 25

Native pipe operator

In R version 4.1.0, a native pipe operator, |>, was introduced. This operator allows users to chain functions together one after another, instead of a nested function call.

> nrow(subset(mtcars, cyl == 4)) # Nested without the pipe character
[1] 11

> mtcars |> subset(cyl == 4) |> nrow() # Using the pipe character
[1] 11

Another alternative to nested functions, in contrast to using the pipe character, is using intermediate objects. However, some argue that using the pipe operator will produce code that is easier to read.

> mtcars_subset_rows <- subset(mtcars, cyl == 4)
> num_mtcars_subset <- nrow(mtcars_subset_rows)
> print(num_mtcars_subset)
[1] 11

Object-oriented programming

The R language has native support for object-oriented programming. There are two native frameworks, the so-called S3 and S4 systems. The former, being more informal, supports single dispatch on the first argument and objects are assigned to a class by just setting a "class" attribute in each object. The latter is a Common Lisp Object System (CLOS)-like system of formal classes (also derived from S) and generic methods that supports multiple dispatch and multiple inheritance

In the example, summary is a generic function that dispatches to different methods depending on whether its argument is a numeric vector or a "factor":

> data <- c("a", "b", "c", "a", NA)
> summary(data)
   Length     Class      Mode 
        5 character character 
> summary(as.factor(data))
   a    b    c NA's 
   2    1    1    1

Modeling and plotting

Diagnostic plots from plotting “model” (q.v. “plot.lm()” function). Notice the mathematical notation allowed in labels (lower left plot).

The R language has built-in support for data modeling and graphics. The following example shows how R can generate and plot a linear model with residuals.

# Create x and y values
x <- 1:6
y <- x^2

# Linear regression model y = A + B * x
model <- lm(y ~ x)

# Display an in-depth summary of the model
summary(model)

# Create a 2 by 2 layout for figures
par(mfrow = c(2, 2))

# Output diagnostic plots of the model
plot(model)

Output:

Residuals:
      1       2       3       4       5       6       7       8      9      10
 3.3333 -0.6667 -2.6667 -2.6667 -0.6667  3.3333

Coefficients:
            Estimate Std. Error t value Pr(>|t|)   
(Intercept)  -9.3333     2.8441  -3.282 0.030453 * 
x             7.0000     0.7303   9.585 0.000662 ***
---
Signif. codes:  0 ‘***’ 0.001 ‘**’ 0.01 ‘*’ 0.05 ‘.’ 0.1 ‘ ’ 1

Residual standard error: 3.055 on 4 degrees of freedom
Multiple R-squared:  0.9583, Adjusted R-squared:  0.9478
F-statistic: 91.88 on 1 and 4 DF,  p-value: 0.000662

Mandelbrot set

"Mandelbrot.gif" graphic created in R. (Note: Colors differ from actual output.)

This Mandelbrot set example highlights the use of complex numbers. It models the first 20 iterations of the equation z = z2 + c, where c represents different complex constants.

Install the package that provides the write.gif() function beforehand:

install.packages("caTools")

R Source code:

library(caTools)

jet.colors <-
    colorRampPalette(
        c("green", "pink", "#007FFF", "cyan", "#7FFF7F",
          "white", "#FF7F00", "red", "#7F0000"))

dx <- 1500 # define width
dy <- 1400 # define height

C  <-
    complex(
            real = rep(seq(-2.2, 1.0, length.out = dx), each = dy),
            imag = rep(seq(-1.2, 1.2, length.out = dy), times = dx)
            )

# reshape as matrix of complex numbers
C <- matrix(C, dy, dx)

# initialize output 3D array
X <- array(0, c(dy, dx, 20))

Z <- 0

# loop with 20 iterations
for (k in 1:20) {

  # the central difference equation
  Z <- Z^2 + C

  # capture the results
  X[, , k] <- exp(-abs(Z))
}

write.gif(
    X,
    "Mandelbrot.gif",
    col = jet.colors,
    delay = 100)

Version names

CD of R Version 1.0.0, autographed by the core team of R, photographed R in Quebec City in 2019

All R version releases from 2.14.0 onward have codenames that make reference to Peanuts comics and films.

In 2018, core R developer Peter Dalgaard presented a history of R releases since 1997. Some notable early releases before the named releases include:

• Version 1.0.0 released on February 29, 2000 (2000-02-29), a leap day
• Version 2.0.0 released on October 4, 2004 (2004-10-04), "which at least had a nice ring to it"

The idea of naming R version releases was inspired by the Debian and Ubuntu version naming system. Dalgaard also noted that another reason for the use of Peanuts references for R codenames is because, "everyone in statistics is a P-nut".

R release codenames

Version	Release date	Name	Peanuts reference	Reference
4.4.1	2024-06-14	Race for Your Life
4.4.0	2024-04-24	Puppy Cup
4.3.3	2024-02-29	Angel Food Cake
4.3.2	2023-10-31	Eye Holes
4.3.1	2023-06-16	Beagle Scouts
4.3.0	2023-04-21	Already Tomorrow
4.2.3	2023-03-15	Shortstop Beagle
4.2.2	2022-10-31	Innocent and Trusting
4.2.1	2022-06-23	Funny-Looking Kid
4.2.0	2022-04-22	Vigorous Calisthenics
4.1.3	2022-03-10	One Push-Up
4.1.2	2021-11-01	Bird Hippie
4.1.1	2021-08-10	Kick Things
4.1.0	2021-05-18	Camp Pontanezen
4.0.5	2021-03-31	Shake and Throw
4.0.4	2021-02-15	Lost Library Book
4.0.3	2020-10-10	Bunny-Wunnies Freak Out
4.0.2	2020-06-22	Taking Off Again
4.0.1	2020-06-06	See Things Now
4.0.0	2020-04-24	Arbor Day
3.6.3	2020-02-29	Holding the Windsock
3.6.2	2019-12-12	Dark and Stormy Night	See It was a dark and stormy night#Literature
3.6.1	2019-07-05	Action of the Toes
3.6.0	2019-04-26	Planting of a Tree
3.5.3	2019-03-11	Great Truth
3.5.2	2018-12-20	Eggshell Igloos
3.5.1	2018-07-02	Feather Spray
3.5.0	2018-04-23	Joy in Playing
3.4.4	2018-03-15	Someone to Lean On
3.4.3	2017-11-30	Kite-Eating Tree	See Kite-Eating Tree
3.4.2	2017-09-28	Short Summer	See It Was a Short Summer, Charlie Brown
3.4.1	2017-06-30	Single Candle
3.4.0	2017-04-21	You Stupid Darkness
3.3.3	2017-03-06	Another Canoe
3.3.2	2016-10-31	Sincere Pumpkin Patch
3.3.1	2016-06-21	Bug in Your Hair
3.3.0	2016-05-03	Supposedly Educational
3.2.5	2016-04-11	Very, Very Secure Dishes
3.2.4	2016-03-11	Very Secure Dishes
3.2.3	2015-12-10	Wooden Christmas-Tree	See A Charlie Brown Christmas
3.2.2	2015-08-14	Fire Safety
3.2.1	2015-06-18	World-Famous Astronaut
3.2.0	2015-04-16	Full of Ingredients
3.1.3	2015-03-09	Smooth Sidewalk
3.1.2	2014-10-31	Pumpkin Helmet	See You're a Good Sport, Charlie Brown
3.1.1	2014-07-10	Sock it to Me
3.1.0	2014-04-10	Spring Dance
3.0.3	2014-03-06	Warm Puppy
3.0.2	2013-09-25	Frisbee Sailing
3.0.1	2013-05-16	Good Sport
3.0.0	2013-04-03	Masked Marvel
2.15.3	2013-03-01	Security Blanket
2.15.2	2012-10-26	Trick or Treat
2.15.1	2012-06-22	Roasted Marshmallows
2.15.0	2012-03-30	Easter Beagle
2.14.2	2012-02-29	Gift-Getting Season	See It's the Easter Beagle, Charlie Brown
2.14.1	2011-12-22	December Snowflakes
2.14.0	2011-10-31	Great Pumpkin	See It's the Great Pumpkin, Charlie Brown
r-devel	N/A	Unsuffered Consequences

See also

• Comparison of numerical-analysis software
• Comparison of statistical packages
• List of numerical-analysis software
• List of statistical software
• Rmetrics

Further reading

• Wickham, Hadley; Çetinkaya-Rundel, Mine; Grolemund, Garrett (2023). R for data science: import, tidy, transform, visualize, and model data (2nd ed.). Beijing Boston Farnham Sebastopol Tokyo: O'Reilly. ISBN 978-1-4920-9740-2.
• Gagolewski, Marek (2024). Deep R Programming. doi:10.5281/ZENODO.7490464. ISBN 978-0-6455719-2-9.

External links

• R Technical Papers
• Big Book of R, curated list of R-related programming books
• Books Related to R - R Project, partially annotated curated list of books relating to R or S.