Skip to main content

Data handler

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

Índice​

  1. Visão Geral
  2. Data Handler
  3. Cota Horaria Handler
  4. Inconsistencia Handler
  5. Adequacao Handler
  6. Mudança RN Handler
  7. Estação Handler
  8. Data Handler Factory
  9. 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

DataHandler​

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âmetros: token_manager (TokenManager): Gerenciador de tokens para autenticação.

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

Preprocess data​

Processa os dados carregados.

Parâmetros: data (pd.DataFrame): Os dados obtidos com o carregamento assíncrono.

Returns: (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.

Returns: (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âmetros: 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.

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.

Returns: Any: Os dados mapeados.