Skip to contents

Index of the Parquet files distributed by the package, one per election year, with the URL they are downloaded from and the checksums used to verify the download. Used internally by get_elected(); the host can be overridden with the electedBR.base_url option or the base_url argument.

Usage

elected_years

Format

A data frame with one row per year and the columns:

year

Election year.

kind

"municipal" (mayors, deputy mayors and councilors) or "general" (senators and federal, state and district deputies).

file

File name (for example elected_2024.parquet).

url

Download URL of the file.

bytes

File size in bytes, used to check the download.

md5

MD5 checksum of the file.

rows

Number of rows (elected candidates plus alternates).

built

Date on which the file was generated from the TSE data.

Source

Derived from the TSE open data portal, https://dadosabertos.tse.jus.br/; files hosted at https://huggingface.co/datasets/mlkwy/electedBR.

Details

Each file is the output of normalize_elected() with include_alternates = TRUE applied to the TSE votação nominal por município e zona dataset of that year, so it holds both the elected candidates and the alternates classified in the TSE file.

Examples

elected_years
#>   year      kind                 file
#> 1 2018   general elected_2018.parquet
#> 2 2020 municipal elected_2020.parquet
#> 3 2022   general elected_2022.parquet
#> 4 2024 municipal elected_2024.parquet
#>                                                                                 url
#> 1 https://huggingface.co/datasets/mlkwy/electedBR/resolve/main/elected_2018.parquet
#> 2 https://huggingface.co/datasets/mlkwy/electedBR/resolve/main/elected_2020.parquet
#> 3 https://huggingface.co/datasets/mlkwy/electedBR/resolve/main/elected_2022.parquet
#> 4 https://huggingface.co/datasets/mlkwy/electedBR/resolve/main/elected_2024.parquet
#>      bytes                              md5   rows      built
#> 1  1470234 6511c61179cc912b1fa8f7acf3510d06  20226 2026-09-25
#> 2 25080587 9b98238024ea82e2a86140e03a88c2ae 381334 2026-09-25
#> 3  1195316 e2e8be8711835982ab392cc4433c074d  16324 2026-09-25
#> 4 20393662 7053e97fd142ab7ba1952ee1fddcb9f0 306023 2026-09-25