Skip to main content

Biblioteca Python para realizar a busca e processamento de imagens dos satélites CBERS-04A e AMAZONIA-1

Project description

🛰️ cbers4asat 🇧🇷

Descrição

Biblioteca Python para realizar a busca e processamento de imagens dos satélites CBERS-04A e AMAZONIA-1.

A biblioteca cbers4asat surgiu da necessidade de automatizar a busca e manipulação de imagens do satélite sino-brasileiro CBERS-04A utilizando linguagens de programação. Posteriormente foi incluido a automação do satélite AMAZONIA-1.

O design do projeto foi inspirado no sentinelsat, onde é possível de forma intuitiva realizar diversas ações, como:

  • Pesquisar por imagens.
  • Baixar as imagens pesquisadas.
  • Processar as imagens baixadas.

Veja todos os exemplos de uso na documentação.

"Python library to search and process images from the CBERS-04A and AMAZONIA-1 satellites, which provide remote sensing data for the observation and monitoring of deforestation, particularly in the Amazon region, and diversified agriculture throughout the national territory, with a high repetition rate, in order to act in synergy with existing environmental programmes."

Text about cbers4asat from Open Sustainable Technology Repository.


Latest Version Latest Version Latest Version Latest Version Code style: black Hatch project GitHub Workflow Status GitHub Workflow Status GitHub Workflow Status Documentation Status

Read this README in english (old version of docs) 🇺🇸

Download

pip install cbers4asat

Instalação com a caixa de ferramentas

pip install "cbers4asat[tools]"

Busque imagens com poucas linhas de código

from cbers4asat import Cbers4aAPI
from datetime import date

# Inicializando a biblioteca
api = Cbers4aAPI('email@mail.com') # E-mail usado no login da plataforma https://www.dgi.inpe.br/catalogo/explore

# Área de interesse. Pode ser: bouding box, path row ou polygon.
path_row = (229, 124)

# Buscando metadados. Este exemplo utiliza o path row (órbita/ponto). 
# Consulte a órbita/ponto: http://www.obt.inpe.br/OBT/assuntos/catalogo-cbers-amz-1
produtos = api.query(location=path_row,
                     initial_date=date(2021, 6, 1),
                     end_date=date(2021, 7, 1),
                     cloud=100,
                     limit=10,
                     collections=['CBERS4A_WPM_L4_DN'])

# Exibindo os resultados
print(produtos)

Desenvolvimento amigável

Biblioteca com tipagem, documentações e classes de apoio para uma melhor experiência de desenvolvimento.

from cbers4asat import Collections as coll

Utilize a caixa de ferramenta para os trabalhos mais comuns

# Para ver todas as ferramentas disponíveis, verifique a documentação
from cbers4asat.tools import rgbn_composite
from rasterio.plot import show
import rasterio as rio

# Criando a composição cor verdadeira
rgbn_composite(red='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND3.tif',
               green='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND2.tif',
               blue='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND1.tif',
               nir='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND4.tif',
               filename='CBERS4A_WPM22812420210704_TRUE_COLOR.tif',
               outdir='./STACK')

# Plotando a imagem
raster = rio.open("./STACK/CBERS4A_WPM22812420210704_TRUE_COLOR.tif")

show(raster)

Documentação

Você pode ler a documentação da biblioteca no link abaixo

https://cbers4asat.readthedocs.io/

TCC

Esse projeto foi meu objeto de estudo do Trabalho de Conclusão de Curso (TCC) no curso de Bacharelado em Ciência da Computação, você pode visualizar o PDF neste Link:

Repositório Institucional da Universidade Federal de Rondônia

Contribuição

Convido qualquer pessoa a participar contribuindo com código, relatando bugs, escrevendo documentação, criando tutoriais e discutindo o futuro deste projeto.

Para mais informações de como contribuir ao projeto, leia ao manual de contribuição

Progresso do projeto

Você pode acompanhar todo o progresso do desenvolvimento no painel de projetos

Licença

Copyright (c) 2025 Gabriel Russo

Copyright (c) 2020 Sandro Klippel

O uso é fornecido sob a Licença do MIT. Veja em LICENSE para mais detalhes.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cbers4asat-0.9.2.tar.gz (5.7 MB view details)

Uploaded Source

Built Distribution

cbers4asat-0.9.2-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

Details for the file cbers4asat-0.9.2.tar.gz.

File metadata

  • Download URL: cbers4asat-0.9.2.tar.gz
  • Upload date:
  • Size: 5.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for cbers4asat-0.9.2.tar.gz
Algorithm Hash digest
SHA256 b544a9f2fe4f9e16e2111e44075bf8b85cbf378d14b54eee96247067c956c2bf
MD5 2e6156fd1b068178de9020ea62d48c4f
BLAKE2b-256 828597cd6884103ef6174a43d562fcdfcc4352c3d27e4b23d3f80f5b896c193e

See more details on using hashes here.

File details

Details for the file cbers4asat-0.9.2-py3-none-any.whl.

File metadata

  • Download URL: cbers4asat-0.9.2-py3-none-any.whl
  • Upload date:
  • Size: 19.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for cbers4asat-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d505e8ed5368645bcda1e0599a5ac855f90b059bd1e6e4bc098342ea1e5ebba1
MD5 9c42a4bd2e0f51ef23a8158d5732ecea
BLAKE2b-256 4ef553d1e3533e4d506e752dbe62c74bce7efa7a96618e6d6e96f418f2689bf8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page