DualSPHysics

A combined CUDA and OpenMP implementation of the Smoothed Particle Hydrodynamics method based on the advanced SPHysics code.

Instructions for regular users

If you only want a copy of DualSPHysics to make and run cases in your system, you probably want the full DualSPHysics package from the official webpage. There you will find documentation and a different set of packages for different versions of the application and different Operating Systems.

It is possible that you want the latest version in this repository that is not yet uploaded in the official web page. In this case check the Building the project section to build an executable.

Have in mind that DualSPHysics needs a generated case to execute the SPH solver, so you want to check out GenCase too, included the main package on the DualSPHysics webpage.

If you need help check out the wiki for this project, or you can also check the previously mentioned download page to get a PDF guide.

Instructions for developers

If you are a developer and want to use this code check the following guides.

Take into account that for generating cases and post-processing them you will need to use GenCase and the different post-processing tools included in the main DualSPHyisics package, downloadable here. If you compile your own DualSPHyiscs version just overwrite (or don use) the one in the package, but yours.

Developing a modified version to fit your own needs.

You can fork this repository and change or add anything you want in it. Keep in mind that your changes will not be taken into account into the main versions. If your objective is to add your changes/improvements to the main code, check the next section.

Developing a modified or improved version to contribute to the project.

We appreciate your efforts! But please, if you are trying to develop a feature to add to the main repository, be sure to follow the steps on the CONTRIBUTING.md file, to make the process easier for both parts and optimize the process.

Building the project

On Microsoft Windows

This application is being developed in Visual Studio 2013. The repository contains project files for that IDE and it is recomended to use them to make the process easier.

Make sure to install the CUDA SDK beforehand if you want to compile the GPU version, and configure the Visual Studio project to point to the CUDA libraries directory to compile.

If you prefer it, you can also use the Makefile. It is possible that you'll need to change some things in it to make it work. Check the GNU/Linux guide on how to compile if you're using the makefile, as it is mostly the same, just installing the things manually by yourself.

On GNU/Linux

You can build the project in GNU/Linux using the Makefile included in the source folder. Follow this steps (for the GPU version):

1. Clone this repository into your system
2. Ensure you have GCC version 4.X installed. Usually there are packages in your distro like gcc49 that provides the g++-4.9 executable.
3. In a terminal, go to the folder DualSPHysics/SOURCE/DualSPHysics/Source/
4. Execute make clean to make sure the environment is clean and ready to compile
5. Execute make CC=g++-4.9 CPP=g++-4.9 CXX=g++-4.9 LD=g++-4.9 -f ./Makefile. Be sure to replace g++-4.9 for the executable name you have in your system (previously installed in step 2)

After compiling you should see a message like --- Compiled Release GPU/CPU version ---. Go to DualSPHysics/EXECS_LINUX/ to check that DualSPHyiscs_linux64 or DualSPHyiscsCPU_linux64 is there and build correctly.

For the GPU version: Install the CUDA package on your system and edit the makefile to point the CUDA libs directories to the paths on your system. Also, check the CUDA version and adapt the Makefile to it.

For the CPU version: If you want to compile de CPU version just ignore CUDA and use the makefile Makefile_cpu

Graphical user interface (GUI)

Please check DesingSPHysics website.

Contributing

Please read CONTRIBUTING.md if you want to make changes to the code that would be later merged with the main project.

Authors and people involved

• Dr Jose M. Dominguez - Main Developer
• Dr Alejandro Crespo
• Prof. Moncho Gomez Gesteira
• Dr Anxo Barreiro
• Dr Benedict Rogers
• Dr Georgios Fourtakas
• Dr Athanasios Mokos
• Dr Renato Vacondio
• Dr Ricardo Canelas
• Dr Stephen Longshaw
• Dr Corrado Altomare

See also the list of contributors who participated in this project.

License

This project is licensed under the LGPL License - see the LICENSE file for details.