Ir para o conteúdo

Exportações

Esta página explica como tirar dados e relatórios do LUC Analytics (LUCA), e quando cada exportação não está disponível.

Nesta página, um controle ou um rótulo do aplicativo está em negrito. Uma mensagem do aplicativo está entre "aspas duplas".

Resumo das exportações

Exportação Onde está o controle Formato Nome do arquivo
Resultados da lista, pós-2020 O menu ⋯ da lista na página de listas, item Exportar CSV <list name> - post2020.csv
Resultados da lista, pós-2020 A aba AVALIAÇÃO DE RISCO PÓS-2020 de uma lista, botão ⬇ Baixar CSV CSV <list name> - post2020.csv
Resultados da lista, alertas A aba ALERTAS RECENTES DE PERTURBAÇÃO de uma lista, botão ⬇ Baixar CSV CSV <list name> - alerts.csv
Um local O painel Detalhes do local, botão ⬇ Baixar CSV CSV <list name> - location <id> detail.csv
Relatório de um local O painel Detalhes do local, botão Baixar PDF PDF location-<id>-report.pdf
Dados usados Vem com cada exportação CSV, como um segundo arquivo CSV <CSV name>.data-used.csv
Modelo da legenda do mapa A legenda do mapa, Modelos de mapa salvos, botão Salvar .mpky (JSON) mapkey_0001.mpky ou o nome que você digitar

Se o nome da lista não der um nome de arquivo utilizável, o aplicativo usa o ID da lista, por exemplo list-<list id>-post2020.csv ou location-<id>-detail.csv. O aplicativo substitui os caracteres que o Windows, o macOS ou o Linux não permitem em um nome de arquivo.

Quando uma exportação está disponível

O navegador e o servidor fazem, cada um, uma verificação antes de uma exportação. As duas verificações usam a mesma regra:

  • Uma exportação de uma lista completa está disponível somente quando a análise da lista está concluída.

  • Uma exportação de um local está disponível somente quando a análise desse local está concluída.

Exportação Condição necessária
CSV da lista e o arquivo de dados usados dele (Exportar e os dois botões ⬇ Baixar CSV) O status da lista é concluído. Antes disso, a dica mostra "A exportação CSV ficará disponível quando a análise desta lista for concluída."
CSV do local e o arquivo de dados usados dele Cada análise da lista está concluída para esse local.
PDF do local A análise pós-2020 desse local está concluída. O mapa também deve estar pronto para captura.

Estes são os resultados das verificações:

  • Você não pode exportar o CSV de uma lista que não está concluída. Uma lista com o rótulo Incompleta (por exemplo, depois de Parar e confirmar) fica nesta condição. Para uma lista assim, exporte cada local concluído.

  • Você pode baixar o CSV ou o PDF de um local concluído. Os outros locais da lista não precisam estar concluídos.

  • O PDF de um local em uma lista que não está concluída tem uma nota, por exemplo "Relatório gerado a partir de uma lista parcialmente analisada — 40/50 locais analisados (80%)". Se o aplicativo não conseguir contar os locais, a nota é "Relatório gerado a partir de uma lista parcialmente analisada — número de locais analisados não pôde ser confirmado".

  • O aplicativo não escreve um zero no lugar de um valor que ele não calculou. Não há como ignorar estas verificações.

Se o servidor recusar uma exportação, o aplicativo mostra uma destas mensagens:

  • "Exportação indisponível — nenhum local desta lista foi analisado ainda, então não há nada para exportar."

  • "A exportação CSV ficará disponível quando a análise desta lista for concluída."

  • "Exportação indisponível — a análise deste local ainda não foi concluída. A exportação ficará disponível quando todas as análises dele estiverem concluídas."

  • "Exportação de PDF indisponível — nenhum local foi analisado para esta lista ainda."

Para mais dados sobre os estados da análise, consulte 03-analysis-and-results.md.

Exportar os resultados de uma lista como CSV

Você pode iniciar a exportação pós-2020 na página de listas ou na lista. Os dois controles dão o mesmo arquivo.

Na página de listas:

  1. Vá para a página de listas (Listas).
  2. Na linha da lista, pressione ⋯.
  3. Selecione Exportar.

Na lista:

  1. Abra a lista.
  2. Selecione a aba AVALIAÇÃO DE RISCO PÓS-2020 ou a aba ALERTAS RECENTES DE PERTURBAÇÃO.
  3. Se você usar a aba de alertas, defina as datas dos alertas no chip de datas Alertas. O CSV usa as mesmas datas.
  4. Pressione ⬇ Baixar CSV.

O navegador baixa dois arquivos: o CSV e o arquivo de dados usados dele. Para o arquivo de dados usados, consulte "O arquivo de dados usados" abaixo.

