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 |
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.
