Mapas¶

Esta página explica como usar os mapas do LUC Analytics.

Os dois mapas¶

O LUC Analytics tem dois mapas:

O mapa de todos os locais. O título dele é Polígonos — todos os locais. Ele mostra os limites de todos os locais de uma lista.
O mapa de um local. O título dele é Mapa do local — . Ele mostra o limite de um local e as camadas de análise desse local.

O mapa de todos os locais não mostra camadas de análise. Ele não tem filtros de tempo, nem comparação por deslize, nem o controle Limpar dados de mapa.

Abrir o mapa de todos os locais¶

Abra uma lista.
Pressione Ver todos os locais na barra de ferramentas acima da tabela.

O mapa mostra o limite de cada local. Acima do mapa, o aplicativo mostra o nome e o status de cada local.

Para encontrar o nome de um local, pressione o limite dele no mapa. Uma caixa Local mostra o nome. Se houver mais de um local nesse ponto, a caixa mostra a posição, por exemplo "1 de 3". Pressione Mostrar o próximo local neste ponto para ver o próximo nome. Pressione Dispensar nome do local para fechar a caixa.

Abrir o mapa de um local¶

Abra uma lista.
Encontre a linha do local na tabela.
Pressione MAPA nessa linha.

O título mostra o nome do local. Se a lista tiver um número de ordem para a linha, o título também o mostra, por exemplo "· Ordem 4".

Você não pode abrir um mapa para a linha de todos os locais.

Fechar um mapa¶

Pressione × no canto superior direito do mapa.

Controles do mapa¶

Os controles do mapa estão na borda do mapa. Eles têm estes botões:

+ (Aproximar)
− (Afastar)
⤢ (Enquadrar local(is)). Este botão move o mapa para que todos os limites caibam na vista.

Chips e painéis¶

Pequenos botões no mapa abrem painéis. Este guia chama esses botões de "chips". Quando você pressiona um chip, o painel dele abre. Se o mapa for estreito, os chips mostram somente um ícone.

Chip	Canto	Conteúdo do painel
Camadas	Superior esquerdo	As linhas das camadas e a legenda
Períodos de data	Superior esquerdo	Os filtros de tempo (somente no mapa de um local)
Versões dos conjuntos de dados	Superior esquerdo	As versões dos dados das camadas (somente no mapa de um local)
Limpar dados de mapa	Superior esquerdo	Os controles que removem os dados de mapa guardados (somente no mapa de um local)
Mapa base e comparação	Superior direito	Os mapas base, a data das imagens e Comparar A / B
Estilo	Inferior direito	As cores e as linhas
Configuração	Inferior direito	Os modelos da legenda do mapa

No mapa de um local, o canto inferior esquerdo tem mais três chips: Camadas de análise, Detalhe da célula e o chip de zoom (Zoom ao vivo ).

No mapa de todos os locais, o chip Mapa base e comparação aparece somente se você puder selecionar mais de um mapa base, ou se o mapa base tiver datas.

Camadas de análise¶

O chip Camadas de análise mostra ou oculta todas as camadas de análise ao mesmo tempo.

Pressione Camadas de análise para ocultar as camadas de análise.
Pressione Camadas de análise novamente para mostrá-las.

NOTA: Olhe o chip cada vez que você abrir um mapa. As camadas de análise ficam ativadas cada vez que você abre um mapa ou vai para outro local.

Camadas e a legenda do mapa¶

O painel Camadas é a legenda do mapa. Ele tem uma linha para cada camada. Cada linha tem uma caixa de seleção, uma amostra de cor e o nome da camada.

O mapa de um local tem estas camadas:

Janela de pixels JRC
Janela de pixels SBTN
Janela de pixels de alertas
Janela de pixels TCL
Limites das parcelas
Halo de seleção

O mapa de todos os locais tem somente Limites das parcelas e Halo de seleção.

Mostrar ou ocultar uma camada¶

