R apply Functions -- Perschon

Home
»
R
»

R apply Functions

apply() function applies a function to margins of an array or matrix. Similar functions include lapply(), sapply(), mapply() and tapply(). These functions are more efficient than loops when handling data in batch.

apply(x,margin,func, ...)

• x: array
• margin: subscripts, for matrix, 1 for row, 2 for column
• func: the function
...

>BOD #R built-in dataset, Biochemical Oxygen Demand

Time demand
1 1 8.3
2 2 10.3
3 3 19.0
4 4 16.0
5 5 15.6
6 7 19.8

Sum up for each row:

> apply(BOD,1,sum)

[1] 9.3 12.3 22.0 20.0 20.6 26.8

Sum up for each column:

> apply(BOD,2,sum)

Time demand
22 89

Multipy all values by 10:

> apply(BOD,1:2,function(x) 10 * x)

Time demand
[1,] 10 83
[2,] 20 103
[3,] 30 190
[4,] 40 160
[5,] 50 156
[6,] 70 198

Used for array, margin set to 1:

> x <- array(1:9)
> apply(x,1,function(x) x * 10)

[1] 10 20 30 40 50 60 70 80 90

Two dimension array, margin can be 1 or 2:

> x <- array(1:9,c(3,3))
> x

[,1] [,2] [,3]
[1,] 1 4 7
[2,] 2 5 8
[3,] 3 6 9

> apply(x,1,function(x) x * 10) #or apply(x,2,function(x) x * 10)

[1] 10 20 30 40 50 60 70 80 90

lapply() function can handle data frame with similar results, return is a list:

> lapply(BOD,sum)

$Time
[1] 22
$demand
[1] 89

> lapply(BOD,mean)

$Time
[1] 3.666667
$demand
[1] 14.83333

sapply() has similar function, it defines "simplify=TRUE" by default, thus return a vector:

> sapply(BOD,sum)

Time demand
22 89

> sapply(BOD,sum,simplify=FALSE)

$Time
[1] 22
$demand
[1] 89

mapply()is the multivariate version of sapply(), it applies a function to multiple list or vector arguments.
mapply(FUN, ..., MoreArgs = NULL, SIMPLIFY = TRUE, USE.NAMES = TRUE)

> mapply(sum,BOD$Time,BOD$demand)
[1]  9.3 12.3 22.0 20.0 20.6 26.8
> mapply(sum,BOD$Time)
[1] 1 2 3 4 5 7
> mapply(sum,BOD$demand)
[1]  8.3 10.3 19.0 16.0 15.6 19.8
> mapply(sum, trees)
 Girth Height Volume
410.7 2356.0  935.3
> f <- function(x,y) (x * 12 + y) * 0.0254 #ft in to meter convert
> mapply(f, c(5,6,5),c(3,1,9))
[1] 1.6002 1.8542 1.7526

tapply() applies a function to each cell of a ragged array, that is to each (non-empty) group of values given by a unique combination of the levels of certain factors.
tapply(X, INDEX, FUN = NULL, ..., simplify = TRUE)

This example uses the builtin dataset CO2, sum up the uptake grouped by different plants.

> tapply(CO2$uptake,CO2$Plant, sum)
  Qn1   Qn2   Qn3   Qc1   Qc3   Qc2   Mn3   Mn2   Mn1   Mc2   Mc3   Mc1
232.6 246.1 263.3 209.8 228.1 228.9 168.8 191.4 184.8  85.0 121.1 126.0

Following is the builtin dataset CO2:

