Pacote dgi.acesso

Pacote com módulos que facilitam a busca de imagens, realização de pedidos e downloads

Módulo dgi.acesso.busca

class dgi.acesso.busca.BuscaDeImagemNoCatalogo(db_props={'host': '127.0.0.1', 'porta': 27017})

Bases: object

Catalogo de imagens do LabISA (Banco de dados populado com os registros das imagens do DGI)

Args:

db_props (dict): Dicionário de configurações do acesso ao banco, possui as seguintes chaves:

host: str: Endereço de IP do banco de dados

porta: int: Porta do banco de dados

usuario: str: Usuário para utilizar o banco (Opcional)

senha: str: Senha para utilizar o banco (Opcional)

busca_image_por_quantidade_de_nuvem(q1: int, q2: int, q3: int, q4: int) → list

Método para busca de imagens levando em consideração a quantidade de nuvem em cada quadrante

Args:

q1 (int): Porcentagem de nuvem limite no quadrante 1

q2 (int): Porcentagem de nuvem limite no quadrante 2

q3 (int): Porcentagem de nuvem limite no quadrante 3

q4 (int): Porcentagem de nuvem limite no quadrante 4

Returns:

list: Lista com todas as imagens encontradas no filtro de nuvem

busca_imagens_dentro_do_shape(shape: list) → list

Método para busca de imagens através de uma lista de pontos

Args:

shape (list): Lista com as coordenadas do poligono que está sendo pesquisado

Returns:

list: Conjunto com todas as imagens em que seu ponto central faz intersecção com os elementos do poligono inserido pelo usuário

busca_imagens_por_data(data_inicial: str, data_final: str) → list

Método para busca de imagens utilizando um range de datas

Args:

data_inicial (str): Data inicial da busca (DD-MM-AAAA)

data_final (str): Data final da busca (DD-MM-AAAA)

Returns:

list: Lista com todas as imagens encontradas para o intervalo de datas inseridos

busca_imagens_por_data_e_instrumento(data_inicial: str, data_final: str, instrumento: str) → list

Método para busca de imagens através de range de datas e instrumentos

Args:

data_inicial (str): Data inicial da busca (DD-MM-AAAA)

data_final (str): Data final da busca (DD-MM-AAAA)

instrumento (str): Instrumento que registrou a imagem buscada

Returns:

list: Lista com todas as imagens encontradas para o intervalo de datas e pelo instrumento

busca_imagens_por_data_orbita_ponto_e_instrumento(orbita: int, ponto: int, data_inicial: str, data_final: str, instrumento: str) → list

Método para busca de imagens através de range de data, orbita-ponto e instrumento

Args:

data_inicial (str): Data inicial da busca (DD-MM-AAAA)

data_final (str): Data final da busca (DD-MM-AAAA)

orbita (int): Valor da orbita da imagem

ponto (int): Valor do ponto da imagem

instrumento (str): Instrumento que registrou a imagem buscada

Returns:

list: Lista com todas as encontradas

busca_imagens_por_instrumento(instrumento: str) → list

Método para busca de imagens através dos instrumentos de registro

Args:

instrumento (str): Instrumento que registrou a imagem buscada

Returns:

list: Lista com todas as imagens do instrumento

busca_imagens_por_instrumento_data_quantidade_de_nuvem(instrumento: str, data_inicial: str, data_final: str, quantidade_de_nuvem: dict) → list

Método para busca de imagens através de range de data, orbita-ponto e instrumento

Args:

instrumento (str): Instrumento que registrou a imagem buscada

data_inicial (str): Data inicial da busca (DD-MM-AAAA)

data_final (str): Data final da busca (DD-MM-AAAA)

quantidade_de_nuvem (dict): Dicionário contendo a porcentagem de nuvem de cada quadrante da imagem. As chaves deste dicionário são:

q1: int: Porcentagem de nuvem no primeiro quadrante

q2: int: Porcentagem de nuvem no segundo quadrante

q3: int: Porcentagem de nuvem no terceiro quadrante

q4: int: Porcentagem de nuvem no quarto quadrante

Returns:

list: Lista com todas as encontradas na orbita-ponto e instrumento definido

busca_imagens_por_intersec_ponto(lat: float, long: float) → list

Método para busca de imagens através da referência geográfica

Args:

lat (float): Latitude do ponto que está sendo buscado

long (float): Longitude do ponto que está sendo buscado

Returns:

list: Lista com todas as imagens que fazer intersecção com o ponto inserido

