O GeoTSE é um plugin acadêmico e técnico desenvolvido para o QGIS 3 e QGIS 4 por Luís Eduardo Araújo de Souza, vinculado ao GeoLab (Laboratório de Geoprocessamento da FAED/UDESC). O software resolve de forma automatizada o histórico desafio metodológico de compatibilização entre os dados abertos da Justiça Eleitoral e as bases geocartográficas brasileiras.
A ferramenta soluciona a incompatibilidade estrutural entre o código municipal do TSE (5 dígitos, CD_MUNICIPIO / SG_UE) e o geocódigo oficial do IBGE (7 dígitos, CD_MUN), transformando tabelas eleitorais massivas em formato longo (milhões de linhas por seção, zona, candidato e partido) em camadas geográficas prontas para análise espacial (formato largo: 1 linha por município ou 1 ponto por local de votação).
Principais Funcionalidades da Ferramenta
- Compatibilização Universal TSE-IBGE: Dicionário oficial embutido convertendo automaticamente os 5.571 códigos municipais da Justiça Eleitoral para os geocódigos padrão IBGE de 7 dígitos.
- Suporte a Todos os Dados Abertos do TSE: Processamento direto de arquivos
.csv,.txte.zipde votação nominal por seção/zona, detalhe da apuração, perfil do eleitorado, locais de votação, candidaturas e prestação de contas. - Espacialização em Dois Níveis: Nível Municipal (com download automático da malha vetorial do IBGE via API v3 ou junção 1:1) e Nível Intraurbano/Local (pontos exatos de locais de votação e colégios eleitorais via CDN do TSE com leitura rápida por HTTP Range).
- Rigor Metodológico em Eleições Proporcionais: Separação automática de votos nominais e votos de legenda (2 dígitos), agrupamento partidário e consolidação de federações em disputas para Deputado e Vereador.
- Estilização Cartográfica Automatizada: Aplicação instantânea de três modalidades de simbologia: Vencedor Graduado por Margem de Vitória (Data-Defined Color), Vencedor por Cor Oficial Partidária e Graduado por Percentual de Votos.
- Organização Automatizada no QGIS: Estruturação das camadas em grupos temáticos organizados por Cargo, Turno e Circunscrição Eleitoral.
Como Citar o GeoTSE
Ao utilizar o GeoTSE em pesquisas, monografias, dissertações, teses acadêmicas, análises de geografia eleitoral ou coberturas jornalísticas orientadas a dados, por favor cite a ferramenta:
@software{souza_geotse_2026,
author = {Souza, Lu{\'i}s Eduardo Ara{\'u}jo de},
title = {{GeoTSE: Espacializador Eleitoral para QGIS}},
version = {1.0.1},
year = {2026},
publisher = {GeoLab -- Laborat{\'o}rio de Geoprocessamento, FAED/UDESC},
address = {Florian{\'o}polis, SC, Brasil},
url = {https://geolab.faed.udesc.br/index.php/ferramentas/plugins/geotse-espacializador-eleitoral},
note = {Plugin oficial para QGIS 3 e QGIS 4}
}
Acesso ao Plugin e Código-Fonte
O GeoTSE está disponível publicamente no repositório oficial de complementos do QGIS e no GitHub.
```