xfygogo
/
phasicFlow
mirror of https://github.com/PhasicFlow/phasicFlow.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Parallel, highly efficient code (CPU and GPU) for DEM and CFD-DEM simulations.
8 Commits 10 Branches 1 Tag 125 MiB
C++ 98.3%
CMake 0.9%
Shell 0.8%
Go to file
hamidrezanorouzi 5f40bcd775
Update README.md 		2022-08-27 12:00:58 +04:30
.gitignore Initial commit 2022-08-26 18:07:47 +04:30
LICENSE Initial commit 2022-08-26 18:07:47 +04:30
README.md Update README.md 2022-08-27 12:00:58 +04:30

README.md

phasicFlow

phasicFlow is a parallel C++ code for performing DEM simulations. It can run on shared-memory multi-core computational units such as multi-core CPUs or GPUs (for now it works on CUDA-enabled GPUs). The parallelization method now mainly relies on loop-level parallelization on a shared-memory computational unit. You can build and run phasic flow in serial mode on regualr PCs, build it for multi-core CPUs to be executed in parallel, or build it for a GPU device to off-load computations to GPU.

Required packages

phasicFlow uses Kokkos as the backend for parallelization. So, you need to also have the code in the local machine alongside phasicFlow. The make system is adjusted in a way so you do not need to compile Kokkos separately and the required code is compiled alongside the phasicFlow.

Requirements

phasicFlow should work with every gnu compiler that implements C++17 standards. For now, it is tested on Ubuntu distribution of linux operating systems. If the minimum requirements are met, there should not be any problem with compiling the code. However, there are always compiler bugs from one version to another that may need you extra attempts for upgrading to newer versions or downgrading to prior versions of the compiler.

  • CPU builds: It requires gcc-6.x or higher.
  • GPU (CUDA): NVCC-10.x or higher.

You also need to have CMake installed on your computer. At the moment CMake-3.22 or higher is needed.

How to build?

phasicFlow uses CMake as the build system. you need to have CMake-3.22 or higher installed on your machine. you can either use the command line for setting-up the build system, or use cmake-gui to setup your build system through the GUI.

build for serial execution

build for parallel execution on CPU

build for parallel execution on CUDA-enabled GPUs

How to use phasicFlow?

Extentions in future

parallelization

  • Enabling OpenMPTarget backend to include more GPUs for off-loading calculations.
  • Extending high-level parallelization and impelmenting spacial partitioning and load balancing for muilti-GPU computations and running phasicFlow on distributed memory super-computers

basic features