Prefer the English version? See README-en.md.
geemap-tools é um pacote auxiliar desenvolvido para simplificar o uso do Google Earth Engine (GEE) e da biblioteca geemap.
O projeto é mantido pelo Observatório Oceanográfico da UFF (Universidade Federal Fluminense) e foi criado para agilizar tarefas repetitivas em notebooks voltados à pesquisa, ensino e extensão.
É voltado a pesquisadores, estudantes e profissionais que precisam de ferramentas práticas e reutilizáveis para análise de dados geoespaciais.
Além das rotinas gerais, o geemap-tools também inclui funções específicas desenvolvidas para o monitoramento de colônias de pinguins e o estudo do “esverdeamento” de áreas antárticas. Essas ferramentas fazem parte do projeto Penguin Sat, do Antarctic Observatory, e foram criadas para apoiar pesquisas de ecologia polar e detecção de mudanças ambientais usando sensoriamento remoto.
Ele é baseado principalmente nas bibliotecas:
Funciona tanto no Google Colab quanto em ambientes locais com Jupyter Notebook ou Jupyter Lab.
Verifique o diretório exemplos para as principais funcionalidades.
Atualmente o geemap-tools inclui funções organizadas em submódulos:
io.py: Entrada e saída de ROIs e arquivos.clouds.py: Máscara de nuvens e qualidade de imagem.catalog.py: Listagem de imagens por ROI, satélite e intervalo.analysis.py: Séries temporais por índice (NDVI, EVI...), CHIRPS, TerraClimate, MapBiomas, Terrain, etc.sidra_tools.py: Acesso programático à Tabela 5457 (Produção Agrícola Municipal – IBGE).- Penguin Sat: Conjunto de rotinas para detecção e monitoramento de colônias de pinguins e vegetação antártica (ainda em desenvolvimento).
private-dev/: Área de desenvolvimento e testes – não será instalada como parte do pacote.
⚠️ Aviso sobre idioma dos avisos na tela
Este pacote foi originalmente desenvolvido para estudantes brasileiros, por isso as mensagens de aviso e debug exibidas durante a execução aparecem em português.Isso não impede seu uso internacional: todas as funções, parâmetros e estruturas do código estão em inglês, garantindo compatibilidade com qualquer ambiente Python.
Para entender o funcionamento de cada módulo e função, consulte o arquivo
USAGE.md, que contém explicações bilíngues (Português/Inglês).
Para instruções detalhadas, exemplos práticos e trechos de código, consulte o arquivo USAGE.md.
Todas as funções incluem docstrings bilíngues (português e inglês) para atender tanto usuários brasileiros quanto internacionais.
Se estiver usando Anaconda ou Miniconda, sugerimos criar um novo ambiente para instalação. Os pacotes abaixo são os básicos essenciais para usar o Google Earth Engine. Note que ao instalar o geemap-tools abaixo, o sistema irá se encarregar de instalar tudo que você precisa:
conda create -n geemap-tools python=3.11
conda activate geemap-tools
mamba install -c conda-forge geemap pandas geopandas eemont xarray rioxarray matplotlib openpyxl
git clone https://github.com/andrebelem/geemap-tools.git
cd geemap-tools
pip install -e .Se você está no Colab, basta instalar o geemap-tools na sua máquina virtual do colab que ele já vem com todas as dependências.
!pip install git+https://github.com/andrebelem/geemap-tools.git
Atenção: Alguns recursos de geemap podem não funcionar perfeitamente no Colab devido a limitações do ambiente (ex: Map.addLayer interativo). Dê preferência ao uso local com JupyterLab. Tenha sempre cautela com ROIs muito grandes ou operações que demandam memória pois o GEE pode bloquear seus requests.
Este projeto agora utiliza pyproject.toml com suporte a setuptools moderno. O diretório private_dev/ não é incluído na instalação. Para uso local com hot reload:
pip install -e .Contato
Dúvidas, sugestões de melhorias ou novas funções?
Entre em contato: andrebelem@id.uff.br
⚠️ Este projeto ainda está em desenvolvimento. Uma versão citável com DOI será publicada em breve.
Acesse o DeepWiki do geemap-tools ! https://deepwiki.com/andrebelem/geemap-tools