legend_local() downloads and aggregates the party denomonations (coalitions or parties) from the local elections in Brazil, disaggregated by cities. The function returns a data.frame where each observation corresponds to a city.

legend_local(year, uf = "all", ascii = FALSE, encoding = "latin1",
  export = FALSE)



Election year. For this function, only the years 2008, 2012 and 2016 are available.


Federation Unit acronym (character vector).


(logical). Should the text be transformed from Latin-1 to ASCII format?


Data original encoding (defaults to 'Latin-1'). This can be changed to avoid errors when ascii = TRUE.


(logical). Should the downloaded data be saved in .dta and .sav in the current directory?


legend_local() returns a data.frame with the following variables:

  • DATA_GERACAO: Generation date of the file (when the data was collected).

  • HORA_GERACAO: Generation time of the file (when the data was collected), Brasilia Time.

  • ANO_ELEICAO: Election year.

  • NUM_TURNO: Round number.

  • DESCRICAO_ELEICAO: Description of the election.

  • SIGLA_UF: Units of the Federation's acronym in which occurred the election.

  • SIGLA_UE: Units of the Federation's acronym (In case of major election is the FU's acronym in which the candidate runs for (text) and in case of municipal election is the municipal's Supreme Electoral Court code (number)). Assume the special values BR, ZZ and VT to designate, respectively, Brazil, Overseas and Absentee Ballot.

  • NOME_UE: Electoral Unit name.

  • CODIGO_CARGO: Code of the position that the candidate runs for.

  • DESCRICAO_CARGO: Description of the position that the candidate runs for.

  • TIPO_LEGENDA: It informs it the candidate runs for 'coalition' or 'isolated party'.

  • NUM_PARTIDO: Party number.

  • SIGLA_PARTIDO: Party acronym.

  • NOME_PARTIDO: Party name.

  • SIGLA_COLIGACAO: Coalition's acronym.

  • CODIGO_COLIGACAO: Coalition's code.

  • COMPOSICAO_COLIGACAO: Coalition's composition.

  • SEQUENCIAL_COLIGACAO: Coalition's sequential number, generated internally by the electoral justice.


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

See also

legend_fed for federal elections in Brazil.


df <- legend_local(2000)
# }