Skip to content

Releases: Xiangyu-Hu/SPHinXsys

Linear gradient kernel correction generally applicable

09 Apr 07:39
Choose a tag to compare

Other new features, revision and bug fixes:

  1. Now, due to our new hourglass control method, the total Lagrangian SPH for solid dynamics is very stable for arbitrary materials.
  2. Dual time-step criteria method improved to achieve angular momentum conservation for inviscid flows.
  3. General continuum SPH model is developed for soil applications.
  4. Gravity, viscous force and other force can be updated in arbitrary frequency.
  5. Now, SPHinXsys naturally generalized mesh-based FVM method as a special case of SPH algorithm.
  6. Thermal optimization is included to shown the embedded optimization function in SPHinXsys.
  7. Novel pressure boundary condition is added for general channel flows.
  8. Coupling between fluid and one-side shell interactions is presented.
  9. Violent two phase flows can be robustly simulated with high resolutions.
  10. Transport formulation correction is now limited for flow region only with considerable zero-order consistency error.

Preview release of the GPU version using SYCL

10 Dec 07:26
Choose a tag to compare

This is a preview release of SPHinXsys in GPU version.
Currently, only the dam-break cases are running on GPU.
Please feel free to fork, try and test the performance.

For installing this version, please follow the instruction from

If you have any suggestion or comments, please use the issue and discussion page.
You can also contact me ( for possible collaborations on the GPU version.

New features & bug fix

26 May 08:55
Choose a tag to compare
  1. Now, the shell model is matured, we have provided with several new challenging cases.
  2. We have provided kernel correction method to solved the long standing excessive dissipation problem for general free surface flows.
  3. Bug in wall treatment Riemann problem is fixed.
  4. Free surface density evaluation fixed so the that free surface level is must more accurate now.
  5. New complex boundary conditions for diffusion reaction dynamics introduced. Now, SPHinXsys can handle heat transfer with arbitrary types of boundary conditions together.
  6. Python interface is provided for running and control SPHinXsys simulation in python environment.

Installation notes: install pybind11 in vcpkg is required.

Bug fix on Riemann solver and thin shell dynamics for better numerical stability

28 Feb 14:00
Choose a tag to compare

In this release, two important bug fixes have been included.

  1. Riemann solver will still be used for fluid-wall interaction, since some cases occasionally lead to very small times steps,
    especially when the resolution is high.
    2, The bug on numerical dissipation for thin shell structure has been corrected.
    Now the simulation of thin shell problems do not require smaller time steps any more.

Eigen library, new features and faster fluid dynamics

03 Dec 23:07
Choose a tag to compare

In this release, the new features are:

  1. The library uses Eigen 3 for vector and matrix operations.
  2. The fluid dynamics has been further accelerated more than 30%.
  3. Dynamics algorithms are explicitly defined in case file.
  4. Level-set topological correction introduced for to great robustness in particle generation.
  5. Particle split and merge algorithms are included with a new dam-break case.
  6. Adaptive particle sizes and variable smoothing lengths can be used for fluid dynamics simulation.

Please check the project website for the updated installation instructions for Linux and Windows systems.
You are welcomed to try and comment this new release.

New features on geometry, contact and particle generation

17 Jun 14:19
Choose a tag to compare

In this release, the new features are:

  1. New geometric shape which is much faster than triangular mesh is introduced.
  2. General coordinate transformation is introduced to all shapes.
  3. Contact between volumetric and surface structures is introduced.
  4. Particle generation is generalized for volumetric and surface particles.
  5. Construction of adaptation, particles and materials now are based on factory methods.

Installation note:
Eigen 3 library is required for this release. You can download it from
The eigen library source should be put in the folder 3rd_party/eigen.

Validated shell models and Eulerian formulations

08 Feb 06:00
Choose a tag to compare

In this release,
besides the bug related free-stream boundary condition is fixed.
the shell models have been validated with classical tests from literature.
Another new feature is the Eulerian formulations.
Currently, weakly compressible and fully compressible formulation are implemented and validated with typical cases.
Using particle relaxation, SPHinXsys is able to simulate classical aerodynamic and gas-dynamics problems.

You are welcome to test and comment!

New features on memory safty and regression test

19 Dec 15:48
Choose a tag to compare

In this new release, we have first introduced a new feature of regression test,
so that the simulation results of test cases will be compared with previous computed results.
This will eliminate hidden bugs which do not blowup the simulations.
The second updates in the release is the enforcement of Resource acquisition is initialization (RAII),
so that memory leaking which often due to new raw pointers will be avoided.
For this, the ownership of objects are explicitly defined with the help of smart pointers.
Since these smart pointers are only involved in object constructors,
the usage and efficiency of raw pointers (as observers) for computation was not influenced.

You are welcomed to test and report issues.

New feature of self-contact with examples (windows compatible version)

24 Sep 11:12
Choose a tag to compare

In this release self-contact between solid bodies are included with two examples.

To install this release, you need to install google test.

We also provide the dependent free version of the library,
by which, all the dependent headers and cpp files will be included in a single project.

You are welcome to test,
and report bugs by using "Issues" of the repository.

Cmake bug cleaned

23 Sep 09:37
Choose a tag to compare

The bug, which leads to Cmake error message, is cleaned.
There is still bug due to the incompatibility between windows and linux.
Please download the newest release version.