── Attaching core tidyverse packages ──────────────────────── tidyverse 2.0.0 ──
✔ dplyr 1.1.4 ✔ readr 2.1.5
✔ forcats 1.0.0 ✔ stringr 1.5.1
✔ ggplot2 3.5.1 ✔ tibble 3.2.1
✔ lubridate 1.9.3 ✔ tidyr 1.3.1
✔ purrr 1.0.2
── Conflicts ────────────────────────────────────────── tidyverse_conflicts() ──
✖ dplyr::filter() masks stats::filter()
✖ dplyr::lag() masks stats::lag()
ℹ Use the conflicted package (<http://conflicted.r-lib.org/>) to force all conflicts to become errors
Logical vectors
Introduction
In this chapter, you’ll learn tools for working with logical vectors.
Logical vectors are the simplest type of vector because each element can only be one of three possible values: TRUE, FALSE, and NA.
It’s relatively rare to find logical vectors in your raw data, but you’ll create and manipulate them in the course of almost every analysis.
Introduction
We’ll begin by discussing the most common way of creating logical vectors: with numeric comparisons.
Then you’ll learn about how you can use Boolean algebra to combine different logical vectors, as well as some useful summaries.
We’ll finish off with if_else() and case_when(), two useful functions for making conditional changes powered by logical vectors.
Comparisons
A very common way to create a logical vector is via a numeric comparison with <, <=, >, >=, !=, and ==. So far, we’ve mostly created logical variables transiently within filter() — they are computed, used, and then thrown away. For example, the following filter finds all daytime departures that arrive roughly on time:
This is particularly useful for more complicated logic because naming the intermediate steps makes it easier to both read your code and check that each step has been computed correctly.
Beware of using == with numbers. For example, it looks like this vector contains the numbers 1 and 2:
x <-c(1/49*49, sqrt(2) ^2)x
[1] 1 2
Floating point comparison
But if you test them for equality, you get FALSE:
x ==c(1, 2)
[1] FALSE FALSE
What’s going on?
Computers store numbers with a fixed number of decimal places so there’s no way to exactly represent 1/49 or sqrt(2) and subsequent computations will be very slightly off. We can see the exact values by calling print() with the digits argument:
print(x, digits =16)
[1] 0.9999999999999999 2.0000000000000004
What’s going on?
print(x, digits =16)
[1] 0.9999999999999999 2.0000000000000004
You can see why R defaults to rounding these numbers; they really are very close to what you expect.
Now that you’ve seen why == is failing, what can you do about it?
Solution
One option is to use dplyr::near() which ignores small differences:
near(x, c(1, 2))
[1] TRUE TRUE
Missing values
Missing values represent the unknown so they are “contagious”: almost any operation involving an unknown value will also be unknown:
NA>5
[1] NA
10==NA
[1] NA
The most confusing result is this one:
NA==NA
[1] NA
Missing values
It’s easiest to understand why this is true if we artificially supply a little more context:
# We don't know how old Mary isage_mary <-NA# We don't know how old John isage_john <-NA# Are Mary and John the same age?age_mary == age_john
[1] NA
# We don't know!
Missing values
So if you want to find all flights where dep_time is missing, the following code doesn’t work because dep_time == NA will yield NA for every single row, and filter() automatically drops missing values:
is.na(x) works with any type of vector and returns TRUE for missing values and FALSE for everything else:
is.na(c(TRUE, NA, FALSE))
[1] FALSE TRUE FALSE
is.na(c(1, NA, 3))
[1] FALSE TRUE FALSE
is.na(c("a", NA, "b"))
[1] FALSE TRUE FALSE
Missing values
We can use is.na() to find all the rows with a missing dep_time:
flights |>filter(is.na(dep_time))
# A tibble: 8,255 × 19
year month day dep_time sched_dep_time dep_delay arr_time sched_arr_time
<int> <int> <int> <int> <int> <dbl> <int> <int>
1 2013 1 1 NA 1630 NA NA 1815
2 2013 1 1 NA 1935 NA NA 2240
3 2013 1 1 NA 1500 NA NA 1825
4 2013 1 1 NA 600 NA NA 901
5 2013 1 2 NA 1540 NA NA 1747
6 2013 1 2 NA 1620 NA NA 1746
7 2013 1 2 NA 1355 NA NA 1459
8 2013 1 2 NA 1420 NA NA 1644
9 2013 1 2 NA 1321 NA NA 1536
10 2013 1 2 NA 1545 NA NA 1910
# ℹ 8,245 more rows
# ℹ 11 more variables: arr_delay <dbl>, carrier <chr>, flight <int>,
# tailnum <chr>, origin <chr>, dest <chr>, air_time <dbl>, distance <dbl>,
# hour <dbl>, minute <dbl>, time_hour <dttm>
Missing values
is.na() can also be useful in arrange(). arrange() usually puts all the missing values at the end but you can override this default by first sorting by is.na():
flights |>filter(month ==1, day ==1) |>arrange(dep_time)
is.na() can also be useful in arrange(). arrange() usually puts all the missing values at the end but you can override this default by first sorting by is.na():
flights |>filter(month ==1, day ==1) |>arrange(desc(is.na(dep_time)), dep_time)
# A tibble: 842 × 19
year month day dep_time sched_dep_time dep_delay arr_time sched_arr_time
<int> <int> <int> <int> <int> <dbl> <int> <int>
1 2013 1 1 NA 1630 NA NA 1815
2 2013 1 1 NA 1935 NA NA 2240
3 2013 1 1 NA 1500 NA NA 1825
4 2013 1 1 NA 600 NA NA 901
5 2013 1 1 517 515 2 830 819
6 2013 1 1 533 529 4 850 830
7 2013 1 1 542 540 2 923 850
8 2013 1 1 544 545 -1 1004 1022
9 2013 1 1 554 600 -6 812 837
10 2013 1 1 554 558 -4 740 728
# ℹ 832 more rows
# ℹ 11 more variables: arr_delay <dbl>, carrier <chr>, flight <int>,
# tailnum <chr>, origin <chr>, dest <chr>, air_time <dbl>, distance <dbl>,
# hour <dbl>, minute <dbl>, time_hour <dttm>
Missing values
The rules for missing values in Boolean algebra are a little tricky to explain because they seem inconsistent at first glance:
df <-tibble(x =c(TRUE, FALSE, NA))df |>mutate(and = x &NA,or = x |NA )
# A tibble: 3 × 3
x and or
<lgl> <lgl> <lgl>
1 TRUE NA TRUE
2 FALSE FALSE NA
3 NA NA NA
Missing values
To understand what’s going on, think about NA | TRUE (NA or TRUE).
A missing value in a logical vector means that the value could either be TRUE or FALSE.
TRUE | TRUE and FALSE | TRUE are both TRUE because at least one of them is TRUE.
NA | TRUE must also be TRUE because NA can either be TRUE or FALSE.
However, NA | FALSE is NA because we don’t know if NA is TRUE or FALSE.
Similar reasoning applies with NA & FALSE.
Order of operations
Note that the order of operations doesn’t work like English. Take the following code that finds all flights that departed in November or December:
flights |>filter(month ==11| month ==12)
Order of operations
You might be tempted to write it like you’d say in English: “Find all flights that departed in November or December.”:
This code doesn’t error but it also doesn’t seem to have worked.
What’s going on?
Here, R first evaluates month == 11 creating a logical vector, which we call nov.
Order of operations
It computes nov | 12. When you use a number with a logical operator it converts everything apart from 0 to TRUE, so this is equivalent to nov | TRUE which will always be TRUE, so every row will be selected:
flights |>mutate(nov = month ==11,final = nov |12,.keep ="used" )
An easy way to avoid the problem of getting your ==s and |s in the right order is to use %in%. x %in% y returns a logical vector the same length as x that is TRUE whenever a value in x is anywhere in y .
So to find all flights in November and December we could write:
flights |>filter(month %in%c(11, 12))
%in%
Note that %in% obeys different rules for NA to ==, as NA %in% NA is TRUE.
%in%
This can make for a useful shortcut:
flights |>filter(dep_time %in%c(NA, 0800))
# A tibble: 8,803 × 19
year month day dep_time sched_dep_time dep_delay arr_time sched_arr_time
<int> <int> <int> <int> <int> <dbl> <int> <int>
1 2013 1 1 800 800 0 1022 1014
2 2013 1 1 800 810 -10 949 955
3 2013 1 1 NA 1630 NA NA 1815
4 2013 1 1 NA 1935 NA NA 2240
5 2013 1 1 NA 1500 NA NA 1825
6 2013 1 1 NA 600 NA NA 901
7 2013 1 2 800 810 -10 1102 1116
8 2013 1 2 NA 1540 NA NA 1747
9 2013 1 2 NA 1620 NA NA 1746
10 2013 1 2 NA 1355 NA NA 1459
# ℹ 8,793 more rows
# ℹ 11 more variables: arr_delay <dbl>, carrier <chr>, flight <int>,
# tailnum <chr>, origin <chr>, dest <chr>, air_time <dbl>, distance <dbl>,
# hour <dbl>, minute <dbl>, time_hour <dttm>
Summaries
The following sections describe some useful techniques for summarizing logical vectors. As well as functions that only work specifically with logical vectors, you can also use functions that work with numeric vectors.
Logical summaries
There are two main logical summaries:
any(x) is the equivalent of |; it’ll return TRUE if there are any TRUE’s in x.
all(x) is equivalent of &; it’ll return TRUE only if all values of x are TRUE’s.
Like all summary functions, they’ll return NA if there are any missing values present
You can make the missing values go away with na.rm = TRUE.
Logical summaries
For example, we could use all() and any() to find out if every flight was delayed on departure by at most an hour or if any flights were delayed on arrival by five hours or more. And using group_by() allows us to do that by day:
In most cases, however, any() and all() are a little too crude, and it would be nice to be able to get a little more detail about how many values are TRUE or FALSE.
That leads us to the numeric summaries.
Numeric summaries of logical vectors
When you use a logical vector in a numeric context, TRUE becomes 1 and FALSE becomes 0.
This makes sum() and mean() very useful
sum(x) gives the number of TRUEs
mean(x) gives the proportion of TRUEs (because mean() is just sum() divided by length()).
Numeric summaries of logical vectors
That, for example, allows us to see the proportion of flights that were delayed on departure by at most an hour and the number of flights that were delayed on arrival by five hours or more:
You can use a logical vector to filter a single variable to a subset of interest.
This makes use of the base [] (pronounced subset) operator
Logical subsetting example
Imagine we wanted to look at the average delay just for flights that were actually delayed. One way to do so would be to first filter the flights and then calculate the average delay:
Also note the difference in the group size: in the first chunk n() gives the number of delayed flights per day; in the second, n() gives the total number of flights.
Conditional transformations
One of the most powerful features of logical vectors are their use for conditional transformations, i.e. doing one thing for condition x, and something different for condition y. There are two important tools for this: if_else() and case_when().
if_else()
If you want to use one value when a condition is TRUE and another value when it’s FALSE, you can use dplyr::if_else().
You’ll always use the first three argument of if_else().
The first argument, condition, is a logical vector,
The second, true, gives the output when the condition is true,
The third, false, gives the output if the condition is false.
if_else()
Let’s begin with a simple example of labeling a numeric vector as either “+ve” (positive) or “-ve” (negative):
x <-c(-3:3, NA)if_else(x >0, "+ve", "-ve")
[1] "-ve" "-ve" "-ve" "-ve" "+ve" "+ve" "+ve" NA
if_else()
There’s an optional fourth argument, missing which will be used if the input is NA:
# A tibble: 336,776 × 2
arr_delay status
<dbl> <chr>
1 11 on time
2 20 late
3 33 late
4 -18 early
5 -25 early
6 12 on time
7 19 late
8 -14 on time
9 -8 on time
10 8 on time
# ℹ 336,766 more rows
Be wary when writing this sort of complex case_when() statement; my first two attempts used a mix of < and > and I kept accidentally creating overlapping conditions.
Compatible types
Note that both if_else() and case_when() require compatible types in the output. If they’re not compatible, you’ll see errors like this:
if_else(TRUE, "a", 1)
Error in `if_else()`:
! Can't combine `true` <character> and `false` <double>.
case_when( x <-1~TRUE, x >0~now())
Error in `case_when()`:
! Can't combine `..1 (right)` <logical> and `..2 (right)` <datetime<local>>.
Compatible types
Overall, relatively few types are compatible, because automatically converting one type of vector to another is a common source of errors. Here are the most important cases that are compatible:
Numeric and logical vectors are compatible.
Strings and factors are compatible, because you can think of a factor as a string with a restricted set of values.
Dates and date-times are compatible because you can think of a date as a special case of date-time.
NA, which is technically a logical vector, is compatible with everything because every vector has some way of representing a missing value.