Skip to main content

DataHandler

Introdução​

Módulo para processamento especializado de dados hidrológicos de estações.

Índice​

  1. Visão Geral
  2. Estrutura Principal
  3. Data Handler
  4. Load data
  5. Preprocess data
  6. Load and preprocess data
  7. Cota Horaria Handler
  8. Inconsistencia Handler
  9. Adequacao Handler
  10. Mudanca RN Handler
  11. Estacao Handler
  12. Data handler factory
  13. Formatar JSON

Visão Geral ​

Sistema de processamento de dados com:

  • Classes especializadas por tipo de dado
  • Pré-processamento customizado
  • Carregamento assíncrono de dados
  • Integração com serviços externos via API

Data Handler ​

Classe base abstrata para manipulação de tipos de dados específicos.

Essa classe deve ser herdada por subclasses que implementam métodos específicos para tratar e adaptar diferentes tipos de dados para uso em outras estruturas.

Load data ​

Carrega dados de forma assíncrona. Parâmetro: token_manager (TokenManager): Gerenciador de tokens para autenticação.

**Returno: ** (pd.DataFrame | dict): Os dados obtidos através da API.

Preprocess data ​

Processa os dados carregados. Parâmetro: data (pd.DataFrame): Os dados obtidos com o carregamento assíncrono. Returno: (pd.DataFrame | dict): Dados após manipulações necessárias para o tipo de dado.

Load and preprocess data ​

Carrega os dados e aplica o pré-processamento.

Parâmetro: token_manager (TokenManager): Gerenciador de tokens para autenticação.

Returno: (pd.DataFrame | dict): Os dados pré-processados.

Cota Horaria Handler​

Classe para manipular dados de cota horária.

Inconsistencia Handler​

Classe para manipular dados de inconsistências.

Adequacao Handler​

Classe para manipular dados de adequações (exceto mudanças de RN).

Mudanca RN Handler​

Classe para manipular dados da adequação de Mudança de RN.

Estacao Handler​

Classe para manipular estações.

Data handler factory​

Redireciona o tipo de dado para o handler mais indicado.

Parâmetro: codigo (int): O código da estação. tipo_cota (StationType): O tipo da estação (regua/pcd). type (DataType): O tipo de dado relacionado às cotas.

Raises:** ValueError: Se o tipo for inválido.

Returns⭕ DataHandler: Subclasse de DataHandler para lidar com os dados da maneira adequada.Mudanca RN Handlera nam

Formatar JSON​

Formata os valores em um JSON para mostrar em uma tabela.

Parâmetro: json_str (str): String em formato JSON. mapeamento (dict): Dicionáio descrevendo como os dados da string devem ser representados.

Returno Any: Os dados mapeados.