Skip to content
Jose Luis Cercos-Pita edited this page Jan 22, 2025 · 8 revisions

AQUAgpusph

Welcome to the wiki of AQUAgpusph, the SPH of the researchers, by the researchers and for the researchers.

AQUAgpusph is a Smoothed-Particle Hydrodynamics (SPH) simulation tool, accelerated by OpenCL and featuring a huge customizability, at a point that some other methods like Lattice Boltzmann Method (LBM) pipelines have been implemented.

If you are a SPH researcher and you need to deal with new formulations, AQUAgpusph is your solver! AQUAgpusph is also a nice solver if you need to deal with complex geometries on a simple way.

Features

Free software

We respect your rights as a user and as a human being. AQUAgpusph is hereby a free software, licensed under the GPL v3 license terms.

OpenCL

As abovementioned, AQUAgpusph is accelerated with OpenCL. Thus it can run on multiple hardwares of different kinds, vendored by different manufacturers. More specifically, AQUAgpusph has been successfully tested on the following platforms:

On POCL platforms the Assertion tools would not work though, because of an unresolved bug. Whereas GPUs can be used with the OpenCL ICDs provided by the manufacturers, it is strongly recommended to use Rusticl instead, which has demonstrated a great performance.

Highly customizable

AQUAgpusph is meant to play with it. It is your sandbox for SPH! Along this line the pipeline can be edited without touching a single line of the core source code. Below you can find documentation about how to create your own pipelines with your own formulation.

Batteries loaded

AQUAgpusph already provides several of the most proficient SPH formulations, like $\delta$-SPH, or the implicit midpoint time integrator. The list of available modules (so called presets) is described here.

First steps with AQUAgpusph

You may start learning how to download and install AQUAgpusph. After that you may want top take a look to the examples, or to the available presets.

After that you are probably interested on reading how to create your own pipeline, and how to create a simulation from scratch, considering a compex geometry.

Citing

If you are using AQUAgpusph or it helped you in any other way, please cite the following paper:

  • Cercos-Pita, J. L. (2015). AQUAgpusph, a new free 3D SPH solver accelerated with OpenCL. Computer Physics Communications, 192, 295-312.

You can find a more comprehesive list of publications and media related to AQUAgpusph here

AQUAgpusph: A free SPH software accelerated with OpenCL

AQUAgpusph is a free SPH solver developed by the CEHINAV group.

The main features of AQUAgpusph are:

  • It is free software, so you are welcomed to use, edit and distribute it.
  • It is accelerated with OpenCL.
  • It is enforced with a wide variety of boundary conditions.
  • It is moddable and customizable.
  • It is extensible with Python scripts, and muParser expressions.
  • A powerful runtime output has been implemented.

First steps with AQUAgpusph

You may start learning how to download and install AQUAgpusph. After that you may want top take a look to the examples.

Of course, you may be interested on the theoretical aspects of the model.