Skip to content

Latest commit

 

History

History
84 lines (60 loc) · 4.12 KB

README.md

File metadata and controls

84 lines (60 loc) · 4.12 KB
Raw

eleicoes-parser

Parser para leitura dos dados vindos do Repositório de Dados do TSE. O objetivo é ter ao final, arquivos CSV com os dados consolidados das seções e das zonas eleitorais.

Como usar?

É recomendando que use este repositório com virtualenv, para que se isole os pacotes instalados aqui, dos do seu SO. Para tanto, é necessário executar os seguintes passos:

# substitua o caminho pelo do python3
virtualenv --python='/usr/bin/python3' .

# para ativar o ambiente virtual
source bin/activate

# o pip irá instalar os pacotes a partir do arquivo requirements.txt
pip install -r requirements.txt

Com os pacotes já instalados, entre na pasta parser e execute o arquivo cli.py

Executando o arquivo cli.py

É imprescindível que, antes de executar o cli, exista na pasta parser/data, dois arquivos:

  • Um referente ao Boletim de Urna do turno que quer analisar
  • E outro referente ao Detalhe da Votação do Estado que quer analisar

Exemplo do Rio de Janeiro, município de Duque de Caxias.

  1. Acesso a página do Repositório de Dados Eleitorais do TSE.
  2. Acesso a página Resultados no menu
  3. Seleciono o ano (referência 2016)
  4. Faço o download do link 'Detalhe da apuração por seção eleitoral (formato ZIP)'
  5. Depois faço o download do link interno da página 'Boletim de urna — Segundo turno'. Nesta página, há uma lista de links para cada Estado. Seleciono o do RJ
  6. Extraio os arquivos baixados
  7. Seleciono o boletim de urna do RJ e copio para a pasta parser/data do repositório
  8. Seleciono o Estado do RJ na pasta resultante criada pela extração do arquivo de Detalhe da Apuração por seção eleitoral e copio para a pasta parser/data do repositório

Se você executar python cli.py, ele irá pegar as configurações padrão, que é analisar o município de Duque de Caxias (código 58335), e gerar dois arquivos que estarão na pasta parser/dataset/, um referente ao detalhe de votação por zona e o outro por seção.

Parâmetros para o cli.py

  • --municipio: é o código do município de análise. Para saber o código, basta abrir qualquer um dos dois arquivos do TSE que foram baixados. O valor padrão é o código do município de Duque de Caxias/RJ.
  • --turno: é o turno que se quer analisar os dados. O valor padrão é dois.
  • --secao_file: é o nome do arquivo de seção que foi baixado do TSE.
  • --boletim_file: é o nome do arquivo de boletim de urna.

É possível ter acesso as mesmas informações, digitando:

python cli.py --help

Qual o output?

O parser irá gerar dois arquivos na pasta parser/dataset:

detalhe_votacao_secao_{codigo_municipio}.csv

Este arquivo contem os dados consolidados por seção. Mais quais dados e quais colunas?

  • codigo_municipio: o código do município que foi avaliado
  • secao: o código da seção eleitoral
  • zona: o código da zona eleitoral
  • aptos: quantidade de eleitores aptos para a seção em análise
  • abstencoes: quantidade de eleitores que não compareceram
  • nao_considerados: soma dos eleitores que não compareceram, juntamente com os votos anulados, brancos e nulos
  • votos_anulados: quantidade de votos anulados
  • votos_brancos: quantidade de votos brancos
  • votos_legenda: quantidade de votos por legenda, que é quando a pessoa vota num partido, e não num candidato
  • votos_nominais: quantidade de votos nominais (válidos)
  • votos_nulos: quantidade de votos nulos
  • percentual_abstencoes: percentual correspondente
  • percentual_anulados: percentual correspondente
  • percentual_brancos: percentual correspondente
  • percentual_legenda: percentual correspondente
  • percentual_nominais: percentual correspondente
  • percentual_nulos: percentual correspondente
  • As duas últimas colunas terão os nomes do candidatos, e por conseguinte, o voto de cada seção por candidato

detalhe_votacao_zona_{codigo_municipio}.csv

Este arquivo é o resultado da somatória por seção do arquivo acima, exceto que não dispõe das colunas com os percentuais, nem da coluna seção.