CAPÍTULO 19

Troubleshooting

Sintomas comuns, causas prováveis e ações recomendadas para resolução rápida.

19.1 STL não aparece

Causas prováveis: arquivo não foi importado de fato (falha silenciosa de I/O); escala muito pequena ou muito grande (geometria fora do viewport); câmera posicionada longe da geometria; caminho do arquivo inválido após mover o projeto; STL removido da pasta original entre execuções; material/transparência dificultando a visualização.

Ações: use Reset de câmera; abra Informações do STL para conferir caminho e dimensões; confira a escala e o bounding box; verifique a lista de STLs ativos; salve e reabra o projeto.

19.2 Partículas não aparecem

Causas prováveis: simulação ainda não gerou .bin; pasta de resultados incorreta; snapshots não carregados; o snapshot exibido é antigo/esparso; inlet não foi adicionado à lista (configurado mas não incluído); simulação terminou sem partículas (N=0). Ação: verifique o caminho da pasta de resultados, recarregue snapshots, navegue até um snapshot denso e confirme que o inlet aparece em Itens Configurados.

19.3 Inlet não injeta

Verifique: tempo inicial e final do inlet; valores de fluxo de massa ou de partículas; velocidade de injeção (não pode ser nula); direção da normal (causa mais comum de inlet inerte); material atribuído ao inlet; posição dentro do domínio computacional; se o inlet foi adicionado à lista; possível colisão inicial com geometria.

19.4 Outlet não remove

Verifique: direção da normal; geometria do plano/região de remoção; se as partículas realmente cruzam a região; eventual offset ao longo da normal; intervalo de tempo ativo do outlet.

19.5 Geometria com movimento incorreto

Verifique: tipo de movimento selecionado; vetor de velocidade; centro de rotação (no caso de movimento rotacional); unidade de velocidade angular (rad/s, não °/s); rampa de aceleração; eixo visual e preview do movimento ao longo do tempo.

19.6 Simulação instável

Sintomas: partículas "explodem" para fora do domínio; energia cinética cresce sem limite; sobreposição δₙ alta (acima de ~1–2% do raio); velocidades irreais; solver ou GPU geram erro de overflow.

Ação recomendada (em ordem): (1) reduza Δt pela metade e teste novamente; (2) verifique se há partículas nascendo dentro da geometria (sobreposição inicial); (3) reduza a velocidade inicial das partículas no inlet; (4) verifique a qualidade da malha STL; (5) considere reduzir o módulo elástico mantendo o tempo de colisão equivalente.

Instabilidade após fragmentação

O menor fragmento pode exigir passo menor que as partículas alimentadas. Confira a sugestão da GUI; use 12.6 para escolher e aplicar o passo. Não trate d_min como tamanho mínimo garantido de nascimento. Antes de reduzir Young, preserve a coerência da calibração DWT e das paredes (10.7).

Interação capilar ausente ou inventário inesperado

Confira se Ponte líquida está selecionada na coesão do par: teor positivo sozinho não a ativa. Revise propriedades globais, ângulo, limite por ponte, estoque superficial e campos gravados. A interpretação dos volumes está no Capítulo 16. Consulte 28.7 para combinações com clumps e quebra.

19.7 Tabela rápida de sintomas e ações

SINTOMA PRIMEIRA AÇÃO
Partículas atravessam parede Reduzir Δt; aumentar densidade da malha STL
Energia cresce sem causa Reduzir Δt; revisar sobreposições iniciais
Caso roda lento demais Ativar busca Verlet; usar mais threads; avaliar GPU em caso grande
Pilha não estabiliza Aumentar μ, μ_r; verificar amortecimento (cₙ)
Hopper entope sempre Reduzir μ ou coesão; rever ângulo da geometria
Drum não cascateia Aumentar rotação; verificar atrito partícula-parede
Resultados CPU/GPU diferentes Rodar caso de validação simples; comparar tendências, não valores absolutos

19.8 Estratégias para divergência numérica

