Adequação

Este módulo define as classes AdequacaoPlot e MudancaRNPlot, responsáveis pela exibição e visualização de dados hidrológicos relacionados a adequações e mudanças de Referência de Nível (RN) em gráficos interativos do Bokeh.

Índice

1. Visão Geral
2. Adequação Plot
   • Init
   • Setup data
   • Build plot
   • Create widgets
   • Create layout
3. Mudança RN plot
   • Init Mudança RN Plot
   • Setup data
   • Create widgets
   • Create layout

Visão Geral

O módulo plot_adequacao fornece classes especializadas para a visualização de dados hidrológicos no contexto de adequações e mudanças de RN. Ele integra:

• Carregamento de Dados Assíncrono: Busca dados de cotas adequadas, mudanças de RN e cotas horárias de APIs externas.
• Preparação de Dados: Pré-processa os DataFrames para garantir compatibilidade com os componentes de visualização do Bokeh.
• Criação de Widgets Bokeh: Constrói gráficos e tabelas interativas para apresentar os dados de forma clara.
• Layout Flexível: Organiza os elementos visuais em layouts otimizados para a análise de adequações e mudanças de RN.

Adequação Plot

Classe para a exibição do gráfico de uma adequação de cota horária.

Init

Inicializa uma nova instância de AdequacaoPlot.

Parâmetros: doc (Document): O documento Bokeh ao qual os elementos visuais serão adicionados. id_adequacao (int): O ID único da adequação a ser visualizada. codigo_estacao (int): O código da estação hidrológica. tipo (StationType): O tipo da estação ('regua' ou 'pcd'). token_manager (TokenManager): Uma instância do gerenciador de tokens para autenticação da API.

Setup data

Método assíncrono responsável por buscar e preparar os dados necessários para a visualização.

Build plot

Orquestra a criação dos widgets e do layout do gráfico, adicionando-o ao documento Bokeh.

Create widgets

Cria os componentes visuais (widgets) do Bokeh, incluindo oColumnDataSource, a DataTable e o gráfico principal.

Create layout

Define o layout da visualização, organizando os widgets em uma estrutura de linha.

Returns: row(self.table, self.plot): Um layout que exibe a tabela e o gráfico lado a lado.

Mudança RN plot

Classe para a exibição do gráfico de uma adequação de Mudança de RN, herdando funcionalidades de AdequacaoPlot.

Init Mudança RN Plot

Inicializa uma nova instância de MudancaRNPlot, chamando o construtor da classe pai e inicializando o adequador de RN.

Parâmetros: doc (Document): O documento Bokeh. id_adequacao (int): O ID único da adequação de mudança de RN. codigo_estacao (int): O código da estação. tipo (StationType): O tipo da estação. token_manager (TokenManager): Uma instância do gerenciador de tokens.

Atributos: self.adequador (AdjustRN): Uma instância da classe AdjustRN para algoritmos de ajuste de RN.

Setup data (Mudança RN plot)

Método assíncrono que busca e prepara os dados específicos para a visualização de mudança de RN.

Create widgets (Mudança RN plot)

Cria os componentes visuais específicos para a visualização de mudança de RN.

Create layout (Mudança RN plot)

Define o layout da visualização para a mudança de RN, organizando os widgets em uma estrutura de coluna.

Returns: column(self.plot): Um layout que exibe o gráfico em uma única coluna.