trama.u
Manual Técnico & Guia do Usuário

Como Utilizar a Plataforma TRAMA

⚠️ Importante: Natureza e Limitações dos Dados O TRAMA é uma plataforma acadêmica e de diagnóstico preliminar de urbanismo. Os dados utilizados provêm do Censo Demográfico do IBGE (2022) e de bases colaborativas abertas como o OpenStreetMap (OSM). O OSM é mantido por voluntários e pode conter omissões ou imprecisões geométricas locais. O cálculo das estatísticas espaciais (LISA) é executado no navegador do usuário com base no escopo espacial ativo na tela. Sempre valide dados críticos em campo ou via órgãos cartográficos oficiais da sua municipalidade.
A plataforma **TRAMA** integra dados socioeconômicos e infraestrutura urbana a um ambiente computacional 3D em tempo real. Este manual detalha a operação do sistema, a fundamentação teórica de suas análises estatísticas avançadas e as boas práticas de simulação.

1. Navegação Tridimensional e Estrutura da Interface

A interface do TRAMA foi planejada para conciliar a leitura cartográfica técnica bidimensional tradicional com a percepção volumétrica de dados tridimensionais (como altimetria, gabarito edilício e insolação).

Navegação Espacial no Mapa

Os controles de visualização dependem dos periféricos de entrada (mouse/teclado):

Disposição dos Painéis de Controle

O ecossistema visual da plataforma é subdividido em quatro zonas principais:

2. Indicadores Socioeconômicos e do Entorno Censitário (Censo 2022)

O TRAMA carrega de forma reativa os dados estatísticos por setor censitário do Censo 2022 de Minas Gerais, utilizando infraestrutura de tiles vetoriais eficientes hospedados na nuvem.

Renda Média dos Responsáveis

A variável Renda Média (`v06004`) apresenta a média nominal de renda dos responsáveis de cada setor censitário. É a variável chave para a leitura socioeconômica e diagnóstico de segregação territorial nas cidades.

Proporções do Entorno Censitário (%)

Durante a pesquisa de campo do Censo, os recenseadores avaliam a infraestrutura das faces de quadra onde os domicílios estão localizados. A plataforma converte esses valores em percentuais relativos de faces dotadas de infraestrutura básica:

Quebras de Escala e Classificação

Você pode definir como as faixas de cores do mapa são calculadas no painel inferior (IBGE Censo):

Calculadora IBGE / Fórmulas Customizadas

Selecione a opção "Fórmula / Criar Indicador" no painel. A calculadora aceita operações algébricas básicas utilizando variáveis nativas do Censo. Por exemplo, você pode cruzar a população total e domicílios para criar indicadores inéditos e plotá-los imediatamente na coropleta do mapa.

3. Indicadores de Diversidade e Autocorrelação Espacial Local (LISA)

Este módulo apresenta a leitura estatística de diversidade interna e autocorrelação local espacial. Ele permite identificar tendências, desigualdades invisíveis de renda e zonas homogêneas segregadas.

Índices de Representatividade e Diversidade Urbana (Simpson)

Em vez de calcular a diversidade interna absoluta de um setor (o que classificaria um bairro composto de forma uniforme e equilibrada como "diverso", mesmo que seu perfil seja atípico na cidade), a plataforma TRAMA utiliza o **Índice de Representatividade Urbana**. Este índice compara a composição do setor com a composição média geral de todo o município ativo (que atua como referência de totalidade regional).

S = 1 - 0.5 * Σ | p_i - P_i |

Onde p_i é a proporção da categoria no setor e P_i é a proporção global da mesma categoria no município.

O resultado varia estritamente no intervalo de 0% (segregação total, setor composto por minorias/maiorias não integradas) a 100% (representação idêntica da distribuição proporcional da cidade). A plataforma plota cinco indicadores baseados nessa formulação:

