In this post in the R:case4base series we will look at one of the most common operations on multiple data frames – merge, also known as JOIN in SQL terms.
We will learn how to do the 4 basic types of join – inner, left, right and full join with base R and show how to perform the same with tidyverse’s dplyr and data.table’s methods. A quick benchmark will also be included.
Joins
To showcase the merging, we will use a very slightly modified dataset provided by Hadley Wickham’s nycflights13 package, mainly the flights
and weather
data frames. Let’s get right into it and simply show how to perform the different types of joins with base R.
First, we prepare the data and store the columns we will merge by (join on) into mergeCols
:
1 |
|
1 |
|
1 |
|
1 |
|
Now, we show how to perform the 4 merges (joins):
Inner join
1 |
|
Left (outer) join
1 |
|
Right (outer) join
1 |
|
Full (outer) join
1 |
|
Other join types
1 |
|
The key arguments of base merge
data.frame method are:
-
x, y
– the 2 data frames to be merged -
by
– names of the columns to merge on. If the column names are different in the two data frames to merge, we can specifyby.x
andby.y
with the names of the columns in the respective data frames. Theby
argument can also be specified by number, logical vector or left unspecified, in which case it defaults to the intersection of the names of the two data frames. From best practice perspective it is advisable to always specify the argument explicitly, ideally by column names.
all
, all.x
, all.y
– default to FALSE
and can be used specify the type of join we want to perform:
-
all = FALSE
(the default) – gives an inner join – combines the rows in the two data frames that match on theby
columns -
all.x = TRUE
– gives a left (outer) join – adds rows that are present inx
, even though they do not have a matching row iny
to the result forall = FALSE
-
all.y = TRUE
– gives a right (outer) join – adds rows that are present iny
, even though they do not have a matching row inx
to the result forall = FALSE
-
all = TRUE
– gives a full (outer) join. This is a shorthand forall.x = TRUE
andall.y = TRUE
Other arguments include
-
sort
– ifTRUE
(default), results are sorted on theby
columns -
suffixes
– length 2 character vector, specifying the suffixes to be used for making the names of columns in the result which are not used for merging unique -
incomparables
– for single-column merging only, a vector of values that cannot be matched. Any value inx
matching a value in this vector is assigned thenomatch
value (which can be passed using...
)
For this example, let us have a list of all the data frames included in the nycflights13
package, slightly updated such that they can me merged with the default value for by
, purely for this exercise, and store them into a list called flightsList
:
1 |
|
1 |
|
Since merge
is designed to work with 2 data frames, merging multiple data frames can of course be achieved by nesting the calls to merge:
1 |
|
We can however achieve this same goal much more elegantly, taking advantage of base R’s Reduce
function:
1 |
|
Note that this example is oversimplified and the data was updated such that the default values for by
give meaningful joins. For example, in the original planes
data frame the column year
would have been matched onto the year
column of the flights
data frame, which is nonsensical as the years have different meanings in the two data frames. This is why we renamed the year
column in the planes
data frame to yearmanufactured
for the above example.
Using the tidyverse
The dplyr
package comes with a set of very user-friendly functions that seem quite self-explanatory:
1 |
|
We can also use the “forward pipe” operator %>%
that becomes very convenient when merging multiple data frames:
1 |
|
Using data.table
The data.table
package provides an S3 method for the merge
generic that has a very similar structure to the base method for data frames, meaning its use is very convenient for those familiar with that method. In fact the code is exactly the same as the base one for our example use.
One important difference worth noting is that the
by
argument is by default constructed differently with data.table.
We however provide it explicitly, therefore this difference does not directly affect our example:
1 |
|
Alternatively, we can write data.table
joins as subsets:
1 |
|
For a quick overview, lets look at a basic benchmark without package loading overhead for each of the mentioned packages:
Inner join
1 |
|
Full (outer) join
1 |
|
Visualizing the results in this case shows base R comes way behind the two alternatives, even with
sort = FALSE
.
Note: The benchmarks are ran on a standard droplet by DigitalOcean, with 2GB of memory a 2vCPUs.
Related