Conteúdo do CSV pós-2020

O CSV tem uma linha para cada local. As colunas são:

  • A identidade do local: location_id, location_name, load_order, status, centroid_lat, centroid_lon.

  • A data da análise e a versão do conjunto de dados: post2020_analysis_date, post2020_dataset_version.

  • As áreas em hectares: total_area_ha, sbtn_area_ha, jrc_area_ha, e os indicadores sbtn_flag e jrc_flag.

  • A perda depois de 2020 para cada mapa florestal de base: sbtn_loss_ha_post2020, jrc_loss_ha_post2020. Também há uma coluna para cada ano de perda, por exemplo sbtn_loss_ha_2021.

  • Os fatores da perda de cobertura arbórea: uma coluna driver_<name>_ha para cada fator. Depois, dominant_driver, dominant_share, dominant_is_mixed e dominant_is_none.

  • Os erros: error_code e explanation.

  • O estado: finished_state, list_status, list_locations_computed, list_locations_total.

Conteúdo do CSV de alertas

O CSV de alertas tem uma linha para cada local. Ele tem as mesmas colunas de identidade, área, erro e estado do CSV pós-2020. Ele também tem estas colunas: alerts_analysis_date, alerts_dataset_version, alert_area_ha, alert_sbtn_area_ha, alert_jrc_area_ha, window_start e window_end. As duas colunas de janela mostram as datas dos alertas que o arquivo conta.

Exportar um local como CSV

  1. Abra a lista.
  2. Na linha do local, pressione DETALHES. O painel Detalhes do local abre.
  3. Pressione ⬇ Baixar CSV.

O CSV tem uma linha. Ele contém as colunas de identidade, área, perda e fatores do CSV pós-2020, e as colunas de alertas do CSV de alertas. Ele também contém a coluna annotation, que é a sua nota sobre o local. O navegador também baixa o arquivo de dados usados desse local.

Baixar um relatório PDF de um local

  1. Abra a lista.
  2. Na linha do local, pressione DETALHES.
  3. Aguarde até que o mapa no painel Detalhes do local esteja totalmente desenhado.
  4. Pressione Baixar PDF.

Antes de criar o PDF, o aplicativo aguarda os blocos do mapa base e as camadas de análise. Se eles não estiverem prontos, o aplicativo não cria o arquivo. Ele mostra uma mensagem que informa a causa. Por exemplo: "Exportação de PDF indisponível — ainda aguardando: o carregamento dos blocos do mapa base (6 de 9 carregados). Aguarde e tente novamente."

O PDF está na orientação paisagem. Ele contém estes itens:

  1. Um título: o nome e o ID do local.
  2. Uma nota, somente se a lista não estiver concluída. A nota informa o número de locais concluídos. Consulte "Quando uma exportação está disponível" acima.
  3. Duas imagens de mapa: "Limite no mapa base" e "Limite + camadas de análise ativas no mapa base".
  4. "Configurações de camada usadas nestas imagens". Esta parte informa a cor e a opacidade de cada camada, os anos de perda, as datas dos alertas e a resolução do mapa.
  5. Os detalhes do local: o nome, a área e as suas notas.
  6. A tabela de perda florestal para cada ano, para o mapa florestal SBTN e o mapa florestal JRC.
  7. Os alertas, se a lista tiver a análise de alertas.
  8. Os fatores da perda de cobertura arbórea, como um gráfico de pizza com uma legenda. Se não houver dados de fatores, o PDF informa isso.
  9. "Dados usados": os conjuntos de dados e as versões deles.
  10. "Como citar os dados": o texto de atribuição.

NOTA: As imagens de mapa podem ser maiores que na tela. Então o PDF informa a escala, por exemplo "Painéis de mapa ampliados ×2.00 da resolução da tela para este relatório."

Para os controles do mapa que alteram as imagens, consulte 04-maps.md.

O arquivo de dados usados

Cada exportação CSV vem com um segundo arquivo. O nome dele é o nome do CSV com .data-used.csv no lugar de .csv. Ele contém uma linha para cada conjunto de dados de origem, com estas colunas: dataset, version_id, date, date_kind, local_or_s3, profile, currency_at_run, hash, location.

Se a análise foi executada antes de o aplicativo registrar as datas dos conjuntos de dados, o arquivo tem uma linha com o texto vigência não registrada.

O CSV pode ser baixado quando o arquivo de dados usados não é. Então o aplicativo mostra "O CSV foi baixado, mas o arquivo complementar "Dados usados" (as datas dos conjuntos de dados de origem) não pôde ser baixado." Pressione o botão novamente para obter os dois arquivos.

