Voltar ao índiceInício30 de mar. de 20264 min

Como começar no mapa semântico

Um guia curto para selecionar países, ler agrupamentos de pontos e entender o que a proximidade semântica significa na prática.

Abrir atlas Seleção de países e visualização do mapa semântico Playlist oficial de tutoriais do ConstitutionalMap AI

O que o mapa realmente mostra

Cada ponto do canvas 3D representa um artigo constitucional ou uma unidade jurídica equivalente. Pontos próximos não estão agrupados primeiro por país, mas por semelhança semântica.

Por isso vale evitar carregar tudo de uma vez. Selecione um ou dois países e observe como os artigos se distribuem no mesmo espaço semântico global.

Um primeiro fluxo que funciona

Escolha um país como âncora e adicione um segundo país para contraste. Assim o canvas continua legível e os primeiros clusters ficam mais fáceis de interpretar.

Abra o atlas no seu idioma e selecione um país no mapa.
Adicione um segundo país com tradição constitucional diferente.
Observe as regiões mais densas antes de abrir artigos.
Troque o modo de cor entre países e clusters globais.

Como ler a visualização

O Que Você Está Vendo

Cada ponto na vista 3D representa um artigo constitucional ou outra unidade jurídica relevante. Pontos próximos não estão juntos por serem do mesmo país, mas porque a linguagem desses trechos é semanticamente parecida. Use a seleção de países para comparar como diferentes constituições ocupam o mesmo terreno semântico.

O mapa e a lista de países são ferramentas de seleção. Eles decidem quais constituições entram na cena. Selecionar mais países não altera a geometria do embedding; altera quais partes desse espaço semântico global você consegue inspecionar.

Espaço Semântico

O embedding transforma texto jurídico em vetores, e a etapa de clustering agrupa vetores que tendem a tratar de temas constitucionais relacionados. No modo país, a cor mostra a origem política. No modo cluster, a cor mostra a vizinhança temática.

Nuvens grandes e densas costumam indicar ideias constitucionais recorrentes, como direitos, instituições, poderes de emergência, eleições ou regras de emenda. Pontos isolados muitas vezes marcam dispositivos incomuns, redações raras ou escolhas constitucionais muito específicas.

A plataforma oferece dois tipos de busca: a busca sintática encontra ocorrências literais de termos, enquanto a busca semântica recupera passagens conceitualmente próximas, mesmo sem os mesmos termos. Os resultados realçam regiões do espaço semântico no canvas 3D, ligando o que se lê ao onde se situa.

Como Ler as Métricas

Nas estatísticas por país, Cobertura mede quanto da paisagem global de clusters uma constituição alcança. Entropia mede quão uniformemente seus segmentos se distribuem por essa paisagem: entropia alta sugere maior diversidade semântica, enquanto entropia baixa sugere concentração em menos temas.

No painel de detalhe do artigo, Cluster global é o identificador do grupo temático ao qual aquele artigo foi atribuído no clustering mundial. Quando o valor é -1, isso significa que o artigo ficou fora dos agrupamentos temáticos definidos nessa etapa global. Probabilidade indica quão confiantemente o modelo posicionou esse artigo nesse grupo: valores mais altos sugerem encaixe mais nítido, enquanto valores mais baixos costumam marcar casos ambíguos ou de fronteira.