Como levar um modelo QUAL2K / QUAL2Kw do Excel para o motor web

O QUAL2K e o QUAL2Kw são distribuídos como planilhas do Microsoft Excel com macros VBA e um executável Fortran. Isso exige Windows e Excel com as macros habilitadas, e modelos grandes podem ficar lentos ou travar dentro do VBA. O motor da Hydrolitica é uma versão independente em Python do solucionador do QUAL2Kw 5.1 que funciona no navegador: você pode abrir diretamente uma planilha existente, sem digitar os dados de novo.

Figura 1: Da planilha QUAL2Kw aos resultados no navegador

Importação em um único passo

Abra o motor com a janela de importação (ou use Importar planilha QUAL2Kw na barra de ferramentas do motor) e escolha o seu arquivo .xls, .xlsx ou .xlsm. A planilha é lida no seu navegador; apenas os valores das células das abas de entrada são enviados ao motor, então planilhas grandes (dezenas de MB) não são problema.
Leia o relatório de importação. Ele lista o que foi transferido e avisa sobre o que não foi (veja a tabela abaixo).
Revise as etapas do assistente e clique em Executar. Se quiser conferir a versão em Python por conta própria, compare os resultados com as abas WQ Output, WQ Min, WQ Max e Temperature Output da própria planilha.

Formatos suportados: QUAL2Kw 5.1 clássico e o formato HTS/STS mais recente. Planilhas xQUAL2Kw dendríticas (com vários ramos) ainda não podem ser importadas diretamente. Na nossa validação de setembro de 2026, o motor reproduziu as abas de resultados de 15 modelos calibrados dentro de 5% (ou de uma pequena faixa absoluta), e as médias diárias se mantiveram depois de passar cada planilha por este importador. Veja os resultados da validação (em inglês).

Excel/VBA ou o motor web

Planilha QUAL2Kw em comparação com o motor da Hydrolitica

Tema	Planilha QUAL2Kw	Motor da Hydrolitica
Plataforma	Windows com Excel e macros habilitadas	Qualquer navegador moderno (Windows, macOS, Linux, Chromebook)
Entrada do modelo	Edição de células em muitas abas	Importar a planilha, ou o assistente guiado de 14 etapas, ou JSON / CSV
Solucionador	VBA e o executável Fortran qual2kw5.exe	Versão em Python do solucionador do QUAL2Kw 5.1 (Euler explícito), executada na nuvem
Tempo de execução	Depende do computador e do modelo	De segundos a alguns minutos; o limite é de 300 segundos por execução
Calibração	Manual, ou o algoritmo genético da planilha	Calibração automática de 18 taxas cinéticas com base em dados observados (conta gratuita)
Variáveis de estado	17 variáveis de qualidade da água mais temperatura	As mesmas 17 mais temperatura, com o pH calculado a cada passo
Resultados	Abas de saída e gráficos	Média, mínimo e máximo diários por trecho; gráficos, CSV e relatório em PDF
Salvamento	O arquivo .xlsm	Salvamento na nuvem com uma conta, além de exportação em JSON / CSV

O que o importador transfere

Aba da planilha e etapa correspondente do assistente

Aba da planilha	Etapa do assistente	Observações
QUAL2K	1. Configuração do projeto	Nome, data, fuso horário, passo de cálculo e opções da simulação (lidos pelo rótulo, então os dois formatos funcionam)
Reach	2. Definição dos trechos	Geometria, n de Manning ou curvas-chave, vertedouros, cotas, coordenadas
Headwater	3. Cabeceira	Vazão, temperatura e qualidade da água
Point Sources	4. Fontes pontuais	Localização, vazão de entrada ou captação, concentrações
Diffuse Sources	5. Fontes difusas	Intervalo de localização, vazão, concentrações
Rates	6. Taxas cinéticas	Lidas por seção e rótulo, como o VBA as lê
Reach Rates	7. Taxas por trecho	Valores específicos de cada trecho, todas as colunas
Light and Heat	8. Luz e calor	Opções de radiação solar, onda longa e vento
Abas de meteorologia	9. Meteorologia	Temperatura do ar e do ponto de orvalho, vento, nebulosidade, sombreamento
Initial conditions	12. Condições iniciais	Valores iniciais, algas de fundo

O que não é importado

Cargas de fontes pontuais que variam ao longo do dia são importadas pela sua média diária (o assistente não tem formulário de fonte pontual com ciclo diário). O relatório de importação avisa quando isso acontece.
Os dados observados (aba WQ Data) não são importados: informe os alvos da calibração na etapa Dados observados.
Código VBA personalizado adicionado a uma planilha não é executado; apenas os cálculos padrão do QUAL2Kw.
O método de integração: o motor sempre integra com Euler explícito, então uma planilha configurada com Runge-Kutta ou passo adaptativo é executada com Euler.
A cinética do biofilme hiporreico e a zona de armazenamento transitório superficial (versão HTS/STS) não são simuladas; o motor avisa quando um modelo ativa a zona de armazenamento transitório.
Planilhas xQUAL2Kw dendríticas (com vários ramos): divida-as antes em uma planilha por ramo.
Uma planilha sem latitude e longitude nos trechos é executada com o sol em 0 grau, 0 grau, exatamente como o QUAL2Kw faz; o motor avisa.

Problemas comuns

Problema	Causa	Solução
A execução para aos 300 segundos	Modelo grande com passo de tempo pequeno, sobretudo com diagênese de sedimentos	Use um passo de cálculo maior ou divida o rio
Aviso sobre a radiação solar após a importação	Os trechos não têm latitude / longitude	Adicione as coordenadas na Configuração do projeto ou nos trechos
OD de saturação alto demais	Cota deixada em 0 m	Informe as cotas dos trechos
O relatório de importação lista fontes pontuais com ciclo diário	A planilha varia as cargas ao longo do dia	Verifique se a média diária é aceitável para o seu estudo

Se o problema estiver na própria planilha do Excel (Erro 53, uma parada em ChDir ThisWorkbook.Path, "is aborted!" ou macros bloqueadas), veja erros do QUAL2K e do QUAL2Kw e como corrigi-los (artigo em inglês).