Formato dos arquivos CSV

  • O texto está em UTF-8 com uma marca de ordem de bytes (BOM). As linhas terminam com CR LF.

  • As primeiras linhas são o texto de atribuição. Cada uma destas linhas começa com #. A linha de títulos da tabela vem depois delas.

  • Os números não têm separador de milhares. As áreas têm no máximo 4 casas decimais.

  • Uma célula fica vazia quando o aplicativo não tem valor para ela, por exemplo um local com um erro. O aplicativo não escreve um zero no lugar de um valor que ele não calculou.

NOTA: Se uma célula de texto começar com =, +, -, @ ou uma tabulação, o aplicativo coloca ' antes do texto. Assim, um programa de planilhas não lê o texto como uma fórmula.

Para ler a tabela em um programa, diga ao programa para ignorar as linhas que começam com #. Por exemplo, no pandas, use read_csv(..., comment="#").

Atribuição e licenças

Os "Termos de Uso Especiais do WRI para GNW Self-Hosted Monitoring" se aplicam aos dados. Você deve atribuir os dados quando compartilhar um resultado. Você não pode sugerir que o WRI endossa, patrocina, certifica ou aprova você ou o seu uso dos dados.

O aplicativo adiciona o texto de atribuição a cada exportação CSV e a cada relatório PDF. O texto tem estas partes:

  1. A citação do GNW, com a data de acesso: "Global Nature Watch. [ano]. World Resources Institute. Acessado em [data]." A data de acesso é a data em que a última execução da lista terminou.
  2. A citação de cada conjunto de dados que a exportação usa, com a licença dele.
  3. "Calculado com o LUC Analytics, um projeto independente, usando métodos adaptados dos scripts publicados pelo WRI (post2020.py, GNW Self-Hosted Monitoring). O WRI não endossa este projeto nem seus resultados."
  4. "O uso destes dados está sujeito aos Termos de Uso Especiais do WRI para GNW Self-Hosted Monitoring: https://www.wri.org/about/legal/gnw-shm-tos"

Os conjuntos de dados de cada exportação são:

Exportação Conjuntos de dados
CSV pós-2020 Perda de cobertura arbórea, Florestas naturais SBTN, Cobertura florestal global JRC 2020, Causas dominantes da perda florestal
CSV de alertas Alertas integrados de perturbação globais, Florestas naturais SBTN, Cobertura florestal global JRC 2020
CSV do local e PDF do local Todos os cinco conjuntos de dados acima

As licenças são:

Licença Conjuntos de dados
CC BY 4.0 Perda de cobertura arbórea, Florestas naturais SBTN, Causas dominantes da perda florestal, Alertas integrados de perturbação globais
Gratuito, sem restrição de uso (Regulamento Copernicus da Comissão Europeia) Cobertura florestal global JRC 2020

Para uma lista com dados de demonstração sintéticos, o texto de atribuição é diferente. Ele diz "Dados sintéticos de demonstração gerados pelo LUC Analytics. Nenhum conjunto de dados do WRI foi lido para estes números."

Para ler o texto de atribuição no aplicativo, pressione Fontes de dados e licenças na parte de baixo da página. O texto completo está no arquivo DATA-ATTRIBUTION.md no repositório do projeto.

CUIDADO: Mantenha as linhas de atribuição quando você copiar dados de um CSV para outro arquivo. Se você removê-las, o novo arquivo não informa aos leitores a fonte e a licença dos dados.

Salvar um modelo da legenda do mapa

Um modelo da legenda do mapa guarda as configurações das camadas do mapa em um arquivo, para que você possa usá-las novamente. Ele não é uma exportação de resultados.

  1. Na legenda do mapa, encontre Modelos de mapa salvos.
  2. Digite um nome em Nome do arquivo, ou mantenha o nome padrão.
  3. Pressione Salvar.

O arquivo é um documento JSON com a extensão .mpky. Para usar o arquivo novamente, pressione Carregar…. Para mais dados, consulte 04-maps.md.

Exportação pela linha de comando

O programa também tem o comando luc-analytics export para administradores. Ele escreve o CSV de uma lista (--analysis post2020 ou --analysis alerts) ou de um local (--analysis detail --location-id <id>). Os argumentos --start e --end definem as datas dos alertas. O argumento --output define o arquivo. Sem --output, o comando escreve na saída padrão.

O comando usa as mesmas verificações que o aplicativo. Para uma lista inteira, a lista deve estar concluída. Para um único local, esse local deve estar concluído. Se a verificação falhar, o comando não escreve nenhum arquivo. Ele mostra uma mensagem que começa com export_refused: e para com o código de saída 1. O comando não escreve o arquivo de dados usados. O comando escreve o texto de atribuição em inglês.