Add turnout to referendum data

Augments data with an additional column turnout containing the voter turnout calculated as:

$$\frac{votes\_yes+votes\_no+votes\_empty+votes\_invalid}{electorate\_total}$$

Usage

add_turnout(data, rough = TRUE, excl_dubious = TRUE)

Arguments

data

RDB referendum data as returned by rfrnds(). A data frame that at minimum contains the columns electorate_total, votes_yes, votes_no, votes_empty and votes_invalid.

rough

Whether to fall back on a "rough" calculation of the turnout in case any of the variables votes_empty or votes_invalid is unknown (NA), or to be strict and return NA in such a case.

excl_dubious

Whether or not to exclude obviously dubious turnout numbers (those > 1.0) by setting them to NA. Such numbers stem either from data errors or (officially) tampered numbers.

Value

A tibble.

See also

Other referendum data augmentation functions: add_country_code_continual(), add_country_code_long(), add_country_name(), add_country_name_long(), add_former_country_flag(), add_period(), add_urls(), add_world_regions()

Examples

# rough turnout numbers
rdb::rfrnds(quiet = TRUE) |>
  rdb::add_turnout() |>
  dplyr::select(id,
                electorate_total,
                starts_with("votes_"),
                turnout)
#> # A tibble: 17,892 × 8
#>    id                       electorate_total votes_yes votes_no votes_empty votes_invalid votes_per_subterritory turnout
#>    <chr>                               <int>     <int>    <int>       <int>         <int> <list>                   <dbl>
#>  1 670cd145c3cd67046058015c            76411     16019    23569         318           490 <NULL>                   0.529
#>  2 66fff490c3cd670460580111            21114      6920     5481          23           225 <NULL>                   0.599
#>  3 66ffdfe3c3cd6704605800fc            54688     19470     7253         644           125 <NULL>                   0.503
#>  4 66ffdc31c3cd6704605800ee            26673      4121     7398         126            30 <NULL>                   0.438
#>  5 66ffd956c3cd6704605800ec            26673      7039     4039         322            29 <NULL>                   0.428
#>  6 66ffbf93c3cd6704605800df            31344     11786     2548         342            91 <NULL>                   0.471
#>  7 66f686cfc3cd6704605800a0            64092     20941     2928         754            37 <NULL>                   0.385
#>  8 66f68317c3cd67046058009c           749365    264717    40600       13410           638 <NULL>                   0.426
#>  9 66d6da9cc3cd670460580053           191809     46549    28802        1905          1012 <NULL>                   0.408
#> 10 66cde603c3cd67046057fff5           142124     42607    12563        1037           720 <NULL>                   0.401
#> # ℹ 17,882 more rows

# strict turnout numbers
rdb::rfrnds(quiet = TRUE) |>
  rdb::add_turnout(rough = FALSE) |>
  dplyr::select(id,
                electorate_total,
                starts_with("votes_"),
                turnout)
#> # A tibble: 17,892 × 8
#>    id                       electorate_total votes_yes votes_no votes_empty votes_invalid votes_per_subterritory turnout
#>    <chr>                               <int>     <int>    <int>       <int>         <int> <list>                   <dbl>
#>  1 670cd145c3cd67046058015c            76411     16019    23569         318           490 <NULL>                   0.529
#>  2 66fff490c3cd670460580111            21114      6920     5481          23           225 <NULL>                   0.599
#>  3 66ffdfe3c3cd6704605800fc            54688     19470     7253         644           125 <NULL>                   0.503
#>  4 66ffdc31c3cd6704605800ee            26673      4121     7398         126            30 <NULL>                   0.438
#>  5 66ffd956c3cd6704605800ec            26673      7039     4039         322            29 <NULL>                   0.428
#>  6 66ffbf93c3cd6704605800df            31344     11786     2548         342            91 <NULL>                   0.471
#>  7 66f686cfc3cd6704605800a0            64092     20941     2928         754            37 <NULL>                   0.385
#>  8 66f68317c3cd67046058009c           749365    264717    40600       13410           638 <NULL>                   0.426
#>  9 66d6da9cc3cd670460580053           191809     46549    28802        1905          1012 <NULL>                   0.408
#> 10 66cde603c3cd67046057fff5           142124     42607    12563        1037           720 <NULL>                   0.401
#> # ℹ 17,882 more rows