O CepespData
O CepespData, é uma plataforma de acesso a dados eleitorais brasileiros desenvolvida pelo Centro de Política e Economia do Setor Público (CEPESP) da Fundação Getulio Vargas (FGV) com coordenação do professor Dr. George Avelino Filho.
Para citar o banco de dados do CespepData, utilize o seguinte modelo:
FGV CEPESP (2020). CepespData - Banco de Dados Políticos. Visitado em XX/XX/XXX. Disponível em http://cepespdata.io
Princípios
Transparência
Fonte bruta do TSE: O CepespData foi elaborado utilizando como fonte os dados disponibilizados pelo TSE no Repositório de Dados Eleitorais. O CepespData provê um repositório da atividade eleitoral no Brasil, não um registro de como o TSE armazena os seus dados.
Tirando um foto do dia da eleição: Optou-se por se trabalhar com a votação por seção eleitoral (em vez dos resultados agregados por município e zona), privilegiando a vontade do eleitor, uma vez que esse é o único arquivo em que o TSE não atualiza o resultado conforme decisões judiciais posteriores ao dia da eleição. Esses dados, portanto, são a representação mais próxima do que ocorreu no dia da eleição.
Rigor
Alto grau de consistência: Um persistente trabalho para reforçar a consistência dos dados garante que as diferenças de votos reportada pelas bases do Cepespdata /FGV nunca sejam superior a 1% aos resultados reportados pelo TSE.
Integridade de dados originais: Não mexemos em nenhum dado do TSE para preservar consistência com os dados originais e outras pesquisas. Erros descobertos nos dados brutos são comunicados ao TSE para correção na origem.
Inclusão
Múltiplas formas de acesso: Os dados são facilmente acessáveis por meio de um website interativo, API REST, mapas interativos, pacote R e Python APIs. “Chaves” comuns, como os códigos de munícipio do IBGE, foram incluídos para facilitar a junção com outros bancos de dados.
Simplificando a vida do pesquisador: O CepespData padroniza, simplifica, e complementa os dados do TSE para facilitar análises de usuários. Os dados são nomeados e categorizados de forma clara, padronizando formatos e tipos de variáveis. Seguindo os princípios do tidy data, cada linha é uma observação, cada variável é uma coluna e (com exceção da base dados consolidada) cada tipo de observação uma tabela.
Escopo do Banco de Dados
Notas sobre as consultas aos dados eleitorais
Tanto as consultas pelas API’s, quanto as consultas realizadas no site do CepespData (Resultados eleitorais, Resumo das eleições e Bancos desagregados) requerem o preenchimentos de pelo menos dois dos campos acima. Clique aqui para mais informações sobre como usar as API’s
Além das consultas aos resultados eleitorais também estão disponíveis os dados de bens dos candidatos, filiados, carreiras dos candidatos, secretários estaduais, indicadores e mapas eleitorais.
Testes de Consistência
A equipe do CepespData realiza testes de consistência periodicamente e tem como princípio o alto grau de consistência dos dados disponibilizados nas plataformas que produz.
Todas as manipulações das bases originais procuram ser transparentes e replicáveis de ponta a ponta. Ou seja, qualquer pessoa, tendo em mãos os dados do TSE e nossos códigos, deverá poder replicar nossa limpeza e manipulação dos dados.
Com esse intuito disponibilizamos via Github os códigos de extração e manipulação dos dados provenientes do TSE. A cada atualização da base de dados do CepespData realizamos os seguintes testes:
Notas sobre os problemas detectados
A equipe do FGV Cepesp identificou problemas de consistência nos dados originais do TSE para o ano de 1998 no Estado do Rio de Janeiro, no qual o número de eleitores (definido nos testes como a quantidade de comparecimento) e votos reportados são menores do que o real.
Os testes de consistência apontaram problemas no ano de 2000, no qual as observações estão duplicadas nos dados originais do TSE.
Verificou-se a ausência de municípios em algumas bases do TSE no ano de 2000 e 2004.
Foram diagnosticadas incosistências no banco de filiados no preenchimento dos campos da data de cancelamento da filiação e data de desfiliação - preenchidos com datas conflitantes. Esses dados foram devidamente analisados e permanecem na base. Recomendamos a Resolução Nº23.596 de 20 de Agosto de 2019 para mais informações a respeito das regras do TSE sobre o preenchimento desses campos.
Um conjunto de pequenas inconsistências foram encontradas nos dados originais do TSE, mas são inferiores a 1% dos resultados.
O relatório e a rotina de testes desenvolvidos pela equipe do CepespData está disponível no nosso Github
Como é feito o Cepespdata?
Notas sobre os dados brutos
- Para conhecimento das colunas originais do TSE, por favor consultar o LEIA-ME disponibilizado pelo tribunal aqui.Também disponibilizamos um resumo deste documento aqui
Como forma de facilitar a análise dos dados eleitorais, padronizou-se a nomeclatura de colunas e campos utilizadas pelo TSE, permitindo a integração entre as diferentes bases de dados disponibilizadas pela Justiça Eleitoral para uma mesma eleição, mas também entre diferentes pleitos.
Uma breve descrição de cada coluna pode ser encontrada em “ADICIONAR COLUNAS” em todas as consultas.
Todas as informações referentes a candidaturas têm origem nos dados reportados pelos próprios candidatos ao TSE.
Problemas em relação aos dados extraídos do TSE e, que foram diagnosticados pela equipe do Cepesp, podem ser encontrados na seção de Testes de Consistências.
Locais de Votação
O CepespData adicionou em suas ferramentas de consulta a agregação dos dados eleitorais por local de votação. Para isso, foi necessário um cuidadoso processo de georreferenciamento dos locais de votação.
O código utilizado e a documentação de cada etapa do georreferenciamento estão disponíveis no Github do CepespData. Também estão documentados os resultados dos testes de consistências realizados no georreferenciamento.
Codebook do CepespData
Abaixo, é possível conferir quais são as variáveis disponíveis nas nossas bases de dados.
Votos
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| ANO_ELEICAO | Ano Eleição | Inteiro | 1998, 2000, 2002, 2004, 2006, 2008, 2010, 2012, 2014, 2016, 2018 | Indica o ano em que ocorreu o pleito. Eleições municipais iniciam em 2000 e têm recorrência cada 4 anos. Eleições gerais iniciam em 1998 e têm recorrência cada 4 anos. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UE | Sigla da Unidade Estadual | Carácter / Inteiro | Código do município do TSE Sigla da UF BR VT ZZ | Sigla da Unidade Eleitoral (Em caso de eleição majoritária é a sigla da UF que o candidato concorre (texto) e em caso de eleição municipal é o código TSE do município (número). Para eleições nacionais, também se aplicam: BR - Quando se trata de informação a nível nacional; VT - Quando se trata de voto em trânsito; ZZ - Quando se trata de voto no exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TURNO | Número do turno | Inteiro | 1 e 2 | Indica o turno eleitoral. Eleições majoritárias podem ter até 2 turnos 1 - primeiro turno; 2 - segundo turno | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ELEICAO | Descrição da eleição | Carácter | Texto exemplo “ELEIÇÃO GERAL FEDERAL 2018” | Descreve tipo, nível e ano da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_CARGO | Código do cargo | Inteiro | 1, 3, 5, 6, 7, 11 e 13 | Código do cargo disputado utilizado pelo TSE 1 - Presidente; 3 - Governador 5 - Senador; 6 - Deputado Federal; 7 - Deputado Estadual; 11 - Prefeito 13 - Vereador | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_CARGO | Descrição do cargo | Carácter | “PRESIDENTE” “GOVERNADOR” “SENADOR” “DEPUTADO FEDERAL” “DEPUTADO ESTADUAL” “PREFEITO” “VEREADOR” | Descrição do cargo disputado utilizada pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_CANDIDATO | Número do candidato | Inteiro | Número de urna do candidato | Número de urna do candidato cadastrado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_MACRO | Código macro | Inteiro | 1, 2, 3, 4, 5, 99 | Macrorregiões confor me classificação IBGE 1 - Norte, 2 - Nordeste, 3 - Sudeste, 4 - Sul 5 - Centro-Oeste e 99 - Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MACRO | Nome macro | Carácter | “Norte”, “Nordeste”, “Centro-Oeste”, “Sudeste”, “Sul” e “Exterior” | Nome da macrorregião conforme classificação do IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| UF | Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação ZZ - Votação no Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_UF | Nome da Unidade Federativa | Carácter | “Acre”, “Alagoas”, “Amazonas”, “Bahia”, “Ceará”, “Destrito Federal”, “Espírito Santo”, “Goiás”, “Maranhão”, Minas Gerais, “Mato Grosso”, “Mato Grosso do Sul”, “Pará”, “Paraíba”, “Pernambuco”, “Piauí”, “Paraná”, “Rio de Janeiro”, “Rio Grande do Norte”, “Rondônia”, “Roraima”, “Rio Grande do Sul”, “Santa Catarina”, “Sergipe”, “São Paulo”, “Tocantins”, “Exterior” | Nome da Unidade Federativa | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MESO | Código meso | Inteiro | Sequência numérica | Código da mesorregião utilizada pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MESO | Nome meso | Carácter | Texto exemplo “Vale do Acre” | Nome da mesorregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MICRO | Código micro | Inteiro | Sequência numérica | Código da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MICRO | Nome micro | Carácter | Texto exemplo “Rio Branco” | Nome da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| COD_MUN_TSE | Código município TSE | Inteiro | Sequência numérica | Código do município utilizado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_MUN_IBGE | Código município IBGE | Inteiro | Sequência numérica | Código do município utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MUNICIPIO | Nome do município | Carácter | Texto exemplo “Acrelândia” | Nome do município onde ocorreu a eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_ZONA | Número da zona | Inteiro | Sequência numérica | Número da zona na qual ocorreu a votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_SECAO | Número da seção | Inteiro | Sequência numérica | Número da seção na qual ocorreu a votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QTDE_VOTOS | Quantidade de votos | Inteiro | Números > 0 | Total de votos obtidos pelo candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Coligações
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| DATA_GERACAO | Data da geração | Carácter | Texto exemplo “25/03/2017” | Data em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| HORA_GERACAO | Hora da geração | Carácter | Texto exemplo “19:14:24” | Hora em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| ANO_ELEICAO | Ano Eleição | Inteiro | 1998, 2000, 2002, 2004, 2006, 2008, 2010, 2012, 2014, 2016, 2018 | Indica o ano em que ocorreu o pleito. Eleições municipais iniciam em 2000 e têm recorrência cada 4 anos. Eleições gerais iniciam em 1998 e têm recorrência cada 4 anos. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TURNO | Número do turno | Inteiro | 1 e 2 | Indica o turno eleitoral. Eleições majoritárias podem ter até 2 turnos 1 - primeiro turno; 2 - segundo turno | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ELEICAO | Descrição da eleição | Carácter | Texto exemplo “ELEIÇÃO GERAL FEDERAL 2018” | Descreve tipo, nível e ano da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UF | Sigla da Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação ZZ - Votação no Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| SIGLA_UE | Sigla da Unidade Estadual | Carácter / Inteiro | Código do município do TSE Sigla da UF BR VT ZZ | Sigla da Unidade Eleitoral (Em caso de eleição majoritária é a sigla da UF que o candidato concorre (texto) e em caso de eleição municipal é o código TSE do município (número). Para eleições nacionais, também se aplicam: BR - Quando se trata de informação a nível nacional; VT - Quando se trata de voto em trânsito; ZZ - Quando se trata de voto no exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_CARGO | Código do cargo | Inteiro | 1, 3, 5, 6, 7, 11 e 13 | Código do cargo disputado utilizado pelo TSE 1 - Presidente; 3 - Governador 5 - Senador; 6 - Deputado Federal; 7 - Deputado Estadual; 11 - Prefeito 13 - Vereador | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_CARGO | Descrição do cargo | Carácter | “PRESIDENTE”, “GOVERNADOR” “SENADOR”, “DEPUTADO FEDERAL”, “DEPUTADO ESTADUAL”, “PREFEITO”, “VEREADOR” | Descrição do cargo disputado utilizada pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| TIPO_LEGENDA | Tipo da legenda | Carácter | “COLIGACAO”, “PARTIDO ISOLADO” | Informa se o candidato concorreu por coligação ou partido isolado | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_PARTIDO | Número do partido | Inteiro | Sequência numérica | Número do partido homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_PARTIDO | Sigla do partido | Carácter | Texto exemplo “PRB” | Sigla do partido homologada no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_PARTIDO | Nome do partido | Carácter | Texto exemplo “Partido Republicano Brasileiro” | Nome do partido homolagado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_COLIGACAO | Sigla da coligação | Carácter | #NE | Sigla da legenda pela qual o candidato concorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_COLIGACAO | Nome da coligação | Carácter | Texto exemplo “Para Unir o Brasil” | Nome da coligação homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COMPOSICAO_COLIGACAO | Composição da coligação | Carácter | Texto exemplo “PSDB / PTB / PP / PR / DEM / SOLIDARIEDADE / PPS / PRB / PSD” | Partidos que compõem a coligação conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SEQUENCIA_COLIGACAO | Sequência da coligação | Inteiro | Sequência numérica | Sequência da coligação conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Candidatos
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| DATA_GERACAO | Data da geração | Carácter | Texto exemplo “25/03/2017” | Data em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| HORA_GERACAO | Hora da geração | Carácter | Texto exemplo “19:14:24” | Hora em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| ANO_ELEICAO | Ano Eleição | Inteiro | 1998, 2000, 2002, 2004, 2006, 2008, 2010, 2012, 2014, 2016, 2018 | Indica o ano em que ocorreu o pleito. Eleições municipais iniciam em 2000 e têm recorrência cada 4 anos. Eleições gerais iniciam em 1998 e têm recorrência cada 4 anos. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TURNO | Número do turno | Inteiro | 1 e 2 | Indica o turno eleitoral. Eleições majoritárias podem ter até 2 turnos 1 - primeiro turno; 2 - segundo turno | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ELEICAO | Descrição da eleição | Carácter | Texto exemplo “ELEIÇÃO GERAL FEDERAL 2018” | Descreve tipo, nível e ano da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UF | Sigla da Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação ZZ - Votação no Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| SIGLA_UE | Sigla da Unidade Estadual | Carácter / Inteiro | Código do município do TSE Sigla da UF BR VT ZZ | Sigla da Unidade Eleitoral (Em caso de eleição majoritária é a sigla da UF que o candidato concorre (texto) e em caso de eleição municipal é o código TSE do município (número). Para eleições nacionais, também se aplicam: BR - Quando se trata de informação a nível nacional; VT - Quando se trata de voto em trânsito; ZZ - Quando se trata de voto no exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_UE | Descrição da Unidade Estadual | Carácter | Texto exemplo “BUJARI” | NA | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_CARGO | Código do cargo | Inteiro | 1, 3, 5, 6, 7, 11 e 13 | Código do cargo disputado utilizado pelo TSE 1 - Presidente; 3 - Governador 5 - Senador; 6 - Deputado Federal; 7 - Deputado Estadual; 11 - Prefeito 13 - Vereador | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_CARGO | Descrição do cargo | Carácter | “PRESIDENTE”, “GOVERNADOR” “SENADOR”, “DEPUTADO FEDERAL”, “DEPUTADO ESTADUAL”, “PREFEITO”, “VEREADOR” | Descrição do cargo disputado utilizada pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_CANDIDATO | Nome do candidato | Carácter | Texto exemplo “JOÃO DA SILVA” | Nome de registro do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_CANDIDATO | Número do candidato | Inteiro | Sequência numérica | Número votável do candidato conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CPF_CANDIDATO | Código de Pessoa Física do candidato | Inteiro | Sequência numérica | CPF do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_URNA_CANDIDATO | Nome de urna do candidato | Carácter | Texto exemplo “JOÃOZINHO” | Nome do canidato conforme aparece na urna | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_SITUACAO_CANDIDATURA | Código de situação da candidatura | Inteiro | Em 1998: 2, 4, 3, 5, 10, 7, 8, 9 e 6 Em 2002: 2, 4, 14, 5, 10, 7, 13 e 6 A partir de 2006: 2, 16, 4, 14, 5, 10, 7, 13 e 6 | Código de situação da candidatura utilizado pelo TSE. Alguns códigos apesar de permanecerem com o mesmo número têm significados diferentes. Em 1998: 2 - “DEFERIDO”, 4 - “SUB-JÚDICE”, 3 - “INDEFERIDO”, 5 - “CANCELAMENTO DO PEDIDO”, 10 - “CASSADO”, 7 - “FALECIDO”, 8 - “HOMOLOGAÇÃO DE DESISTÊNCIA”, 9 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” Em 2002: 2 - “DEFERIDO”, 4 - “SUB JUDICE”, 14 - “INDEFERIDO”, 5 - “CANCELADO”, 10 - “CASSADO”, 7 - “FALECIMENTO”, 13 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” A partir de 2006: 2 - “DEFERIDO”, 16 - “DEFERIDO COM RECURSO”, 4 - “INDEFERIDO COM RECURSO”, 5 - “CANCELADO”, 10 - “CASSADO”, 7 - “FALECIDO”, 13 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DES_SITUACAO_CANDIDATURA | Descrição da situação da candidatura | Carácter | Em 1998: “DEFERIDO”, “SUB-JÚDICE”, “INDEFERIDO”, “CANCELAMENTO DO PEDIDO”, “CASSADO”, “FALECIDO”, “HOMOLOGAÇÃO DE DESISTÊNCIA”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” Em 2002: “DEFERIDO”, “SUB JUDICE”, “INDEFERIDO”, “CANCELADO”, “CASSADO”, “FALECIMENTO”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” A partir de 2006: “DEFERIDO”, “DEFERIDO COM RECURSO”, “INDEFERIDO COM RECURSO”, “CANCELADO”, “CASSADO”, “FALECIDO”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” | Descrição da situação da candidatura utilizado pelo TSE. Algumas descrições apesar de terem o mesmo significado são escritas de forma diferente. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_PARTIDO | Número do partido | Inteiro | Sequência numérica | Número do partido homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_PARTIDO | Sigla do partido | Carácter | Texto exemplo “PRB” | Sigla do partido homologada no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_PARTIDO | Nome do partido | Carácter | Texto exemplo “Partido Republicano Brasileiro” | Nome do partido homolagado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_LEGENDA | Código da legenda | Inteiro | Sequência numérica | Código da legenda conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_LEGENDA | Sigla da legenda | Carácter | #NULO# | Sigla da legenda pela qual o candidato concorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COMPOSICAO_LEGENDA | Composição da legenda | Carácter | Texto exemplo “PSDB / PTB / PP / PR / DEM / SOLIDARIEDADE / PPS / PRB / PSD” | Partidos que compõem a legenda conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_COLIGACAO | Nome da coligação | Carácter | Texto exemplo “UNIDOS POR BUJARI” | Nome da coligação homologada no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_OCUPACAO | Código da ocupação | Inteiro | Sequência numérica | Código referente ao tipo de ocupação do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_OCUPACAO | Descrição da ocupação | Carácter | Texto exemplo “Agricultor” | Descrição do tipo de ocupação do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_NASCIMENTO | Data de nascimento | Carácter | Texto exemplo “29/06/1982” | Data de nascimento do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TITULO_ELEITORAL_CANDIDATO | Número do título eleitoral do candidato | Carácter | Sequência numérica | Título eleitoral do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| IDADE_DATA_ELEICAO | Idade na data da eleição | Inteiro | Número >18 | Idade do candidato na data da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_SEXO | Código do sexo | Inteiro | 2 e 4 | Código do sexo do candidato conforme informado ao TSE. 2 - Masculino, 4 - Feminino | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_SEXO | Descrição do sexo | Carácter | “MASCULINO” e “FEMININO” | Descrição do sexo do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_GRAU_INSTRUCAO | Código do grau de instrução | Inteiro | 1 ao 8 | Código do grau de instrução do candidato conforme informado ao TSE. 1 - “ANALFABETO”, 2 - “LÊ E ESCREVE”, 3 - “ENSINO FUNDAMENTAL INCOMPLETO”, 4 - “ENSINO FUNDAMENTAL COMPLETO”, 5 - “ENSINO MÉDIO INCOMPLETO”, 6 - “ENSINO MÉDIO COMPLETO”, 7 - “SUPERIOR INCOMPLETO” e 8 - “SUPERIOR COMPLETO” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_GRAU_INSTRUCAO | Descrição do grau de instrução do candidato | Carácter | “ANALFABETO”, “LÊ E ESCREVE”, “ENSINO FUNDAMENTAL INCOMPLETO”, “ENSINO FUNDAMENTAL COMPLETO”, “ENSINO MÉDIO INCOMPLETO”, “ENSINO MÉDIO COMPLETO”, “SUPERIOR INCOMPLETO” e "SUPERIOR COMPLETO | Descrição do grau de instrução do candidato conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_ESTADO_CIVIL | Código do estado civil | Inteiro | 1, 3, 5, 7 e 9 | Código do estado civil do candidato naquele pleito, conforme informado ao TSE. 1 - “SOLTEIRO(A)”, 3 - “CASADO(A)”, 5 - “VIÚVO(A)”, 7 - “SEPARADO(A) JUDICIALMENTE” e 9 - “DIVORCIADO(A)” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ESTADO_CIVIL | Descrição do estado civil | Carácter | “SOLTEIRO(A)”, “CASADO(A)”, “VIÚVO(A)”, “SEPARADO(A) JUDICIALMENTE” e “DIVORCIADO(A)” | Descrição do estado civil do candidato naquele pleito, conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_NACIONALIDADE | Código da nacionalidade | Inteiro | 1 ao 4 | Código da nacionalidade do candidato conforme informado ao TSE. 1 - “BRASILEIRA NATA”, 2 - “BRASILEIRA NATURALIZADA”, 3 - “PORTUGUESA COM IGUALDADE DE DIREITOS” e 4 - “ESTRANGEIRO” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_NACIONALIDADE | Descrição da nacionalidade | Carácter | “BRASILEIRA NATA”, “BRASILEIRA NATURALIZADA”, “PORTUGUESA COM IGUALDADE DE DIREITOS” e “ESTRANGEIRO” | Descrição da nacionalidade do candidato conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UF_NASCIMENTO | Sigla da Unidade Federativa de nascimento | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação de nascimento do candidato, conforme informado ao TSE. ZZ - Nascimento no Exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_MUNICIPIO_NASCIMENTO | Código do município de nascimento | Inteiro | Sequência numérica | Código do município de nascimento do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_MUNICIPIO_NASCIMENTO | Nome do município de nascimento | Carácter | Texto exemplo “Manaus” | Nome do município de nascimento do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESPESA_MAX_CAMPANHA | Despesa máxima na campanha | Inteiro | 0 e -1 | Despesa máxima da campanha | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_SIT_TOT_TURNO | Código situação total do turno | Inteiro | De 1998-2010: 1,2,3,4,5,7,8,9 e 11 A partir de 2014: 1,2,3,4, 5, 6 e -1 | Código da situação total do turno. Eleições majoritárias: 1- “ELEITO”, 4 - “NÃO ELEITO” e 6 - “2º TURNO” Eleições proporcionais de 1998-2010: 1 - “ELEITO”, 2 - “SUPLENTE”, 3 - “RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES ANTES DA ELEIÇÃO”, 4 - “NÃO ELEITO”, 5 - ELEITO POR MÉDIA“, 7 -”RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES APÓS A ELEIÇÃO “, 8 -”REGISTRO NEGADO ANTES DA ELEIÇÃO“, 9 -”REGISTRO NEGADO APÓS A ELEIÇÃO" e 11 - “INDEFERIDO COM RECURSO” Eleições proporcionais a partir de 2014: -1 “#NULO#, 3 -”ELEITO POR MÉDIA“, 2 -”ELEITO POR QP“, 4 -”NÃO ELEITO“, 5 -”SUPLENTE" | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESC_SIT_TOT_TURNO | Descrição situação total do turno | Carácter |
Eleições majoritárias: “ELEITO”, “NÃO ELEITO”, “2º TURNO”. Eleições proporcionais de 1998-2010: “ELEITO”, “SUPLENTE”, “RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES ANTES DA ELEIÇÃO”, “NÃO ELEITO”, " ELEITO POR MÉDIA“,”RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES APÓS A ELEIÇÃO “,”REGISTRO NEGADO ANTES DA ELEIÇÃO“,”REGISTRO NEGADO APÓS A ELEIÇÃO" e “INDEFERIDO COM RECURSO” Eleições proporcionais a partir de 2014: “#NULO#,”ELEITO POR MÉDIA“,”ELEITO POR QP“,”NÃO ELEITO“,”SUPLENTE" |
Descrição da situação total do turno. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Consolidado das eleições
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| ANO_ELEICAO | Ano Eleição | Inteiro | 1998, 2000, 2002, 2004, 2006, 2008, 2010, 2012, 2014, 2016, 2018 | Indica o ano em que ocorreu o pleito. Eleições municipais iniciam em 2000 e têm recorrência cada 4 anos. Eleições gerais iniciam em 1998 e têm recorrência cada 4 anos. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TURNO | Número do turno | Inteiro | 1 e 2 | Indica o turno eleitoral. Eleições majoritárias podem ter até 2 turnos 1 - primeiro turno; 2 - segundo turno | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ELEICAO | Descrição da eleição | Carácter | Texto exemplo “ELEIÇÃO GERAL FEDERAL 2018” | Descreve tipo, nível e ano da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_ZONA | Número da zona | Inteiro | Sequência numérica | Número da zona na qual ocorreu a votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_SECAO | Número da seção | Inteiro | Sequência numérica | Número da seção na qual ocorreu a votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_MESO | Código meso | Inteiro | Sequência numérica | Código da mesorregião utilizada pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MESO | Nome meso | Carácter | Texto exemplo “Vale do Acre” | Nome da mesorregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MICRO | Código micro | Inteiro | Sequência numérica | Código da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MICRO | Nome micro | Carácter | Texto exemplo “Rio Branco” | Nome da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| UF | Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação ZZ - Votação no Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_UF | Nome da Unidade Federativa | Carácter | “Acre”, “Alagoas”, “Amazonas”, “Bahia”, “Ceará”, “Destrito Federal”, “Espírito Santo”, “Goiás”, “Maranhão”, Minas Gerais, “Mato Grosso”, “Mato Grosso do Sul”, “Pará”, “Paraíba”, “Pernambuco”, “Piauí”, “Paraná”, “Rio de Janeiro”, “Rio Grande do Norte”, “Rondônia”, “Roraima”, “Rio Grande do Sul”, “Santa Catarina”, “Sergipe”, “São Paulo”, “Tocantins”, “Exterior” | Nome da Unidade Federativa | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MACRO | Código macro | Inteiro | 1, 2, 3, 4, 5, 99 | Macrorregiões confor me classificação IBGE 1 - Norte, 2 - Nordeste, 3 - Sudeste, 4 - Sul 5 - Centro-Oeste e 99 - Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MACRO | Nome macro | Carácter | “Norte”, “Nordeste”, “Centro-Oeste”, “Sudeste”, “Sul” e “Exterior” | Nome da macrorregião conforme classificação do IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| COD_MUN_TSE | Código município TSE | Inteiro | Sequência numérica | Código do município utilizado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_MUN_IBGE | Código município IBGE | Inteiro | Sequência numérica | Código do município utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MUNICIPIO | Nome do município | Carácter | Texto exemplo “Acrelândia” | Nome do município onde ocorreu a eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_CARGO | Código do cargo | Inteiro | 1, 3, 5, 6, 7, 11 e 13 | Código do cargo disputado utilizado pelo TSE 1 - Presidente; 3 - Governador 5 - Senador; 6 - Deputado Federal; 7 - Deputado Estadual; 11 - Prefeito 13 - Vereador | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_CARGO | Descrição do cargo | Carácter | “PRESIDENTE” “GOVERNADOR” “SENADOR” “DEPUTADO FEDERAL” “DEPUTADO ESTADUAL” “PREFEITO” “VEREADOR” | Descrição do cargo disputado utilizada pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QTD_APTOS | Quantidade de aptos | Inteiro | Número >0 | Número de eleitores aptos a votar no dia da eleição, registrado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QTD_COMPARECIMENTO | Quantidade de comparecimento | Inteiro | Número >=0 | Número de eleitores que compareceram ao local de votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QTD_ABSTENCOES | Quantidade de abstenções | Inteiro | Número >=0 | Número de eleitores que não compareceram ao local de votação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QT_VOTOS_NOMINAIS | Quantidade de votos nominais | Inteiro | Número >=0 | Total de votos em um candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QT_VOTOS_BRANCOS | Quantidade de votos em branco | Inteiro | Número >=0 | Total de votos em branco | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QT_VOTOS_NULOS | Quantidade de votos nulos | Inteiro | Número >=0 | Total de votos anulados pelos eleitores | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QT_VOTOS_LEGENDA | Quantidade de votos em legenda | Inteiro | Número >=0 | Total de votos em legenda | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QT_VOTOS_ANULADOS_APU_SEP | Quantidade de votos anulados | Inteiro | Número >=0 | Total de votos anulados após a eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Resumo das eleições por cargo
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| DATA_GERACAO | Data da geração | Carácter | Texto exemplo “25/03/2017” | Data em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| HORA_GERACAO | Hora da geração | Carácter | Texto exemplo “19:14:24” | Hora em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| ANO_ELEICAO | Ano Eleição | Inteiro | 1998, 2000, 2002, 2004, 2006, 2008, 2010, 2012, 2014, 2016, 2018 | Indica o ano em que ocorreu o pleito. Eleições municipais iniciam em 2000 e têm recorrência cada 4 anos. Eleições gerais iniciam em 1998 e têm recorrência cada 4 anos. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TURNO | Número do turno | Inteiro | 1 e 2 | Indica o turno eleitoral. Eleições majoritárias podem ter até 2 turnos 1 - primeiro turno; 2 - segundo turno | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ELEICAO | Descrição da eleição | Carácter | Texto exemplo “ELEIÇÃO GERAL FEDERAL 2018” | Descreve tipo, nível e ano da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_CARGO | Código do cargo | Inteiro | 1, 3, 5, 6, 7, 11 e 13 | Código do cargo disputado utilizado pelo TSE 1 - Presidente; 3 - Governador 5 - Senador; 6 - Deputado Federal; 7 - Deputado Estadual; 11 - Prefeito 13 - Vereador | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_CARGO | Descrição do cargo | Carácter | “PRESIDENTE”, “GOVERNADOR” “SENADOR”, “DEPUTADO FEDERAL”, “DEPUTADO ESTADUAL”, “PREFEITO”, “VEREADOR” | Descrição do cargo disputado utilizada pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_CANDIDATO | Nome do candidato | Carácter | Texto exemplo “JOÃO DA SILVA” | Nome de registro do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_CANDIDATO | Número do candidato | Inteiro | Sequência numérica | Número votável do candidato conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CPF_CANDIDATO | Código de Pessoa Física do candidato | Inteiro | Sequência numérica | CPF do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_URNA_CANDIDATO | Nome de urna do candidato | Carácter | Texto exemplo “JOÃOZINHO” | Nome do canidato conforme aparece na urna | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_SITUACAO_CANDIDATURA | Código de situação da candidatura | Inteiro | Em 1998: 2, 4, 3, 5, 10, 7, 8, 9 e 6 Em 2002: 2, 4, 14, 5, 10, 7, 13 e 6 A partir de 2006: 2, 16, 4, 14, 5, 10, 7, 13 e 6 | Código de situação da candidatura utilizado pelo TSE. Alguns códigos apesar de permanecerem com o mesmo número têm significados diferentes. Em 1998: 2 - “DEFERIDO”, 4 - “SUB-JÚDICE”, 3 - “INDEFERIDO”, 5 - “CANCELAMENTO DO PEDIDO”, 10 - “CASSADO”, 7 - “FALECIDO”, 8 - “HOMOLOGAÇÃO DE DESISTÊNCIA”, 9 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” Em 2002: 2 - “DEFERIDO”, 4 - “SUB JUDICE”, 14 - “INDEFERIDO”, 5 - “CANCELADO”, 10 - “CASSADO”, 7 - “FALECIMENTO”, 13 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” A partir de 2006: 2 - “DEFERIDO”, 16 - “DEFERIDO COM RECURSO”, 4 - “INDEFERIDO COM RECURSO”, 5 - “CANCELADO”, 10 - “CASSADO”, 7 - “FALECIDO”, 13 - “NÃO CONHECIMENTO DO PEDIDO” e 6 - “RENÚNCIA” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DES_SITUACAO_CANDIDATURA | Descrição da situação da candidatura | Carácter | Em 1998: “DEFERIDO”, “SUB-JÚDICE”, “INDEFERIDO”, “CANCELAMENTO DO PEDIDO”, “CASSADO”, “FALECIDO”, “HOMOLOGAÇÃO DE DESISTÊNCIA”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” Em 2002: “DEFERIDO”, “SUB JUDICE”, “INDEFERIDO”, “CANCELADO”, “CASSADO”, “FALECIMENTO”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” A partir de 2006: “DEFERIDO”, “DEFERIDO COM RECURSO”, “INDEFERIDO COM RECURSO”, “CANCELADO”, “CASSADO”, “FALECIDO”, “NÃO CONHECIMENTO DO PEDIDO” e “RENÚNCIA” | Descrição da situação da candidatura utilizado pelo TSE. Algumas descrições apesar de terem o mesmo significado são escritas de forma diferente. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_PARTIDO | Número do partido | Inteiro | Sequência numérica | Número do partido homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_PARTIDO | Sigla do partido | Carácter | Texto exemplo “PRB” | Sigla do partido homologada no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_PARTIDO | Nome do partido | Carácter | Texto exemplo “Partido Republicano Brasileiro” | Nome do partido homolagado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_LEGENDA | Código da legenda | Inteiro | Sequência numérica | Código da legenda conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_LEGENDA | Sigla da legenda | Carácter | #NULO# | Sigla da legenda pela qual o candidato concorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COMPOSICAO_LEGENDA | Composição da legenda | Carácter | Texto exemplo “PSDB / PTB / PP / PR / DEM / SOLIDARIEDADE / PPS / PRB / PSD” | Partidos que compõem a legenda conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_COLIGACAO | Nome da coligação | Carácter | Texto exemplo “UNIDOS POR BUJARI” | Nome da coligação homologada no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_OCUPACAO | Código da ocupação | Inteiro | Sequência numérica | Código referente ao tipo de ocupação do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_OCUPACAO | Descrição da ocupação | Carácter | Texto exemplo “Agricultor” | Descrição do tipo de ocupação do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_NASCIMENTO | Data de nascimento | Carácter | Texto exemplo “29/06/1982” | Data de nascimento do candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_TITULO_ELEITORAL_CANDIDATO | Número do título eleitoral do candidato | Carácter | Sequência numérica | Título eleitoral do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| IDADE_DATA_ELEICAO | Idade na data da eleição | Inteiro | Número >18 | Idade do candidato na data da eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_SEXO | Código do sexo | Inteiro | 2 e 4 | Código do sexo do candidato conforme informado ao TSE. 2 - Masculino, 4 - Feminino | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_SEXO | Descrição do sexo | Carácter | “MASCULINO” e “FEMININO” | Descrição do sexo do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_GRAU_INSTRUCAO | Código do grau de instrução | Inteiro | 1 ao 8 | Código do grau de instrução do candidato conforme informado ao TSE. 1 - “ANALFABETO”, 2 - “LÊ E ESCREVE”, 3 - “ENSINO FUNDAMENTAL INCOMPLETO”, 4 - “ENSINO FUNDAMENTAL COMPLETO”, 5 - “ENSINO MÉDIO INCOMPLETO”, 6 - “ENSINO MÉDIO COMPLETO”, 7 - “SUPERIOR INCOMPLETO” e 8 - “SUPERIOR COMPLETO” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_GRAU_INSTRUCAO | Descrição do grau de instrução do candidato | Carácter | “ANALFABETO”, “LÊ E ESCREVE”, “ENSINO FUNDAMENTAL INCOMPLETO”, “ENSINO FUNDAMENTAL COMPLETO”, “ENSINO MÉDIO INCOMPLETO”, “ENSINO MÉDIO COMPLETO”, “SUPERIOR INCOMPLETO” e "SUPERIOR COMPLETO | Descrição do grau de instrução do candidato conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_ESTADO_CIVIL | Código do estado civil | Inteiro | 1, 3, 5, 7 e 9 | Código do estado civil do candidato naquele pleito, conforme informado ao TSE. 1 - “SOLTEIRO(A)”, 3 - “CASADO(A)”, 5 - “VIÚVO(A)”, 7 - “SEPARADO(A) JUDICIALMENTE” e 9 - “DIVORCIADO(A)” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_ESTADO_CIVIL | Descrição do estado civil | Carácter | “SOLTEIRO(A)”, “CASADO(A)”, “VIÚVO(A)”, “SEPARADO(A) JUDICIALMENTE” e “DIVORCIADO(A)” | Descrição do estado civil do candidato naquele pleito, conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_NACIONALIDADE | Código da nacionalidade | Inteiro | 1 ao 4 | Código da nacionalidade do candidato conforme informado ao TSE. 1 - “BRASILEIRA NATA”, 2 - “BRASILEIRA NATURALIZADA”, 3 - “PORTUGUESA COM IGUALDADE DE DIREITOS” e 4 - “ESTRANGEIRO” | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESCRICAO_NACIONALIDADE | Descrição da nacionalidade | Carácter | “BRASILEIRA NATA”, “BRASILEIRA NATURALIZADA”, “PORTUGUESA COM IGUALDADE DE DIREITOS” e “ESTRANGEIRO” | Descrição da nacionalidade do candidato conforme informado ao TSE. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UF_NASCIMENTO | Sigla da Unidade Federativa de nascimento | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação de nascimento do candidato, conforme informado ao TSE. ZZ - Nascimento no Exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_MUNICIPIO_NASCIMENTO | Código do município de nascimento | Inteiro | Sequência numérica | Código do município de nascimento do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_MUNICIPIO_NASCIMENTO | Nome do município de nascimento | Carácter | Texto exemplo “Manaus” | Nome do município de nascimento do candidato conforme informado ao TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESPESA_MAX_CAMPANHA | Despesa máxima na campanha | Inteiro | 0 e -1 | Despesa máxima da campanha | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_SIT_TOT_TURNO | Código situação total do turno | Inteiro | De 1998-2010: 1,2,3,4,5,7,8,9 e 11 A partir de 2014: 1,2,3,4, 5, 6 e -1 | Código da situação total do turno. Eleições majoritárias: 1- “ELEITO”, 4 - “NÃO ELEITO” e 6 - “2º TURNO” Eleições proporcionais de 1998-2010: 1 - “ELEITO”, 2 - “SUPLENTE”, 3 - “RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES ANTES DA ELEIÇÃO”, 4 - “NÃO ELEITO”, 5 - ELEITO POR MÉDIA“, 7 -”RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES APÓS A ELEIÇÃO “, 8 -”REGISTRO NEGADO ANTES DA ELEIÇÃO“, 9 -”REGISTRO NEGADO APÓS A ELEIÇÃO" e 11 - “INDEFERIDO COM RECURSO” Eleições proporcionais a partir de 2014: -1 “#NULO#, 3 -”ELEITO POR MÉDIA“, 2 -”ELEITO POR QP“, 4 -”NÃO ELEITO“, 5 -”SUPLENTE" | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DESC_SIT_TOT_TURNO | Descrição situação total do turno | Carácter |
Eleições majoritárias: “ELEITO”, “NÃO ELEITO”, “2º TURNO”. Eleições proporcionais de 1998-2010: “ELEITO”, “SUPLENTE”, “RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES ANTES DA ELEIÇÃO”, “NÃO ELEITO”, " ELEITO POR MÉDIA“,”RENÚNCIA/ FALECIMENTO/CASSAÇÃO ANTES APÓS A ELEIÇÃO “,”REGISTRO NEGADO ANTES DA ELEIÇÃO“,”REGISTRO NEGADO APÓS A ELEIÇÃO" e “INDEFERIDO COM RECURSO” Eleições proporcionais a partir de 2014: “#NULO#,”ELEITO POR MÉDIA“,”ELEITO POR QP“,”NÃO ELEITO“,”SUPLENTE" |
Descrição da situação total do turno. | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| TIPO_LEGENDA | Tipo da legenda | Carácter | “COLIGACAO”, “PARTIDO ISOLADO” | Informa se o candidato concorreu por coligação ou partido isolado | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_COLIGACAO | Sigla da coligação | Carácter | #NE | Sigla da legenda pela qual o candidato concorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_COLIGACAO | Nome da coligação | Carácter | #NULO# | Nome da coligação homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COMPOSICAO_COLIGACAO | Composição da coligação | Carácter | Texto exemplo “PSDB / PTB / PP / PR / DEM / SOLIDARIEDADE / PPS / PRB / PSD” | Partidos que compõem a coligação conforme homologado no TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| QTDE_VOTOS | Quantidade de votos | Inteiro | Número > 0 | Total de votos recebidos pelo candidato | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| CODIGO_MESO | Código meso | Inteiro | Sequência numérica | Código da mesorregião utilizada pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MESO | Nome meso | Carácter | Texto exemplo “Vale do Acre” | Nome da mesorregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MICRO | Código micro | Inteiro | Sequência numérica | Código da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MICRO | Nome micro | Carácter | Texto exemplo “Rio Branco” | Nome da microrregião utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| UF | Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO”, “ZZ” | Sigla da Unidade da Federação ZZ - Votação no Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_UF | Nome da Unidade Federativa | Carácter | “Acre”, “Alagoas”, “Amazonas”, “Bahia”, “Ceará”, “Destrito Federal”, “Espírito Santo”, “Goiás”, “Maranhão”, Minas Gerais, “Mato Grosso”, “Mato Grosso do Sul”, “Pará”, “Paraíba”, “Pernambuco”, “Piauí”, “Paraná”, “Rio de Janeiro”, “Rio Grande do Norte”, “Rondônia”, “Roraima”, “Rio Grande do Sul”, “Santa Catarina”, “Sergipe”, “São Paulo”, “Tocantins”, “Exterior” | Nome da Unidade Federativa | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| CODIGO_MACRO | Código macro | Inteiro | 1, 2, 3, 4, 5, 99 | Macrorregiões confor me classificação IBGE 1 - Norte, 2 - Nordeste, 3 - Sudeste, 4 - Sul 5 - Centro-Oeste e 99 - Exterior | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MACRO | Nome macro | Carácter | “Norte”, “Nordeste”, “Centro-Oeste”, “Sudeste”, “Sul” e “Exterior” | Nome da macrorregião conforme classificação do IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| COD_MUN_TSE | Código município TSE | Inteiro | Sequência numérica | Código do município utilizado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| COD_MUN_IBGE | Código município IBGE | Inteiro | Sequência numérica | Código do município utilizado pelo IBGE | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| NOME_MUNICIPIO | Nome do município | Carácter | Texto exemplo “Acrelândia” | Nome do município onde ocorreu a eleição | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_UE | Sigla da Unidade Estadual | Carácter / Inteiro | Código do município do TSE Sigla da UF BR VT ZZ | Sigla da Unidade Eleitoral (Em caso de eleição majoritária é a sigla da UF que o candidato concorre (texto) e em caso de eleição municipal é o código TSE do município (número). Para eleições nacionais, também se aplicam: BR - Quando se trata de informação a nível nacional; VT - Quando se trata de voto em trânsito; ZZ - Quando se trata de voto no exterior | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Filiados
| Variável | Nome da variável | Tipo | Valores | Descrição | Fonte |
|---|---|---|---|---|---|
| DATA_EXTRACAO | Data da extração | Carácter | Texto exemplo “25/03/2017” | Data em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| HORA_EXTRACAO | Hora da extração | Carácter | Texto exemplo “19:14:24” | Hora em que o arquivo foi gerado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUMERO_INSCRICAO | Número de Inscrição | Carácter | Sequencial numérico | Número de inscrição do filiado | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_FILIADO | Nome do filiado | Carácter | Texto exemplo “JOÃO DA SILVA” | Nome de registro do filiado | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SIGLA_PARTIDO | Sigla do partido | Carácter | Texto exemplo “PSDB” | Sigla do partido de filiação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_PARTIDO | Nome do partido | Carácter | Texto exemplo “Partido da Social Democracia Brasileira” | Nome do partido de filiação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| UF | Unidade Federativa | Carácter | “AC”, “AL”, “AM”, “AP”, “BA”, “CE”, “DF”, “ES”, “GO”, “MA”, “MG”, “MS”, “MT”, “PA”, “PB”, “PE”, “PI”, “PR”, “RJ”, “RN”, “RO”, “RR”, “RS”, “SC”, “SE”, “SP”, “TO” | Sigla da Unidade da Federação | Instituto Brasileiro de Geografia e Estatística (IBGE) |
| COD_MUN_TSE | Código município TSE | Inteiro | Sequência numérica | Código do município utilizado pelo TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NOME_MUNICIPIO | Nome do município | Carácter | Texto exemplo “Acrelândia” | Nome do município de filiação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_ZONA | Número da zona | Inteiro | Sequência numérica | Número da zona na qual o filiado vota | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| NUM_SECAO | Número da seção | Inteiro | Sequência numérica | Número da seção na qual o filiado vota | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_FILIACAO | Data da filiação | Carácter | Texto exemplo “02/04/2005” | Data na qual a filiação ocorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| SITUACAO_REGISTRO | Situação do registro | Carácter | “CANCELADO”, “DESFILIADO”, “REGULAR” e “SUB JUDICE” | Situação do registro de filiação segundo a última atualização do TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| TIPO_REGISTRO | Tipo do registro | Carácter | “OFICIAL” | Tipo do registro | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_PROCESSAMENTO | Data do processamento | Carácter | Texto exemplo “04/10/2017” | Data de atualização do TSE | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_DESFILIACAO | Data da desfiliação | Carácter | Texto exemplo “04/10/2017” | Data na qual a desfiliação ocorreu | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_CANCELAMENTO | Data de cancelamento | Carácter | Texto exemplo “04/10/2017” | Data na qual a filiação foi cancelada | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| DATA_REGULARIZACAO | Data regularização | Carácter | Texto exemplo “04/10/2017” | Data na qual a filiação foi regularizada | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
| MOTIVO_CANCELAMENTO | Motivo do cancelamento | Carácter | “A pedido do eleitor”, “A pedido do partido”, “Cancelamento automático” e “Judicial” | Motivo do cancelamento da filiação | Repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE) |
Nossas APIs - Tutoriais
O cepespR, assim como as versões Python e REST, são pacotes criados para auxiliar o acesso dos usuários via API ao CepespData. Por meio dessa ferramenta, é possível realizar requisições de maneira mais rápida e estruturada aos dados eleitorais presentes no nosso repositório.
Abaixo, é possível consultar nossos tutoriais que auxiliam no uso dessas ferramentas.
Tabelas Auxiliares - Downloads
Abaixo é possível conferir os documentos auxiliares à consulta e à replicação dos testes de consistência e de montagem dos bancos de dados do CepespData.
Agradecimentos e Citações
Desenvolvido com apoio da Rede de Pesquisa e Conhecimento Aplicado da FGV, da FAPESP ao projeto “As Instituições Políticas Subnacionais: Um Estudo Comparativo dos Estados Brasileiros” (processo: 2013/15658-1) e do Tribunal Superior Eleitoral - TSE.
O projeto do CepespData é coordenado pelo professor Dr. George Avelino Filho. O CepespData é um projeto do Centro de Política e Economia do Setor Público (CEPESP), um centro de pesquisa da Fundação Getulio Vargas (FGV) liderado pelos professores Dr. George Avelino Filho e Dr. Ciro Biderman. O projeto contou com a contribuição de:
- Abraão Lacerda
- Arthur Fisch
- Ciro Biderman
- Eliana Lins Morandi
- Frederico Ramos
- Gabriela Campos
- Gabriel Caseiro
- Gabriel Goldfajn
- Guilherme Russo
- Henrique Hott
- Jairo Pimentel
- Jonathan Phillips
- Lara Mesquita
- Luiz Gabriel
- Maria Letícia Claro
- Marina Merlo
- Mauricio Izumi
- Natália Salgado Bueno
- Rafael Coelho
- Rebeca Carvalho
- Wesley Seidel
- William Colen
Para citar o banco de dados do CespepData, utilize o seguinte modelo:
FGV CEPESP (2020). CepespData - Banco de Dados Políticos. Visitado em XX/XX/XXX. Disponível em http://cepespdata.io