Pressione Camadas.
Marque a caixa de seleção da camada para mostrá-la.
Desmarque a caixa de seleção da camada para ocultá-la.

Se o aplicativo não puder mostrar uma camada, você não pode marcar a caixa de seleção dela. Uma nota substitui o nome da camada, por exemplo [Nenhum dado de TCL capturado].

Alterar a intensidade de uma camada¶

Cada camada de janela de pixels tem um controle de intensidade de 0 a 100 %.

Pressione Camadas.
Mova o controle deslizante na linha da camada. Você também pode digitar um número de 0 a 100 na caixa.

Outros controles na legenda do mapa¶

Mostrar limites das células mostra uma linha ao redor de cada célula.
Mostrar densidade mostra um quadrado em cada célula quando você afasta o zoom. O tamanho do quadrado mostra a parte dos pixels que têm perda ou alertas.

A legenda¶

A Legenda no painel Camadas informa o que as marcas no mapa significam:

Cinza: ainda não totalmente calculado
Linha tracejada: limite da área mapeada
Sem cor no interior: neutro, todos os pixels calculados, nenhum positivo para esta seleção.
Tamanho do quadrado: fração de pixels com perda/alertas (vistas com zoom afastado). Esta linha aparece somente quando as células são maiores que os pixels de origem.

Para a camada de alertas, a legenda do mapa mostra Alertas: confiança máxima e Alertas: confiança alta na vista nativa. Em uma vista com células maiores, ela mostra Alertas (alta + máxima).

Estilo¶

O painel Estilo permite alterar as cores e as linhas das camadas.

Selecione uma cor para cada camada. Uma paleta e Cores rápidas estão disponíveis. Pressione Editar cores rápidas para alterar as cores rápidas.
Altere a Espessura da Linha de limite. A Opacidade dela é sempre 100 %.
Altere a cor, a Espessura e a Opacidade do Halo de seleção.

Se uma cor estiver próxima da cor de uma camada de dados, o painel mostra um aviso. Pode ser difícil ver a diferença entre duas camadas que têm cores próximas.

A Legenda de matiz e confiança de alertas mostra as cores dos dois níveis de confiança dos alertas.

Modelos da legenda do mapa¶

Um modelo da legenda do mapa guarda a configuração do seu mapa em um arquivo. O nome do arquivo termina em ".mpky". Um modelo guarda estes itens:

As camadas visíveis, a intensidade delas e Mostrar limites das células.
As cores, as espessuras e a opacidade das linhas.
O mapa base, a data das imagens e o zoom.
Os anos de perda e as datas dos alertas.

Salvar um modelo¶

Pressione Configuração.
Se necessário, altere o nome em Nome do arquivo.
Pressione Salvar.

O navegador baixa o arquivo. O modelo também aparece em Configurações salvas.

Usar um modelo¶

Pressione Configuração.
Faça uma destas etapas:
Em Configurações salvas, pressione Usar ao lado do modelo.
Pressione Carregar… e selecione um arquivo de modelo no seu computador.

Se o arquivo não for um modelo correto, o mapa não muda. O painel mostra um erro, por exemplo "Este não é um arquivo de modelo da legenda do mapa."

Mapas base¶

O mapa base é a imagem do mapa abaixo dos limites e das camadas. O painel Mapa base e comparação mostra somente os mapas base que você pode usar.

Mapa base	Credencial necessária	Datas	Mapa
OpenStreetMap	Nenhuma	Não	Os dois mapas
Satélite	Uma chave do seu provedor de blocos, fora da página Configurações. Consulte O mapa base Satélite.	Não	Os dois mapas
Google Maps	Google Maps	Não	Os dois mapas
Google Satellite	Google Maps	Não	Os dois mapas
Planet	Planet	Mês	Somente o mapa de um local
Sentinel-2 (Copernicus Data Space)	Copernicus (CDSE)	Dia	Os dois mapas

Adicione as credenciais do Google Maps, do Planet e do Copernicus (CDSE) em Configurações > Credenciais. Consulte Configurações.