busca_imagens_por_orbita_ponto(orbita: int, ponto: int) → list

Método para busca de imagens através da orbita-ponto

Args:

orbita (int): Valor da orbita da imagem

ponto (int): Valor do ponto da imagem

Returns:

list: Lista com todas as imagens encontradas com a orbita ponto definida

busca_imagens_por_orbita_ponto_e_instrumento(orbita: int, ponto: int, instrumento: str) → list

Método para busca de imagens através de orbita-ponto e instrumento

Args:

orbita (int): Valor da orbita da imagem

ponto (int): Valor do ponto da imagem

instrumento (str): Instrumento que registrou a imagem buscada

Returns:

list: Lista com todas as encontradas na orbita-ponto e instrumento definido

busca_personalizada_de_imagens(op: dict) → list

Método para busca de imagens utilizando comandos do MongoDB

Args:

op (dict): Dicionário contendo os parâmetros de busca do MongoDB

Returns:

list: Lista com as imagens encontradas na busca personalizada

class dgi.acesso.busca.BuscaImagensJaBaixadas(db_props={'host': '127.0.0.1', 'porta': 27017})

Bases: object

Classe que possibilita a busca de imagens já baixadas na máquina

Args:

db_props (dict): Dicionário contendo as informações para conexão com o banco de dados, contendo as seguintes chaves

host: str: Endereço de IP do banco de dados

porta: int: Porta do banco de dados

usuario: str: Usuário para utilizar o banco (Opcional)

senha: str: Senha para utilizar o banco (Opcional)

recupera_todas_as_imagens_baixadas() → pandas.core.frame.DataFrame

Método recupera todas as imagens já baixadas na máquina

Returns:

pd.DataFrame: DataFrame com a relação de imagens e os locais onde foram originalmente salvas

recupera_todas_as_imagens_baixadas_por_instrumento(instrumento) → pandas.core.frame.DataFrame

Método para recuperar todas as imagens baixadas filtrada por instrumento

Args:

instrumento (str): Nome do instrumento

Returns:

pd.DataFrame: DataFrame com a relação de imagens e os locais onde foram originalmente salvas

Módulo dgi.acesso.facilidade

class dgi.acesso.facilidade.FacilitaDGI(usuario, senha, db_props={'host': '127.0.0.1', 'porta': 27017})

Bases: object

Classe que facilita a interação com o catálogo DGI/INPE

Args:

usuario (str): Nome de usuário no catálogo da DGI/INPE senha (str): Senha de usuário no catálogo da DGI/INPE db_props (dict): Dicionário contendo as informações para conexão com o banco de dados, contendo as seguintes chaves

host: str: Endereço de IP do banco de dados

porta: int: Porta do banco de dados

usuario: str: Usuário para utilizar o banco (Opcional)

senha: str: Senha para utilizar o banco (Opcional)

baixa_imagens_de_link_do_pedido()

realiza_pedido()

Módulo dgi.acesso.utils

dgi.acesso.utils.cria_documento_download(link) → dict

Função para gerar um JSON no formato que deve ser inserido nos registros de download do banco de dados

Args:

link (str): Link de onde as informações devem ser extraídas

Returns:remove_imagens_duplicadas

dict: Dicionário com as seguintes chaves

satelite: str: Nome do satélite que carrega o instrumento que capturou a imagem

instrumento: str: Nome do instrumento que capturou a imagem

data: str: Data da captura da imagem

orbita: str: Orbita da imagem

ponto: str: Ponto da imagem

dgi.acesso.utils.divide_lista(lista: list, n: int) → list

Função para dividir uma lista em N elementos

Args:

lista (list): Lista que deverá ser dividida

n (int): Quantidade de partes que devem ser gerada da lista inserida

Returns:

list: Lista contendo as listas divididas

dgi.acesso.utils.remove_imagens_duplicadas(lista_de_imagens: list) → set

Função para removação de imagens duplicadas em um conjunto de imagens

Aplica-se um filtro na busca de nomes duplicados, caso haja, estes são removidos

Args:

lista_de_imagens (list): Lista de imagens que serão filtradas

Returns:

set: Conjunto de imagens filtradas

dgi.acesso.utils.string_para_data(string: str, reverso=True, sep='/') → datetime.datetime

Função para transformação de string em data

Args:

string (str): String no formato DD{sep}MM{sep}AAAA

reverso (bool): Indica se a string inserida deve ser invertida

sep (str): Indica o separador entre cada elemento das datas

Returns:

datetime: String traduzida para datetime