CLI

Você pode utilizar a Interface de Linha de Comando do cbers4asat para consumir o catálogo de imagens do CBERS-04A e AMAZONIA-1.

É uma maneira mais fácil e rápida de consultar e baixar cenas no catálogo sem a necessidade de escrever código em Python.

Download

Vá até as releases e procure pelo versão mais recente de cbers4asat-cli e baixe o executável que mais se adeque ao seu sistema operacional.

https://github.com/gabriel-russo/cbers4asat/releases

Opções

Arg. Curto Arg. Longo Tipo Descrição
-u --user TEXTO E-mail cadastrado no site do dgi inpe explore
-g --geometry ARQUIVO Caminho até o arquivo GeoJSON com polígonos que serão utilizados como parâmetros de busca
--collections LISTA Nome(s) da(s) coleção(ões) que irão ser utilizadas como fonte dos dados (Padrão: Todas as coleções)
-s --start TEXTO Data de início utilizando o formato YYYY-MM-DD (Padrão: HOJE - 1 SEMANA)
-e --end TEXTO Data final utilizando o formato YYYY-MM-DD (Padrão: HOJE)
-c --cloud INTEIRO Quantidade de cobertura de nuvens máximo na imagem (Padrão: 100)
-l --limit INTEIRO Quantidade de cenas limite retornadas das coleções por busca (Padrão: 25)
-i --id TEXTO Busca metadados de uma cena pelo seu ID
-d --download NÃO DISPONÍVEL
--save Salvar o resultado da busca em GeoJSON
-o --output Especificar a pasta onde será armazenada o GeoJSON (Padrão: Diretório atual)
-h --help Mostra texto de ajuda para utilização
-v --version Mostra o número da versão

Exemplos

Linux

Exemplo 1: Este é o menor comando possível. Buscando as cenas mais recentes (uma semana atrás) em todas as coleções no(s) polígono(s) do GeoJSON.

cbers4asat --geometry area.geojson

Exemplo 2: Buscando imagens das coleções CBERS4A_WPM_L4_DN e AMAZONIA_WFI_L2_DN.

cbers4asat --geometry area.geojson --collections CBERS4A_WPM_L4_DN AMAZONIA_WFI_L2_DN

Exemplo 3: O mesmo do exemplo dois, mas também mostrando que as coleções não são case-sensitive.

cbers4asat --geometry area.geojson --collections cbers4a_wpm_l4_dn Amazonia_wfi_L2_Dn

Exemplo 4: Buscando imagens das coleções CBERS4A_WPM_L4_DN e AMAZONIA_WFI_L2_DN que estão intersectando fazenda.geojson entre as datas de 25/07/2023 e 25/08/2023, limitando 25 cenas no output.

cbers4asat --geometry fazenda.geojson --collections CBERS4A_WPM_L4_DN AMAZONIA_WFI_L2_DN --start 2023-07-25 --end 2023-08-25 --limit 25

Exemplo 5: O mesmo do exemplo 2, porém as cenas devem possui menos de 25% de cobertura de nuvem

cbers4asat -g fazenda.geojson --collections CBERS4A_WPM_L4_DN AMAZONIA_WFI_L2_DN -s 2023-06-25 -e 2023-08-25 --limit 25 --cloud 25

Output do exemplo 5:

2 scenes found
---
Product CBERS4A_WPM22812420230718 - Date: "2023-07-18T14:53:57", Sensor: "WPM", Satellite: "CBERS4A", Cloud: 0.0%, Path: 228, Row: 124, Collection: "CBERS4A_WPM_L4_DN"
Product CBERS4A_WPM22812520230718 - Date: "2023-07-18T14:54:10", Sensor: "WPM", Satellite: "CBERS4A", Cloud: 0.0%, Path: 228, Row: 125, Collection: "CBERS4A_WPM_L4_DN"

Exemplo 6: Buscando metadados de uma cena pelo ID.

cbers4asat --id AMAZONIA1_WFI03901620230718CB10

Output do exemplo 6:

2 scenes found
---
Product AMAZONIA1_WFI03901620230718CB10 - Date: "2023-07-18T15:01:41", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 30.0%, Path: 39, Row: 16, Collection: "AMAZONIA1_WFI_L2_DN"
Product AMAZONIA1_WFI03901620230718CB10 - Date: "2023-07-18T15:01:41", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 30.0%, Path: 39, Row: 16, Collection: "AMAZONIA1_WFI_L4_DN"

Exemplo 7: Salvando a busca em GeoJSON:

cbers4asat -g area.geojson --collections CBERS4A_WPM_L4_DN AMAZONIA_WFI_L2_DN --save

Exemplo 8: Salvando a busca em GeoJSON num diretório específico:

cbers4asat -g area.geojson --collections CBERS4A_WPM_L4_DN AMAZONIA_WFI_L2_DN --save --output Documents/

Windows

Todos os comandos do exemplo de linux irão funcionar no windows, basta adicionar o sufixo ".exe" do executável.

.\cbers4asat.exe --geometry area.geojson --collections AMAZONIA1_WFI_L4_DN AMAZONIA1_WFI_L2_DN --start 2023-07-25

Output:

4 scenes found
---
Product AMAZONIA1_WFI03901620230728CB10 - Date: "2023-07-28T15:01:40", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 10.0%, Path: 39, Row: 16, Collection: "AMAZONIA1_WFI_L4_DN"
Product AMAZONIA1_WFI03901720230728CB10 - Date: "2023-07-28T15:03:20", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 30.0%, Path: 39, Row: 17, Collection: "AMAZONIA1_WFI_L4_DN"
Product AMAZONIA1_WFI03801620230726CB10 - Date: "2023-07-26T14:41:40", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 0.0%, Path: 38, Row: 16, Collection: "AMAZONIA1_WFI_L4_DN"
Product AMAZONIA1_WFI03801720230726CB10 - Date: "2023-07-26T14:43:20", Sensor: "WFI", Satellite: "AMAZONIA1", Cloud: 10.0%, Path: 38, Row: 17, Collection: "AMAZONIA1_WFI_L4_DN"

MacOS

Caso você seja usuário de MacOS e gostaria de utilizar a cli do cbers4asat no seu sistema operacional, você pode solicitar para que seja adicionado abrindo uma issue ou enviando um e-mail para gabrielrusso@protonmail.com