O mapa base Sentinel-2¶

Na imagem Docker, Sentinel-2 (Copernicus Data Space) fica ativado quando o contêiner inicia pela primeira vez. O contêiner cria /data/config.yaml a partir de config.example.yaml, e esse arquivo ativa o provedor Copernicus. Você somente adiciona o ID da instância no cartão Copernicus (CDSE) em Configurações > Credenciais. Depois, o mapa base aparece no painel Mapa base e comparação.

NOTA: Uma instalação de uma imagem anterior mantém o seu /data/config.yaml antigo, porque o contêiner nunca altera um arquivo de configuração que existe. Nesse arquivo, o provedor Copernicus está desativado (cdse_enabled: false) e o modelo de blocos está vazio. O mapa base não aparece até que você altere o arquivo. Copie as linhas cdse_ abaixo de maps: de /app/config.example.yaml no contêiner. Consulte O arquivo de configuração.

O mapa base Satélite¶

Nenhuma parte da página Configurações pode definir a chave do mapa base Satélite. O aplicativo mostra este mapa base somente se você fizer estas etapas:

Coloque a chave na variável de ambiente SATELLITE_TILES_API_KEY. Você também pode colocá-la em um segredo do Docker com o mesmo nome, ou no Gerenciador de Credenciais do Windows.
No arquivo de configuração, defina maps.satellite_tiles_url_template. O valor deve conter __APIKEY__ no lugar da chave.
No arquivo de configuração, defina maps.satellite_tiles_attribution.
Reinicie o aplicativo.

NOTA: O aplicativo não usa uma chave que você escreve em maps.satellite_tiles_api_key.

Selecionar um mapa base¶

Pressione Mapa base e comparação.
Pressione o nome do mapa base.

O aplicativo guarda a sua seleção para o próximo mapa. Se o seu mapa base não estiver disponível, o mapa mostra OpenStreetMap.

Se os blocos do mapa base não carregarem, o mapa mostra uma destas mensagens:

Para um mapa base sem datas: "Os blocos do mapa base não estão disponíveis — verifique a chave do provedor."
Para um mapa base com datas: "Os blocos do mapa base não estão disponíveis — verifique a chave do provedor ou o período selecionado."

Selecionar a data das imagens¶

Um mapa base com datas não mostra imagem até ter uma data.

Para Planet, o mapa mostra "Selecione um ano e um mês para carregar as imagens." Faça estas etapas:

Pressione Escolher data na mensagem. Você também pode pressionar Mapa base e comparação.
Mova o controle deslizante Imagens em. Você também pode digitar o mês na caixa como AAAA.MM, por exemplo 2024.03.

Para Sentinel-2 (Copernicus Data Space), a data é hoje quando você abre o mapa. Para alterá-la, digite uma data em Imagens em. O mapa mostra as imagens mais recentes nessa data ou antes dela.

Comparação por deslize¶

A comparação por deslize mostra duas datas de imagens em um mapa. O momento A fica à esquerda. O momento B fica à direita. Você pode usar a comparação por deslize somente no mapa de um local, com um mapa base que tenha datas.

Pressione Mapa base e comparação.
Pressione Comparar A / B.
Selecione a data para Momento A.
Selecione a data para Momento B.

Quando você define as duas datas, uma linha vertical divide o mapa. Uma alça na linha mostra as duas datas, por exemplo "◀ 2024.03 │ 2025.03 ▶". O chip Mapa base e comparação também mostra as duas datas.

Para mover a linha, faça uma destas etapas:

Mova a alça com o ponteiro.
Pressione a alça e depois pressione as teclas de seta. A linha se move 5 % cada vez que você pressiona uma tecla de seta.
Pressione Home ou End para mover a linha para a borda esquerda ou para a borda direita.

Para parar a comparação por deslize, pressione Comparar A / B novamente.

Se o mapa base não tiver datas, Comparar A / B não está disponível. O painel mostra "A comparação não está disponível: este mapa base não tem datas para escolher."

