Metadata-Version: 2.1
Name: dgi
Version: 0.8.6.2
Summary: Ferramenta para facilitar o acesso aos dados disponibilizados pelo DGI/INPE.
Home-page: https://gitlab.com/labisa/catalogo-de-imagens/dgi-dumps
Author: Laboratório de Instrumentação de Sistemas Aquáticos (LabISA)
Author-email: felipe.carlos@fatec.sp.gov.br
License: UNKNOWN
Description: # dgipy
        
        [![Documentation Status](https://readthedocs.org/projects/dgipy/badge/?version=latest)](https://dgipy.readthedocs.io/en/latest/?badge=latest)
        
        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
        
        ```shell
        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
        
        ```shell
        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
        
        ```python
        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
        
        ```python
        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.
        
        ```python
        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](https://dgipy.readthedocs.io/en/latest/)
        
        ## Documentação
        
        Para aprender mais sobre o dgipy e suas possibilidades de utilização, consulte a [documentação do projeto](https://dgipy.readthedocs.io/en/latest/).
        
Keywords: dgi,inpe,ferramenta,facilidade
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
