Welcome to the SPHinXsys User Guide!

SPHinXsys (pronunciation: s’finksis) is an acronym from Smoothed Particle Hydrodynamics for industrial compleX systems. It provides C++ APIs for physical accurate simulation and aims to model coupled industrial dynamic systems including fluid, solid, multi-body dynamics and beyond with SPH (smoothed particle hydrodynamics), a meshless computational method using particle discretization.

Please check the detailed documentation of the code also on SPHinXsys’s GitHub, powered by Doxygen.

SPHinXsys is a multi-physics, multi-resolution SPH library. Although it is not a standalone application itself, many examples designated for the specific type of applications are provided.

Introduction

• The SPHinXsys library
• Fundamentals of SPH
• Unified modeling for fluid and solid dynamics
• Ownership design in SPHinXsys

Theory and numerical schemes

• Schemes for fluid dynamics
  • Governing equation
  • WCSPH method based on Riemann solvers
  • Wall boundary condition
  • SPH discretization as coarse-graining model
  • Transport-velocity formulation
  • Dual-criteria time stepping
• Schemes for solid dynamics
  • Kinematics and governing equation
  • Total Lagrangian formulation
• Schemes for thermal and mass diffusion
  • Governing equation
  • SPH discretization for the anisotropic diffusion equation
• Schemes for reaction-diffusion model
  • Governing equation
  • SPH method for reaction-diffusion
  • Reaction-by-reaction splitting
• Multi-resolution FSI coupling
• Position-based Verlet scheme
• Electromechanics
• Coupling with multi-body dynamics
  • Simbody library
  • SPHinXsys-Simbody coupling

SPHinXsys architecture overview

• SPHinXsys architecture overview
  • Constructing a SPHinXsys system
  • Carrying out a computation

SPHinXsys academic publications

• Academic Publications
  • Journal papers
  • Preprints on Arxiv

Installing SPHinXsys

• How to install SPHinXsys
  • Requirements
  • Installing on Ubuntu
  • Installing SYCL version on Ubuntu
  • Installing on Windows
  • Installing on macOS (latest)

Creating your own cases

• Creating your own cases

Set regression test for a new case

• Set regression test for a new case
  • Observation variables
  • Change the monitoring class
  • Generate database
  • Test with the database
  • Other comments:

Examples:

• Example 1: 2D dam break

• Example 2: Elastic water gate

• Example 3: 3D Multi-resolution isotropic particle distribution of complex geometries

• Example 4: 2D Multi-resolution isotropic particle distribution of complex geometries

• Example 5: 2D Taylor-Green vortex

• Example 6: Heat transfer

• Example 7: 2D diffusion

• Example 8: Hydrostatic water column on an elastic plate

• Example 9: 2D static confinement

• Example 10: Shell cases: a 2D thin plate

• Example 11: Shell cases: a 3D arch

• Example 12: Flow around a cylinder

• Example 13: 2D oscillating beam

• Example 14: 2D bifurcation flow

• Example 15: 2D aortic valve

• Example 16: 2D Channel flow

• Example 17: 2D throat

• Example 18: 2D wetting

Contribute to SPHinXsys

• Contribute to SPHinXsys
  • Credit your contribution
  • Support your contribution
  • Contribute new features
  • Contribute new test cases
  • Contribute challenging benchmarks

How to cite SPHinXsys?

• How to cite SPHinXsys?