.. _anatem13-geoespacial:
.. only:: html
.. image:: /img/anatem_13.png
:alt: Anatem 13
******************
Visão Geoespacial
******************
.. only:: latex
.. image:: /img/anatem_13.png
:alt: Anatem 13
:width: 100%
A **Visão Geoespacial** é uma das visões da aba de Análise. Ela associa a rede
elétrica a um arquivo geográfico do caso. Em `EXSI`, permite localizar
excursões, diferenças temporais e eventos. Em `EAMI` e `EAIF`, projeta no mapa
os índices fora da diagonal relativos a uma barra focal.
O mapa apresenta os resultados já calculados e permite relacioná-los à posição
e à topologia dos elementos do caso.
Arquivo GEO
===========
A associação preferencial é feita no `DARQ` com o tipo `GEO`:
.. code-block:: text
DARQ
GEO exemplo.geo.json
999999
O caminho relativo é resolvido a partir do STB principal. Na ausência de um
arquivo `GEO` do caso, o Anatem oferece uma base própria construída para o SIN
de referência. O usuário escolhe se deseja utilizá-la.
Essa base pode não representar a rede, a configuração ou a época do estudo
aberto. Use-a como apoio visual e confira sua cobertura antes de interpretar o
mapa.
Se nenhuma base geográfica for carregada, somente a Visão Geoespacial fica
indisponível. Overview, Relatório Interativo, simulação e edição continuam
disponíveis.
Formato do arquivo GEO
======================
O Anatem distribui o schema ``network-geography.schema.json`` na pasta
``geography``. Ele descreve os campos aceitos e permite conferir a estrutura
de uma base GEO; não contém a geografia do caso e não interfere na simulação.
A mesma pasta contém ``Caso_1Q2026.geo.json``, a base genérica do SIN usada
como referência.
As chaves do arquivo JSON são mantidas em inglês para preservar o formato. Na
Visão Geoespacial, elas são apresentadas em português:
* ``nodes``: nós geográficos;
* ``buses``: barras elétricas;
* ``trunks``: troncos geográficos;
* ``circuits``: circuitos elétricos.
Consulte :ref:`Arquivo de Dados Geográficos ` para a declaração no
``DARQ``, a estrutura do arquivo e os cuidados de proveniência.
Base de referência do SIN
=========================
O Anatem inclui uma base genérica para o caso SIN de referência. Ela combina o
inventário elétrico do caso com uma fotografia pública de coordenadas de
subestações. Construída a partir de dados públicos, essa base tem finalidade
ilustrativa: é apropriada para contexto regional e demonstração, mas não
constitui cadastro oficial ou atualizado de cada ativo.
As bases geográficas adequadas a cada estudo ficam a critério dos provedores
oficiais das bases elétricas correspondentes, como o ONS e a EPE. Quando
disponibilizadas, essas bases específicas devem ser preferidas à referência
genérica distribuída com o Anatem.
A visão funciona com os dados instalados, sem depender de conexão durante o
uso. O Brasil é o enquadramento padrão; Argentina e Paraguai também são
apresentados quando houver dados geográficos do caso nesses territórios.
Modelo elétrico e geográfico
============================
`Barra`
Elemento elétrico identificado pelo número do `RBAR`.
`Circuito`
Ligação elétrica individual identificada pela topologia do `RLIN`.
`Nó`
Posição geográfica que pode reunir uma ou mais barras.
`Tronco`
Geometria que pode reunir um ou mais circuitos. Circuitos paralelos
continuam individualizados no detalhe.
Uma barra pode possuir posição exata, aproximada ou não mapeada. A interface
identifica as posições aproximadas como orientação regional, e não como
coordenadas cadastrais. Elementos não mapeados permanecem no inventário
elétrico sem receber posição inventada.
Cabeçalho e cobertura
=====================
O cabeçalho comum identifica **Visão Geoespacial**, o caso e os arquivos da
análise. O chevron recolhe a interpretação auxiliar sem ocultar o título.
`Mapa estático` ou `Mapa dinâmico`
Informa se a medida depende do instante corrente. A excursão usa todo o
período; os extremos usam o intervalo a partir do marco escolhido;
comparação e diferença usam A e B.
`Cobertura`
Resume nós, barras, troncos, circuitos e resultados que puderam ser
associados. Elemento sem posição não é elemento inexistente, e elemento sem
resultado não é automaticamente inválido.
O restante do cabeçalho acompanha o tipo de análise. `EXSI` mostra a grandeza
e a medida temporal; `EAMI` e `EAIF` identificam a matriz e o sentido da
leitura. A mudança de tipo não altera o arquivo GEO.
Controles de resultado
======================
`Grandeza`
Escolhe **Ângulo**, **Frequência** ou **Tensão**. Somente sinais compatíveis
e associados a uma barra participam da camada de resultados.
`Medida`
Define a leitura temporal:
**Excursão máximo - mínimo**
Diferença não negativa entre o maior e o menor valor de cada série em
todo o horizonte. É um mapa estático.
**Comparação entre instantes**
Usa os instantes A e B. Pode mostrar os dois mapas lado a lado ou a
diferença `B - A`.
**Mínimo / máximo**
Mostra, lado a lado e com escala comum, o menor e o maior valor real de
cada posição a partir do tempo escolhido. O tempo inicial padrão é o
início da simulação.
`Analisar a partir de`
Na medida **Mínimo / máximo**, define em segundos a primeira amostra da
janela. Aceita ponto ou vírgula. Os dois mapas passam a considerar somente
as amostras desse instante em diante, sem alterar o PLT.
`Após evento DEVT`
Os atalhos posicionam o início imediatamente depois do instante de um
evento programado, por exemplo após a remoção de um curto-circuito. Os
primeiros eventos aparecem como botões; os demais ficam no seletor
**Outros eventos**. Diferentemente do tempo digitado, o atalho não inclui
amostras registradas exatamente no instante do evento.
`Ignorar VOLT abaixo de` — padrão `0,2 pu`
Disponível para **Tensão** em **Mínimo / máximo**. Valores inferiores à
máscara não participam da procura dos extremos, evitando que trechos
desenergizados sejam apresentados como mínimos de tensão. Esse ajuste
pertence à Visão Geoespacial e não altera o valor configurado no Overview
nem os arquivos do caso.
`Mostrar apenas barras com mínimo abaixo de`
Disponível para **Tensão** em **Mínimo / máximo**. Ao ativar o filtro,
informe um limite em pu, como `0,6` ou `0,8`. Só aparecem as barras cuja
menor tensão na janela ficou abaixo desse valor. O mapa de máximo mostra
as mesmas barras selecionadas pelo mínimo, permitindo comparar sua
recuperação. O filtro é aplicado depois da máscara de tensão.
Os extremos da janela consideram todas as amostras válidas dos arquivos PLT,
inclusive oscilações breves entre os pontos mostrados na animação. Se não
houver amostras após o marco ou nenhuma barra atender ao limite, a visão
informa isso sem reutilizar valores de outro intervalo.
`Exibição`
Aparece na comparação. **Antes / depois** abre painéis A e B; **Diferença
B - A** abre um mapa dinâmico único com o sinal da variação.
`Mostrar 10 maiores`
Restringe a camada de resultados aos dez valores positivos e aos dez
negativos de maior magnitude no modo de diferença. Não elimina dados do
modelo nem altera a escala numérica.
`Eventos DEVT`
Mostra ou oculta os eventos programados do caso.
`Atuações decorrentes`
Mostra ou oculta relés, ERACs e outras ocorrências registradas durante a
simulação. O rótulo descreve sua origem temporal, sem afirmar causalidade.
Afetação geográfica EAMI e EAIF
===============================
Em `EAMI` e `EAIF`, o mapa não usa tempo, reprodução ou eventos `EXSI`. Ele
apresenta um recorte direcional da matriz de fatores fora da diagonal.
`Sentido da leitura`
**Aplicação focal -> monitoradas** lê a linha da aplicação escolhida e
mostra as barras monitoradas mais afetadas. **Aplicações -> monitorada
focal** lê a coluna da barra escolhida e mostra quais aplicações mais a
afetam. A direção das setas acompanha essa escolha.
`Barra focal`
Define a linha ou coluna usada no mapa. Um duplo clique em outra bolha
torna focal a barra de maior fator representada naquela posição.
`Exibir`
**10 maiores** é a visão inicial. **Todos os índices** inclui todos os
valores fora da diagonal e **MIIF** :math:`\geq 0{,}15` aplica esse limiar sem modificar
o relatório original.
`Enquadramento`
**Região analisada** aproxima os elementos do recorte. **Brasil inteiro**
mantém o enquadramento nacional. Ambos preservam a proporção do mapa.
Cada bolha mostra o índice `MIIF × 100`: sem casa decimal no `EAMI` e com uma
casa decimal no `EAIF`. O painel de detalhe conserva o fator MIIF original com
maior precisão. Tamanho da bolha e espessura da seta indicam intensidade; a
diagonal própria, de valor unitário, não participa do mapa. A seta termina na
borda da bolha de destino para que sua direção permaneça visível.
Quando várias barras ocupam a mesma posição, a bolha usa o maior fator, sem
soma ou média. O detalhe lista os valores individuais, e o ranking lateral
continua ordenado por barra. A matriz completa e seus valores permanecem no
:ref:`Relatório Interativo `.
Cores, paletas, tamanho e agregação
===================================
O tamanho da bolha representa a magnitude do resultado. A cor representa o
sinal em relação à referência na paleta **Padrão**:
* verde: acima da referência ou diferença `B - A` positiva;
* vermelho com contorno tracejado: abaixo da referência ou diferença `B - A`
negativa;
* excursão máximo-mínimo: verde, pois a medida é não negativa.
Para tensão absoluta, a referência visual é `1 pu`. Para frequência e ângulo,
é o valor inicial da própria série. Na diferença de tensão, a intensidade do
tamanho satura em `|0,2 pu|`, mas o detalhe conserva o valor real.
Quando várias barras ou sinais compartilham a mesma coordenada, o mapa não os
soma. A bolha usa o resultado de maior valor absoluto. No modo mínimo/máximo,
o painel mínimo escolhe o menor valor real e o máximo, o maior.
`Paleta do mapa`
O seletor identificado pelo símbolo de olho altera somente as cores da
Visão Geoespacial:
**Padrão**
Preserva verde para positivo e vermelho para negativo.
**Daltonismo - azul/laranja**
Substitui a distinção verde/vermelho por azul/laranja.
**Alto contraste**
Aumenta a diferença de luminosidade entre resultados, eventos, foco e
elementos separados.
A escolha também aparece nas legendas, na captura PNG e na gravação WebM. É
uma preferência do usuário, independente do tema geral e do STB. Tamanho,
valor numérico, formas, rótulos e contorno continuam disponíveis para que a
leitura não dependa apenas de cor.
Valores abaixo de `0,001 pu` para tensão e `0,01 Hz` para frequência são
tratados como zero apenas na camada visual. O tamanho satura em `0,4 pu` e
`2 Hz`, respectivamente. Nenhum desses limites altera o valor do Overview,
do `PLT` ou do detalhe.
Elementos sobrepostos
=====================
Um círculo um pouco maior e tracejado indica que a posição reúne dois ou mais
elementos visíveis. Clique uma vez para separá-los radialmente. As linhas-guia
apontam para a posição geográfica original, e o indicador com sinal de menos no
centro recolhe a separação.
Em `EAMI` e `EAIF`, o duplo clique continua mudando a barra focal; o clique
simples apenas separa os elementos. O botão direito também pode abrir ou
recolher a separação fora dos mapas lado a lado. Mudar foco, sentido, filtro,
grandeza, medida, contexto ou caso recolhe a composição automaticamente.
Nos mapas `EXSI` lado a lado, passar o ponteiro sobre uma bolha abre o popup do
elemento correspondente nos dois painéis. O botão direito fixa os dois popups,
identificados pelo selo **FIXADO**, para facilitar uma captura de tela. Repita
o botão direito sobre o mesmo resultado para liberar os popups.
Mapa e sincronização A/B
========================
Nos modos lado a lado, A e B têm áreas de desenho independentes: linhas,
bolhas e marcadores de um painel não atravessam o divisor. Centro e zoom são
sincronizados nos dois sentidos, preservando a proporção da geometria. Mover um
mapa move o outro, mas a camada de resultado de cada painel só muda quando seu
próprio instante muda.
`Instante A`
Referência da comparação.
`Instante B`
Instante observado ou subtraído de A.
`Atalho`
**Início / fim** posiciona A na primeira e B na última amostra.
**Personalizado** preserva os valores escolhidos.
Os campos aceitam ponto ou vírgula. Se o tempo digitado não corresponde a uma
amostra, a interface usa a amostra disponível mais próxima.
Reprodução
==========
`Reproduzir em loop`
Percorre o modo dinâmico único desde o início. Em `1×`, um segundo
simulado corresponde a um segundo real.
`Velocidade`
Oferece `0,25×`, `0,5×`, `1×`, `2×` e `4×`. A legenda informa a
relação entre tempo simulado e real.
A reprodução interpola resultados entre amostras adjacentes, mas não atravessa
um instante `DEVT` por interpolação: a mudança no evento é discreta. Centro,
zoom, mapa-base, troncos e marcadores permanecem estáveis; somente a camada de
resultado é atualizada.
Reprodução, velocidade e gravação ficam desativadas nos modos lado a lado. Para
animar uma comparação, selecione **Diferença B - A**.
Exportação visual
=================
`Capturar PNG`
Salva a composição corrente com título, caso, grandeza, medida, instante,
velocidade e eventos exibidos.
`Gravar ciclo WebM`
Quando a gravação estiver disponível no sistema, inicia no primeiro
instante, registra um ciclo completo a 60 quadros por segundo e salva o
arquivo automaticamente. O painel informativo usa a mesma composição da
captura.
Essas ações exportam a visualização; não exportam uma nova base elétrica nem
substituem os dados numéricos do `PLT`.
Detalhe e legenda
=================
Selecionar uma bolha abre o painel **Leitura do mapa**.
`Nó`
Identidade geográfica selecionada.
`Barras agregadas`
Relação das barras elétricas que compartilham a posição.
`Sinal e valor`
Grandeza usada na bolha, valor real, instante ou intervalo e identidade do
sinal.
`Tronco`
Relação dos circuitos associados à geometria selecionada.
A legenda distingue bolhas positivas e negativas, eventos `DEVT`, atuações
decorrentes e troncos. Em `EAMI` e `EAIF`, ela distingue barra focal, direção
das setas e posições com elementos sobrepostos. A lista **Eventos do caso**
descreve separadamente cada `DEVT` com instante e localização elétrica nos
casos `EXSI`.
Eventos no mapa
===============
Eventos `DEVT` localizados usam marcadores pequenos, laranja, constantes e
numerados pela ordem temporal. Eventos próximos podem formar um único marcador
de raio, preservando no detalhe curto, abertura e remoção de curto.
Atuações decorrentes usam símbolo diferente. O mapa pode mostrar que uma
ocorrência veio depois de um evento; isso não demonstra que uma causou a outra.
Como interpretar o mapa
=======================
A Visão Geoespacial está disponível para resultados `EXSI` e para os recortes
direcionais `EAMI`/`EAIF`. Em `EAMI` e `EAIF`, o mapa complementa a matriz do
Relatório Interativo; não a substitui e não representa uma evolução temporal.
As posições marcadas como aproximadas servem para orientação regional, sem
valor de coordenada cadastral.
Os troncos representam as ligações identificadas no caso; proximidade no mapa
não significa conexão elétrica. Os valores são associados às barras e não são
interpolados ao longo do desenho de um tronco. Quando várias barras
compartilham uma coordenada, consulte **Leitura do mapa** para ver todos os
elementos representados pela bolha.
.. figure:: ../anatem_13/img/anatem_13_geoespacial.png
:alt: Visão Geoespacial do Anatem 13
:width: 100%
:name: fig-anatem13-visao-geoespacial
Visão Geoespacial comparando valores mínimo e máximo no mapa, com eventos e
leitura dos elementos representados.