SPH
Graphical interface of the code

Main rendering window

Automatically updated during the simulation. The refresh interval can be modified using GuiSettingsId::VIEW_MAX_FRAMERATE parameter. Note that rendering is a considerable performance overhead and overly frequent updates will thus slow down the simulation.

Controls:

  • Left-click + drag to pan the view
  • Right-click + drag to rotate the view
  • Mouse wheel to zoom in/out
  • Left-click a particle to view its position and other data
  • Double-click the color palette to customize particle colors

Plot view

Located on right side of the window, there are currently two panels for drawing plots. The list of plots to display can be specified in settings, see parameter GuiSettingsId::PLOT_INTEGRALS. Plots are automatically updated during the simulation. The period of update is set by parameter GuiSettingsId::PLOT_INITIAL_PERIOD. While most of the plots are 'lightweight' and have negligible performance penalty, the plots computing size-frequency distributions of fragments (PlotEnum::CURRENT_SFD and PlotEnum::PREDICTED_SFD) take much longer to compute and it is thus not recommended to recompute them frequently.

Controls:

  • Right-click the panel to select a different plot to display
  • Double-click to open a larger window with plot axes

Selection of quantities

Code can visualize quantities. Most directly correspond to physical quantities in the simulation (pressure, specific energy, ...). Some "special" quantities are:

  • Neigh. cnt - Number of neighbours of each particle.
  • Marker - Helper quantity rendering all particles with very bright color. Mainly useful to see all particles when rendering with antialiasing.
  • Beauty - Ad hoc quantity attempting to show real-world look. It assigns colors based on internal energy.
  • Flags - Shows original bodies in the simulation, i.e. target and impactor have different colors.
  • Particle ID - Assigns random color to each particle. The colors can change if particles are being merged or removed.
  • Component ID - This quantity has two modes:
    • Connected particles - connected or overlapping particles are rendered with the same color
    • Bound particles - gravitationally bound particles (i.e. relative speed is lower than the escape speed) are rendered with the same color
  • Boundary - Detects boundary particles.
  • Uvws - Shows texture mapping coordinates.
  • Radius - Assigns colors based on particle smoothing lengths or radii.
  • Summed density - Density computed by SPH summation of neighbouring particles, it may differ from the actual density used in the simulation.
  • Delta density - Relative change of a density, i.e. \(\rho / \rho_0 - 1\).
  • Corot. velocity - Shows particle velocities in the corotating frame.

Not all of these are available in every simulation, for example Pressure will not be displayed for N-body simulation, etc.

Surface reconstruction

Rendering of the implicit surface