Plant        Type  Treatment conc uptake
1    Qn1      Quebec nonchilled   95   16.0
2    Qn1      Quebec nonchilled  175   30.4
3    Qn1      Quebec nonchilled  250   34.8
4    Qn1      Quebec nonchilled  350   37.2
5    Qn1      Quebec nonchilled  500   35.3
6    Qn1      Quebec nonchilled  675   39.2
7    Qn1      Quebec nonchilled 1000   39.7
8    Qn2      Quebec nonchilled   95   13.6
9    Qn2      Quebec nonchilled  175   27.3
10   Qn2      Quebec nonchilled  250   37.1
11   Qn2      Quebec nonchilled  350   41.8
12   Qn2      Quebec nonchilled  500   40.6
13   Qn2      Quebec nonchilled  675   41.4
14   Qn2      Quebec nonchilled 1000   44.3
15   Qn3      Quebec nonchilled   95   16.2
16   Qn3      Quebec nonchilled  175   32.4
17   Qn3      Quebec nonchilled  250   40.3
18   Qn3      Quebec nonchilled  350   42.1
19   Qn3      Quebec nonchilled  500   42.9
20   Qn3      Quebec nonchilled  675   43.9
21   Qn3      Quebec nonchilled 1000   45.5
22   Qc1      Quebec    chilled   95   14.2
23   Qc1      Quebec    chilled  175   24.1
24   Qc1      Quebec    chilled  250   30.3
25   Qc1      Quebec    chilled  350   34.6
26   Qc1      Quebec    chilled  500   32.5
27   Qc1      Quebec    chilled  675   35.4
28   Qc1      Quebec    chilled 1000   38.7
29   Qc2      Quebec    chilled   95    9.3
30   Qc2      Quebec    chilled  175   27.3
31   Qc2      Quebec    chilled  250   35.0
32   Qc2      Quebec    chilled  350   38.8
33   Qc2      Quebec    chilled  500   38.6
34   Qc2      Quebec    chilled  675   37.5
35   Qc2      Quebec    chilled 1000   42.4
36   Qc3      Quebec    chilled   95   15.1
37   Qc3      Quebec    chilled  175   21.0
38   Qc3      Quebec    chilled  250   38.1
39   Qc3      Quebec    chilled  350   34.0
40   Qc3      Quebec    chilled  500   38.9
41   Qc3      Quebec    chilled  675   39.6
42   Qc3      Quebec    chilled 1000   41.4
43   Mn1 Mississippi nonchilled   95   10.6
44   Mn1 Mississippi nonchilled  175   19.2
45   Mn1 Mississippi nonchilled  250   26.2
46   Mn1 Mississippi nonchilled  350   30.0
47   Mn1 Mississippi nonchilled  500   30.9
48   Mn1 Mississippi nonchilled  675   32.4
49   Mn1 Mississippi nonchilled 1000   35.5
50   Mn2 Mississippi nonchilled   95   12.0
51   Mn2 Mississippi nonchilled  175   22.0
52   Mn2 Mississippi nonchilled  250   30.6
53   Mn2 Mississippi nonchilled  350   31.8
54   Mn2 Mississippi nonchilled  500   32.4
55   Mn2 Mississippi nonchilled  675   31.1
56   Mn2 Mississippi nonchilled 1000   31.5
57   Mn3 Mississippi nonchilled   95   11.3
58   Mn3 Mississippi nonchilled  175   19.4
59   Mn3 Mississippi nonchilled  250   25.8
60   Mn3 Mississippi nonchilled  350   27.9
61   Mn3 Mississippi nonchilled  500   28.5
62   Mn3 Mississippi nonchilled  675   28.1
63   Mn3 Mississippi nonchilled 1000   27.8
64   Mc1 Mississippi    chilled   95   10.5
65   Mc1 Mississippi    chilled  175   14.9
66   Mc1 Mississippi    chilled  250   18.1
67   Mc1 Mississippi    chilled  350   18.9
68   Mc1 Mississippi    chilled  500   19.5
69   Mc1 Mississippi    chilled  675   22.2
70   Mc1 Mississippi    chilled 1000   21.9
71   Mc2 Mississippi    chilled   95    7.7
72   Mc2 Mississippi    chilled  175   11.4
73   Mc2 Mississippi    chilled  250   12.3
74   Mc2 Mississippi    chilled  350   13.0
75   Mc2 Mississippi    chilled  500   12.5
76   Mc2 Mississippi    chilled  675   13.7
77   Mc2 Mississippi    chilled 1000   14.4
78   Mc3 Mississippi    chilled   95   10.6
79   Mc3 Mississippi    chilled  175   18.0
80   Mc3 Mississippi    chilled  250   17.9
81   Mc3 Mississippi    chilled  350   17.9
82   Mc3 Mississippi    chilled  500   17.9
83   Mc3 Mississippi    chilled  675   18.9
84   Mc3 Mississippi    chilled 1000   19.9

R Tutorials

Data Type and Structures

Loop, Condition Statements

Plotting and Graphics

Selected Functions List