details_mun_zone_fed.Rddetails_mun_zone_fed() downloads and aggregates data on the verification of federal elections in Brazil,
disaggregated by town and electoral zone. The function returns a data.frame where each observation
corresponds to a town/zone.
details_mun_zone_fed(year, uf = "all", br_archive = FALSE, ascii = FALSE, encoding = "latin1", export = FALSE)
| year | Election year. For this function, only the years 1994, 1998, 2002, 2006, 2010, 2014 and 2018 are available. |
|---|---|
| uf | Federation Unit acronym ( |
| 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 |
| ascii | ( |
| encoding | Data original encoding (defaults to 'Latin-1'). This can be changed to avoid errors
when |
| export | ( |
details_mun_zone_fed() 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.
CODIGO_MUNICIPIO: Supreme Electoral code from the city where occurred the election.
NOME_MUNICIPIO: Name of the city where occurred the election.
CODIGO_CARGO: Code of the position that the candidate runs for.
DESCRICAO_CARGO: Description of the position that the candidate runs for.
QTD_APTOS: Number of eligible voters to vote in that city and zone.
QTD_SECOES: Number of existing polling stations in that city and zone. It only considers main sections.
QTD_SECOES_AGREGADAS: Number of polling stations that have been aggregated for the voting the same ballot box in that city and area. To add sections means to unite polling stations in a single receiving table votes, in order to meet the Electoral Code, which establishes, as a rule, a minimum of 50 voters in a section election, and to optimize the use of resources for the polls electronic and poll workers.
QTD_APTOS_TOT: Number of eligible voters in the total sections.
QTD_SECOES_TOT: Total number of polling stations in that city and area.
QTD_COMPARECIMENTO: Number of voters who attended the elections in city and district in that position.
QTD_ABSTENCOES: Number of voters who did not attend the elections in city and area.
QTD_VOTOS_NOMINAIS: Total number of nominal votes in that city and zone.
QTD_VOTOS_BRANCOS: Total number of blank votes in that city and zone.
QTD_VOTOS_NULOS: Total number of spoilt votes in that city and zone.
QTD_VOTOS_LEGENDA: Total number of votes in coalitions in that city and zone.
QTD_VOTOS_ANULADOS_APU_SEP: Amount of canceled votes and votes counted separately in that city and zone. This number reflects the votes coming from some ballot box that is sub-judice. They are not yet valid votes or null until the decision of the electoral court.
DATA_ULT_TOTALIZACAO: Date of the last totalization in that city and zone.
HORA_ULT_TOTALIZACAO: Time of the last totalization in that city and zone.
TRANSITO: It informs if whether the record relates or not to absentee ballot votes (only for 2014 election).
From 2018 on, some new variables are also available:
COD_TIPO_ELEICAO: Election type code.
NOME_TIPO_ELEICAO: Election type.
COD_ELEICAO: Election code.
DATA_ELEICAO: Election date.
ABRANGENCIA: Election scope.
NOME_UE: Electoral unit name.
QTD_VOTOS_PENDENTES: Number of pending votes.
QTD_VOTOS_ANULADOS: Number of invalidated votes.
If export is set to TRUE, the downloaded data is saved as .dta and .sav
files in the current directory.
For the elections prior to 2002, some information can be incomplete. For the 2014 and 2018 elections, more variables are available.
details_mun_zone_local for local elections in Brazil.
# NOT RUN { df <- details_mun_zone_fed(2002) # }