Autocorrelação Espacial Local (Anselin Local Moran's I)

O método **LISA (Local Indicators of Spatial Association)** identifica agrupamentos espaciais estatisticamente significativos (clusters) e anomalias de dados (outliers) no território do município visível na tela.

O algoritmo utiliza uma matriz de pesos baseada em **K=8 Vizinhos Mais Próximos (KNN)** com padronização por linha para calcular a média de vizinhança (Spatial Lag). A significância estatística (pseudo p-valor) é avaliada em tempo real através do **Método de Permutações de Monte Carlo com 999 iterações aleatórias**. Somente setores com p < 0.05 são classificados e coloridos na tela.

Categoria LISA Sigla Valor do Setor Média dos Vizinhos Significado Urbano Cor no Mapa
Alto-Alto HH Acima da média Acima da média Hotspot. Zonas de alta concentração (ex: infraestrutura densa ou riqueza agregada). Vermelho (#b91c1c)
Baixo-Baixo LL Abaixo da média Abaixo da média Coldspot. Zonas de baixa concentração (ex: carência de serviços ou baixa densidade). Azul (#1d4ed8)
Alto-Baixo HL Acima da média Abaixo da média Outlier Espacial. Equipamento ou setor de renda alta isolado em área de baixa renda. Vermelho Claro (#f87171)
Baixo-Alto LH Abaixo da média Acima da média Outlier Espacial. Bolsão de vulnerabilidade física/social cercado por bairros consolidados. Azul Claro (#60a5fa)
Não Significativo NS Qualquer Qualquer Variações locais dentro dos padrões normais de aleatoriedade espacial. Cinza Translúcido

4. Usando Desenhos como Recortes de Análise

Uma das funcionalidades mais poderosas do TRAMA é o recorte geométrico dinâmico de dados.

Passo a Passo para Recorte de Análise

  1. Na barra flutuante inferior, clique em Desenhar e selecione o tipo de geometria desejado (Polígono ou Círculo).
  2. Desenhe a área que deseja estudar no mapa (clicando nos pontos para polígonos ou arrastando o raio para círculos). Clique duas vezes ou conecte ao ponto de origem para finalizar.
  3. Abra o Gerenciador de Camadas na barra superior (atalho à direita). O desenho feito estará listado.
  4. Clique no ícone de "Área de Recorte" (ícone de tesoura/máscara geométrico à esquerda do nome do desenho).
  5. Pronto! A partir desse momento, qualquer camada temática do Censo IBGE ou do Mapa de Calor de Proximidade carregada passará a obedecer estritamente os limites da sua área de desenho, recalculando as estatísticas apenas para a zona selecionada.

5. Motor 3D, Topografia e Análise de Sombras (Insolação)

O ambiente tridimensional simula condições topográficas e construtivas reais com precisão.

Relevo e Altimetria

Selecione a camada de Topografia no menu. O TRAMA extrai curvas de nível reais e renderiza a malha do terreno em 3D. Na barra flutuante de topografia, você pode ajustar o "Exagero Vertical" para melhor analisar barreiras topográficas e declividades urbanas acentuadas em áreas serranas ou vales.

Simulação Solar e Conforto Térmico

Ao ativar o modo 3D com edifícios ou relevo, clique no menu superior Estilos ➔ Insolação Dinâmica. A plataforma calcula o azimute e elevação solar exatos para o local no dia e na hora selecionados. Deslize o controle de horas do dia para observar o deslocamento da projeção de sombras em tempo real, útil para diagnosticar o sombreamento indesejado sobre lotes ou o aproveitamento de luz natural.

6. Controle de Opacidade e Exportação Técnica

O TRAMA inclui ferramentas para manipulação de visualização e geração de relatórios de alta qualidade.

Ajuste da Opacidade das Camadas

A opacidade padrão dos setores censitários é de **60%**, permitindo visualizar a base cartográfica e vias públicas por baixo da coloração temática. Se a leitura de cores estiver difícil ou se quiser realçar os dados:

Exportação de Pranchas e Mapas

Acesse o botão **Exportar** na barra superior para gerar capturas técnicas em alta resolução. O motor de exportação do TRAMA gera arquivos contendo uma escala gráfica tipo régua métrica dinâmica calibrada com o nível de zoom, marca d'água oficial e citação automática da fonte de dados no rodapé do documento gerado (PNG ou PDF).

7. Perguntas Frequentes (FAQ)

Por que a análise de Autocorrelação (LISA) demora alguns segundos para carregar?

Diferente de sistemas GIS que pré-calculam dados no servidor, o TRAMA calcula a autocorrelação espacial local em tempo real no navegador do usuário (Client-Side). Para cada setor censitário visível no município selecionado, o algoritmo executa 999 permutações de Monte Carlo. Em municípios grandes com mais de 3.000 setores (como Belo Horizonte), isso representa quase 3 milhões de iterações de vizinhança. Embora otimizado com arrays tipados e loops estruturados, o processamento pode levar de 2 a 5 segundos dependendo do processador do seu computador.

O que é o "Efeito de Borda" (MAUP) citado na análise espacial?

O MAUP (Modifiable Areal Unit Problem) e o efeito de borda ocorrem porque a análise espacial é delimitada pelos limites geográficos do município selecionado. Setores censitários localizados nas divisas municipais têm vizinhos físicos em outras cidades, mas esses vizinhos externos são ignorados temporariamente no cálculo de vizinhança K=8 para isolar as dinâmicas estatísticas específicas da cidade ativa. Isso pode gerar pequenas distorções de significância estritamente em áreas limítrofes.

Por que alguns setores aparecem como cinza e sem dados em mapas de renda?

O IBGE omite dados de renda e de algumas variáveis demográficas em setores censitários onde a população residente ou o número de domicílios é extremamente reduzido (ex: setores industriais, áreas militares, parques ambientais ou quadras centrais exclusivamente comerciais). Isso é feito para proteger o sigilo estatístico e a privacidade dos moradores dessas áreas. No TRAMA, esses setores são classificados e exibidos como "Não Significativos" (NS) ou "Sem Dados" para evitar distorções estatísticas decorrentes de divisões por zero ou outliers artificiais.

Como posso retomar o trabalho de um mapa desenhado anteriormente?

Utilize as funções de **Projeto**. Clicando em Projeto ➔ Salvar Projeto, o TRAMA empacota todas as geometrias que você desenhou, a posição exata da câmera, o nível de zoom, as cores personalizadas e os recortes ativados em um arquivo de texto estruturado contendo a extensão .json. Guarde este arquivo em seu computador. Ao abrir o TRAMA in uma nova sessão, basta clicar em Projeto ➔ Carregar Projeto e carregar o arquivo para restabelecer imediatamente todo o contexto do seu diagnóstico urbano.

Qual a fonte de dados do zoneamento urbano mostrado no mapa?

As camadas de zoneamento e parâmetros de parcelamento do solo apresentadas são extraídas diretamente das geobases públicas municipais disponibilizadas pelas prefeituras sob a vigência de seus Planos Diretores de Desenvolvimento Urbano e Leis de Uso e Ocupação do Solo correspondentes.

Dúvidas teóricas ou metodológicas?
Revise as diretrizes do projeto ou retorne ao mapa interativo.
Ir para o Mapa Interativo