Troubleshooting
- Make sure the vector quantities are correctly defined.
- Make sure that there are no input scalar values where there should be vectors and vice versa.
- Make sure that the Min/Max boundary values are actually set in order, for example, -0.04 > -0.1).
- Check the reference values, especially reference velocity.
- Check for overlapping particles.
- Make sure your units are consistent.
- Carefully read the .log file and mind the warnings.
- Analysis of the Shepard coefficient (after utilizing nFX[c] or through ParaView’s SPH Volume Interpolator).
- Analysis of the information files for the FLUID phases.
The Shepard coefficient can be used to identify areas of excessive particle compression or rarefaction (Shepard coefficient in these cases is higher than 1.01 or lower than 0.99; where truly critical areas have Shepard coefficient higher than 1.1 or lower than 0.9). This holds particularly true if looking at time averaged values of the Shepard coefficient, which may indicate areas with chronic numerical issues (throughout the simulation).
Using FLUID information files (if enabled for output) is also a good way to monitor the stability of the simulation. In order to help show how this can be done, an example case is provided and its outputs for two different setups.
The case is a 5-speed motorcycle gearbox with around 8 million particles in total and around 2 million air particles in the domain.
The first case has the reference velocity (ref_vel) set to 4.53 m/s and the second case has the reference velocity set to 6.18 m/s. This causes a difference in the time step, with the time step being smaller for the second case (higher ref_vel).
When analyzing the information file of the FLUID phase, find the Npart(RHO>1.1*RHO_0) and Npart(RHO>1.2*RHO_0) files. These files indicate the number of particles which exceed the nominal density of the fluid by 10 and 20 percent respectively. These numbers, while not an ideal or universal indicator, can help assess the simulation quality. For example, please see Figure 1 below where we show the comparison of the above mentioned cases.
The results show that the case with the lower ref_vel (higher time step) has higher number of particles exceed both 10 and 20 percent thresholds, implying regular violation of the CFL condition. With the steady increase of the number of hot particles and considerable amount of particles exceeding 20 percent of nominal density the case with lower reference velocity would be deemed as flawed and solution is corrupted.
![](../../images/nfx_information_file_plots.png)
Figure 1. . Information file plots of particles exceeding 10 and 20% of . The red lines show results from the case with ref_vel = 4.53 m/s and the green line shows results from the simulation with ref_vel = 6.18 m/s.
While by no means is this type of analysis an absolute or universal measure of simulation quality, it is an extremely useful tool and can be a good starting point to troubleshoot a simulation.