Quando a simulação diverge — energia cinética cresce sem limite, partículas escapam do domínio, sobreposição δₙ acima de ~1–2 % do raio, velocidades irreais ou NaN/overflow no console — ataque o problema em três frentes, nesta ordem: passo de tempo, depois materiais e interações, depois a malha. Mude um fator de cada vez e re-rode um trecho curto para isolar a causa.

Primeira ação — passo de tempo

A divergência quase sempre começa por Δt grande demais. Reduza Δt pela metade e observe: se a energia para de crescer, o passo era a causa. Em modo automático, reduza o fator de Rayleigh (α_R) de 0,30 para 0,15–0,20; com coesão ou contatos muito rígidos, vá a 0,05–0,10. Faça um estudo de convergência: divida Δt sucessivamente até que a grandeza de interesse (vazão, ângulo, força) pare de mudar.

Ajuste de materiais

SINTOMA AJUSTE NO MATERIAL POR QUÊ
Contatos rígidos exigem Δt minúsculo Reduzir o módulo de Young E (ex.: de 10⁹ para 10⁷–10⁸ Pa) Amolece o contato e alonga o tempo de colisão; exige verificar sobreposição e resposta calibrada, especialmente em DWT/quebra
Pilha "explode" ao tocar Reduzir eₙ (mais dissipação) e conferir a densidade ρ eₙ alto conserva energia de impacto; eₙ menor amortece
Partículas vibram/tremem paradas Aumentar amortecimento (eₙ menor) ou rever raio mínimo Rigidez alta + Δt no limite gera ressonância numérica
Pilha escorrega demais Aumentar μ e ativar μ_r (rolamento) Reproduz o travamento de grãos angulares
Antes de reduzir E: confirme convergência de Δt e sobreposições. Reduzir E muda tempo de contato e energia absorvida; pouca sensibilidade em um escoamento não demonstra independência em quebra. Revalide a grandeza de interesse e mantenha partículas, paredes e overrides coerentes com a calibração (10.7).

Ajuste de interações

A interação é o par material × material — calibre o par, não só os materiais isolados. Para divergência:

  • Restituição do par eₙ — se o par partícula–parede devolve energia demais (partículas quicando sem parar), reduza eₙ da interação específica;
  • Atrito μ — atrito muito baixo deixa o material fluir como líquido e nunca estabilizar; comece em μ ≈ 0,3–0,5 e calibre pelo ângulo de repouso;
  • Rolamento μ_r — esferas sem resistência ao rolamento formam pilhas instáveis; ative o modelo CDT com μ_r > 0;
  • Coesão — coesão exige Δt menor; se ativou coesão e o caso divergiu, reduza Δt antes de qualquer outra coisa e confirme que k (ou γ) não está ordens de grandeza acima do físico;
  • Sobrescrições de par — confira se uma sobrescrição manual (kₙ, cₙ) não introduziu uma rigidez incompatível com o Δt.

Ajuste da malha (STL)

Geometrias STL mal preparadas são uma causa frequente de fuga de partículas e instabilidade de contato:

  • Triângulos grandes demais — se um triângulo é muito maior que as partículas, o contato pode "vazar" pelas bordas; remalhe para que cada triângulo tenha tamanho comparável a alguns diâmetros de partícula;
  • Triângulos minúsculos / slivers — triângulos finos e degenerados geram normais ruins e força errática; limpe a malha antes de importar;
  • Normais invertidas — normais apontando para o lado errado fazem a partícula ser empurrada para dentro da parede; verifique a orientação das faces;
  • Buracos / não-estanque — furos na malha deixam partículas escaparem; use uma geometria fechada (watertight) para contornos;
  • Sobreposição inicial — partículas nascendo dentro da malha recebem força enorme no primeiro passo; afaste o inlet da parede ou reduza a velocidade de injeção.
Roteiro rápido de diagnóstico — (1) Δt pela metade; (2) sobreposição inicial (partículas dentro de geometria?); (3) velocidade do inlet; (4) qualidade da malha STL (tamanho de triângulo, normais, estanqueidade); (5) reduzir E mantendo a sobreposição < 1 %; (6) revisar μ, μ_r e eₙ do par em conflito. Após cada mudança, rode um trecho curto e compare a curva de energia cinética.