Filtros de tempo no mapa¶

O chip Períodos de data abre os Filtros de tempo. Estes filtros alteram somente o mapa. Eles não alteram a tabela.

Quando você abre o mapa, ele usa os anos de perda e as datas dos alertas da aba.

Se a área for grande demais para a análise local, o painel mostra "Este painel ainda não está preenchido."

Selecionar os anos de perda¶

Pressione Períodos de data.
Selecione o primeiro ano na caixa da esquerda.
Selecione o último ano na caixa da direita.

Para selecionar todos os anos, pressione Intervalo completo.

Para selecionar anos que não estão em um intervalo contínuo, faça estas etapas:

Pressione Escolher anos específicos….
Marque a caixa de seleção de cada ano que você quer.
Pressione Concluído.

Se os anos não forem contínuos, o painel mostra "Mostrando exatamente os anos selecionados — este não é um intervalo contínuo. Edite na visualização de lista." Para voltar os anos a um intervalo contínuo, pressione Editar como intervalo.

Selecionar as datas dos alertas¶

O controle das datas dos alertas mostra Datas dos alertas: e o intervalo, ou Datas dos alertas: qualquer.

Pressione Períodos de data.
Pressione o controle das datas dos alertas.
Faça uma destas etapas:
Pressione Pós-TCL ou Acumulado no ano.
Digite uma data em Data de início: e em Data de término:, depois pressione Aplicar intervalo.

Pós-TCL seleciona todas as datas de alertas que os dados têm. Acumulado no ano seleciona as datas de 1 de janeiro deste ano até a última data de alerta.

Reduzir os filtros de tempo¶

Pressione a seta ao lado de Filtros de tempo para reduzir o painel. Um resumo curto mostra os anos de perda e as datas dos alertas, por exemplo "Anos de perda 2021–2023" e "Alertas: qualquer data".

A aba de alertas¶

A aba ALERTAS RECENTES DE PERTURBAÇÃO mostra os alertas de cada local da lista. A barra de ferramentas tem o controle da janela de alertas, ⬇ Baixar CSV e Ver todos os locais. Para o arquivo CSV, consulte Exportações.

Alterar a janela de alertas¶

O controle da janela de alertas mostra Alertas, a data de início e a data de término. Se você definir as suas próprias datas, ele também mostra (personalizado).

Pressione o controle da janela de alertas.
Faça uma destas etapas:
Pressione Pós-TCL ou Acumulado no ano.
Digite uma data em Data de início: e em Data de término:, depois pressione Aplicar intervalo.
Pressione × para fechar o controle.

Você não pode selecionar datas antes da primeira data de alerta nem depois da última data de alerta. O controle mostra a data dos últimos dados no texto "Os alertas de perturbação são mostrados até (dados mais recentes disponíveis)."

Para voltar ao intervalo padrão, pressione Redefinir para automático.

Se ainda não houver dados para este ano, Acumulado no ano não está disponível.

A janela de alertas altera a tabela e o arquivo CSV. Quando você abre o mapa de um local a partir desta aba, o mapa usa as mesmas datas de alertas.

Detalhe da célula e resolução do mapa¶

O mapa de um local mostra os dados em células. Uma célula nativa é um pixel de origem. Na vista nativa, o mapa mostra a mensagem "Pixels de 10 m: os alertas mais escuros têm confiança máxima, os mais claros têm confiança alta."

O chip Detalhe da célula define o tamanho das células:

Resolução máxima pede as menores células que o mapa pode mostrar.
Resolução automática permite que o aplicativo selecione o tamanho das células para o zoom.

O chip mostra o modo e a razão entre o tamanho da célula e o pixel de origem. Por exemplo, Detalhe da célula · Resolução máxima, 1x mostra células nativas. Detalhe da célula · Resolução automática, 4x mostra células que têm 4 vezes o tamanho do pixel de origem.

Cada vez que você abre o mapa de um local, o modo é Max (resolução máxima).

Alterar o detalhe da célula¶

