Download data on the number of seats under dispute in federal elections

seats() downloads and aggregates data on the number of seats under dispute in federal elections in Brazil. The function returns a tbl, data.frame where each observation corresponds to a district-office dyad.

Usage

seats(
  year,
  uf = "all",
  br_archive = FALSE,
  encoding = "latin1",
  temp = TRUE,
  readme_pdf = FALSE
)

Arguments

year: Election year. For this function, only the years of 1998, 2002, 2006, 2010, 2014, 2018, 2022 and 2024 are available.
uf: Federation Unit acronym (character vector).
br_archive: In the TSE's data repository, some results can be obtained for the whole country by loading a single within a single file by setting this argument to TRUE (may not work in for some elections and, in other, it recovers only electoral data for presidential elections, absent in other files).
encoding: Data original encoding (defaults to 'Latin-1'). This can be changed to avoid errors when ascii = TRUE.
temp: (logical). If TRUE keep temporary compressed file
readme_pdf: original readme

Value

seats() returns a data.frame.

Details

If export is set to TRUE, the downloaded data is saved as .dta and .sav files in the current directory.

Note

For the elections prior to 2000, some information can be incomplete.

Examples

if (FALSE) { # \dontrun{
df <- seats(2000)
} # }