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.10.0.tar.gz (5.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cbers4asat-0.10.0-py3-none-any.whl (19.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for cbers4asat-0.10.0.tar.gz
Algorithm Hash digest
SHA256 47712e87bb8493a9304cc7f3526244b8cf586b508900c43928c68619ff9780c1
MD5 7c05393d1c4f9b50f964e97e43d534b3
BLAKE2b-256 5892e0aff67c1944fb3d53d8e8848903a119186c275108a11bcca3fac9cf7bca

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cbers4asat-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 19.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.23

File hashes

Hashes for cbers4asat-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8739443446eac88d62e2abf68919b21b87a2f24894e019e25f1118ff4435dd6b
MD5 9dad445978242d4386e3c8372ca3ca74
BLAKE2b-256 acba02fed657c63ecfcad85fc0f9d59fdee1dc4102bb1d473cf1aa2a4e2c2316

See more details on using hashes here.

Supported by

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