Skip to main content

Ferramenta para facilitar o acesso aos dados disponibilizados pelo DGI/INPE.

Project description

dgipy

Documentation Status

Ferramenta para facilitar o acesso aos dados disponibilizados pelo DGI/INPE.

Instalação

O dgipy pode ser instalado em sistemas operacionais Linux, Windows e MacOS com versões do Python 3.7 ou superior. Para tal, o seguinte comando pode ser utilizado

pip install dgi

Caso queira é possível também baixar o projeto e fazer a instalação a partir do código fonte, para isto utilize os seguintes comandos

git clone https://gitlab.com/labisa/catalogo-de-imagens/dgipy
cd dgipy
pip install -r requirements.txt
python setup.py install

Exemplo de utilização

A utilização do dgipy é dividida em três partes, estas apresentadas abaixo:

  • (i) População do banco de dados

A primeira etapa necessária para a utilização do dgipy é a população do banco de dados em que o dgipy vai consumir, com todas as imagens disponíveis no DGI/INPE.

Para esta etapa é possível definir diferentes regiões e datas de busca. O exemplo de código abaixo recupera imagens geradas pelo CBERS-4, de todo o território brasileiro para o intervalo de datas de 01/01/2019 até 25/01/2019

from dgi.catalogo import CatalogoDGI

data_de_busca = {"inicial": "01/01/2019", "final": "25/01/2019"}
localizacoes = {
    "norte": "11.04024846",
    "sul": "-36.49917303",
    "leste": "-30.77297895",
    "oeste": "-74.80618208"
}

catalogo = CatalogoDGI()
catalogo.lista_imagens_dgi_regiao("CB4", "", data_de_busca, localizacoes)
  • (ii) Consumo dos serviços do DGI/INPE

Com o banco de dados populado, o dgipy consegue realizar buscas das imagens que foram registradas no banco e também fazer pedidos no catálogo.

O código abaixo busca todas as imagens que possuem data entre os dias 01/01/2019 e 01/02/2019 e realiza o pedido dessas no catálogo

from dgi.acesso import BuscaDeImagemNoCatalogo, FacilitaDGI

facilita_dgi = FacilitaDGI("SEU_USUARIO_DO_CATALOGO", "SUA_SENHA_DO_CATALOGO")
catalogo_de_imagens_local = BuscaDeImagemNoCatalogo()

# Fazendo a busca
imagens = catalogo_de_imagens_local.busca_imagens_por_data("01/01/2019", "01/02/2019")

# Realizando o pedido com as imagens encontradas
informacoes_do_pedido = facilita_dgi.realiza_pedido(imagens)
  • (iii) Download das imagens

Com o pedido realizado, você receberá um link, onde estarão todas as imagens disponíveis para o download, para esta etapa o dgipy pode te ajudar com o download.

Para tal, basta pegar o link que o DGI/INPE te enviou e inserir no código abaixo.

from dgi.acesso import BuscaDeImagemNoCatalogo, FacilitaDGI

facilita_dgi = FacilitaDGI("SEU_USUARIO_DO_CATALOGO", "SUA_SENHA_DO_CATALOGO")
imagens_ja_baixadas = facilita_dgi.baixa_imagens_de_link_do_pedido(
    "LINK_DO_PEDIDO", "LOCAL_ONDE_SERA_SALVO")

Note que para a execução dos exemplos apresentados acima, é assumido que existe uma instância do MongoDB rodando em sua máquina. Para detalhes mais completos sobre toda a configuração do ambiente necessário para utilizar o dgipy, consulte a documentação do projeto

Documentação

Para aprender mais sobre o dgipy e suas possibilidades de utilização, consulte a documentação do projeto.

Project details


Download files

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

Files for dgi, version 0.8.6.2
Filename, size File type Python version Upload date Hashes
Filename, size dgi-0.8.6.2.tar.gz (14.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page