Pressione Detalhe da célula. O modo muda de Max para Auto, ou de Auto para Max.

Quando Max não é possível¶

Às vezes o mapa não consegue mostrar células nativas. Então o chip mostra Auto e uma marca de aviso. Pressione a marca de aviso ou coloque o ponteiro sobre ela para ler a causa:

"As células nativas são menores que um pixel de tela neste zoom. Aproxime o zoom para a resolução máxima."
"As células nativas não podem ser desenhadas para uma vista tão grande. Aproxime o zoom para a resolução máxima."

Vistas com células maiores¶

Quando as células são maiores que os pixels de origem, cada célula é um resumo de muitos pixels. Uma célula com cor mostra que há perda ou alertas nessa célula. O tamanho do quadrado na célula mostra a parte dos pixels com perda ou alertas.

Quando você afasta o zoom a partir da vista nativa, o mapa mostra "Zoom afastado: os alertas mostram densidade pelo tamanho do quadrado. Aproxime o zoom até pixels de 10 m para ver a confiança." A mensagem fecha depois de 8 segundos.

Se o servidor aumentar as células para ficar dentro dos limites dele, o mapa mostra "Reduzida para caber no orçamento — x origem".

Se você afastar demais o zoom, o mapa mostra "Aproxime o zoom para ver os dados do mapa. Neste zoom, as células seriam menores que 2 pixels de tela."

O chip de zoom¶

O chip de zoom mostra o nível de zoom, por exemplo Zoom ao vivo 14. Pressione-o para ver a escala:

A distância no terreno de um pixel de tela, por exemplo "~9 m por pixel na tela".
O tamanho no terreno de uma célula, por exemplo "células de ~10 m".
A razão entre a célula e o pixel de origem, por exemplo "as células são 1x origem".

NOTA: Estes tamanhos são valores aproximados no equador. O tamanho leste-oeste no terreno muda com a latitude.

Dados de uma célula¶

Coloque o ponteiro sobre uma célula para ver os dados dela. Você também pode mover o foco para o mapa. O mapa então informa os dados da célula no centro do mapa.

Os dados da célula mostram:

A posição da célula, por exemplo "Célula 12 / 40".
Uma linha para cada camada, por exemplo "TCL: perda" ou "Alertas: confiança máxima".
Em uma vista com células maiores, a densidade: baixa, média ou alta.

Outros estados de célula são "Neutro: todos os pixels calculados, nenhum positivo para esta seleção." e "Não mapeado: nada foi calculado aqui."

Versões dos conjuntos de dados¶

O painel Versões dos conjuntos de dados mostra a versão dos dados de cada camada, por exemplo "TCL: ".

Se a lista não registrou as versões dos dados, o chip mostra Dados mais recentes. O painel informa que o mapa mostra os dados mais recentes disponíveis. Para registrar as versões, execute a lista novamente.

Limpar os dados do mapa¶

O mapa de um local guarda os dados de mapa calculados no seu computador. Você pode remover estes dados. O mapa calcula os dados novamente na próxima vez que você o abrir.

NOTA: As duas ações de limpeza não removem o local, o limite dele nem os valores da tabela.

Limpar os dados de um local¶

Pressione Limpar dados de mapa.
Pressione Limpar.

Esta ação remove os dados de mapa guardados do local. Ela mantém as células que outras listas também usam. O painel informa a quantidade de dados que ela removeu.

Fazer a limpeza total dos dados de um local¶

AVISO: Leia os nomes das listas na caixa de diálogo. Uma limpeza total também remove os dados de mapa que outras listas usam, e os mapas delas devem calcular novamente.

Pressione Limpar dados de mapa.
Pressione Limpeza total….
Leia a caixa de diálogo. Se outras listas usarem estes dados, a caixa de diálogo informa os nomes delas.
Pressione Limpeza total para continuar, ou pressione Cancelar para parar.

Para limpar os dados de mapa de muitas listas, use Configurações. Consulte Configurações.