Solução de Problemas¶

Problemas comuns e como resolvê-los ao trabalhar com o DWSIM, a FluentAPI e o MCP Server.

Problemas de Convergência do Solver¶

Sintoma: o solver falha ou oscila¶

Causas comuns:

Especificações inconsistentes (por exemplo, temperatura e fração de vapor = 0 abaixo do ponto de bolha)
Estimativas iniciais ruins para correntes de reciclo
Pacote termodinâmico inadequado para o sistema

Correções:

Reverifique as especificações de corrente quanto à consistência física
Forneça uma estimativa inicial razoável para correntes de reciclo (faça primeiro uma varredura direta)
Aumente a tolerância do solver temporariamente para ver resultados parciais, depois aperte
Para colunas: tente um número menor de estágios primeiro, depois aumente
Para reatores: comece com baixa conversão ou baixo grau de avanço da reação

Sintoma: coluna de destilação não converge¶

Causas comuns:

Condição térmica da alimentação distante da saturação
Combinação errada de razão de refluxo + vazão de fundo (especificação inviável)
Estágios insuficientes para a separação requerida

Correções:

Pré-aqueça a alimentação até seu ponto de bolha
Tente pares alternativos de especificação (por exemplo, vazão de destilado + vazão de fundo em vez de refluxo + fundo)
Adicione 5-10 estágios e tente novamente
Aumente ligeiramente a razão de refluxo

Sintoma: malha de reciclo diverge¶

Causas comuns:

Forte não linearidade na malha
Pacote termodinâmico apresentando comportamento descontínuo perto de uma fronteira de fase

Correções:

Use a aceleração de Wegstein da operação unitária Recycle (padrão)
Especifique manualmente uma estimativa de tear stream próxima da solução esperada
Verifique se alguma unidade na malha tem múltiplas soluções (por exemplo, reator com múltiplas raízes)

Problemas de Pacotes Termodinâmicos¶

Sintoma: valores de densidade ou entalpia parecem errados¶

Diagnóstico:

Compare com NIST WebBook para componentes puros
Verifique se o pacote é apropriado (veja Guia de Pacotes Termodinâmicos)
Verifique se temperatura e pressão estão dentro da faixa válida

Sintoma: previsão VLE não acerta o azeótropo¶

Causa comum: Usar PR ou Lei de Raoult para uma mistura polar.

Correção: Mude para NRTL ou UNIQUAC.

Sintoma: resultados diferem entre dois pacotes termodinâmicos¶

Isso é normal. Modelos diferentes extrapolam de formas diferentes fora de sua faixa válida. Decida qual modelo é mais confiável para suas condições:

Para hidrocarbonetos em pressão moderada: PR é geralmente o melhor
Para misturas polares/aquosas: NRTL ou UNIQUAC
Para água pura/vapor: sempre Steam Tables

Problemas da FluentAPI¶

Sintoma: ImportError ou DLL não encontrada¶

Causas comuns:

DWSIM não instalado ou não no PATH
Versão errada do .NET (DWSIM usa .NET Framework 4.7.2 no Windows)
Incompatibilidade entre Python 32 bits e 64 bits

Correções:

Verifique se python -c "import DWSIM" funciona
Use Python 64 bits com DWSIM 64 bits
Verifique se pythonnet (pip install pythonnet) está instalado
Defina a pasta bin do DWSIM em os.environ['PATH'] antes de importar

Sintoma: métodos de extensão Q.Kelvin ou .Atm() indisponíveis¶

Os helpers de quantidade Q e os métodos de extensão Pascal/Kelvin fazem parte do namespace da FluentAPI. Garanta que você os importou:

from DWSIM.Automation.FluentAPI import Flowsheet, PropertyPackages, Q

Para extensões no estilo VB em literais numéricos (100.Kelvin()), a sintaxe do Python é diferente: use Q.Kelvin(100) em vez disso.

Sintoma: AttributeError em um método do builder¶

A FluentAPI evolui; verifique os nomes atuais dos métodos na referência da FluentAPI (DWSIM.FluentAPI/docs/api/index.md).

Problemas do MCP Server¶

Sintoma: ferramenta retorna erro "Unknown tool"¶

O nome da ferramenta pode estar errado ou o servidor pode estar rodando uma versão mais antiga. Verifique as ferramentas disponíveis:

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Sintoma: flowsheet_id não encontrado¶

Cada flowsheet tem um ID único com escopo de sessão. Se você reiniciar o MCP server, os IDs são perdidos. Salve o flowsheet em disco antes de parar o servidor.

Sintoma: o solver retorna erros mas meu flowsheet parece correto¶

Leia o array errors na resposta do solve. Cada entrada informa qual objeto falhou e por quê.

Funcionalidades da Edição Plus / Patreon¶

Se você ver erros "Plus required", a operação requer ativação do DWSIM Plus / Patreon Edition:

Osmose Reversa
Operações unitárias de refino (HDS, Reformer, FCC, etc.)
Módulo TEA
Módulo LCA
Electrolyte NRTL

Para ativar, siga o guia Patron Activation na documentação da FluentAPI (DWSIM.FluentAPI/docs/getting-started/patron-activation.md).

Problemas de Desempenho¶

Sintoma: as simulações demoram muito¶

Causas comuns:

Número grande de componentes (> 30) com pacotes termodinâmicos rigorosos
Malha de reciclo com convergência lenta
Coluna de destilação com muitos estágios

Correções:

Agrupe componentes similares em pseudocomponentes
Use um pacote termodinâmico mais simples para triagem; mude para um rigoroso no projeto final
Reduza a tolerância do solver para iterações iniciais; aperte para o solve final

Sintoma: out of memory¶

Causas comuns:

Simulações muito grandes
Vazamentos de memória ao executar muitas simulações em um laço Python sem limpeza

Correções:

Reinicie o processo Python entre execuções grandes
Chame fs.Dispose() (ou equivalente) após cada simulação
Use Python e DWSIM 64 bits

Obtendo Ajuda¶

Fóruns do DWSIM: https://www.dwsim.org/forum
GitHub Issues: https://github.com/DanWBR/dwsim
Documentação: veja DWSIM.FluentAPI/docs/, DWSIM.MCPServer/docs/ e a ajuda principal do DWSIM em PlatformFiles/Common/docs/dwsim-help/
Testes de Validação: DWSIM.Validation.Tests/ contém simulações de exemplo testadas