Skip to content

PhasicFlow/phasicFlow

Repository files navigation

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 mainly relies on loop-level parallelization on a shared-memory computational unit. You can build and run PhasicFlow in serial mode on regular PCs, in parallel mode for multi-core CPUs, or build it for a GPU device to off-load computations to a GPU. In its current statues you can simulate millions of particles (up to 80M particles tested) on a single desktop computer. You can see the performance tests of PhasicFlow in the wiki page.

MPI parallelization with dynamic load balancing is under development. With this level of parallelization, PhasicFlow can leverage the computational power of multi-gpu workstations or clusters with distributed memory CPUs. In summary PhasicFlow can have 6 execution modes:

  1. Serial on a single CPU core,
  2. Parallel on a multi-core computer/node (using OpenMP),
  3. Parallel on an nvidia-GPU (using Cuda),
  4. Parallel on distributed memory workstation (Using MPI)
  5. Parallel on distributed memory workstations with multi-core nodes (using MPI+OpenMP)
  6. Parallel on workstations with multiple GPUs (using MPI+Cuda).

How to build?

You can build PhasicFlow for CPU and GPU executions. The latest release of PhasicFlow is v-0.1. Here is a complete step-by-step procedure for building phasicFlow-v-0.1..

Online code documentation

You can find a full documentation of the code, its features, and other related materials on online documentation of the code

How to use PhasicFlow?

You can navigate into tutorials folder in the phasicFlow folder to see some simulation case setups. If you need more detailed discription, visit our wiki page tutorials.

PhasicFlowPlus is and extension to PhasicFlow for simulating particle-fluid systems using resolved and unresolved CFD-DEM. See the repository of this package.

Supporting packages

  • Kokkos from National Technology & Engineering Solutions of Sandia, LLC (NTESS)
  • CLI11 1.8 from University of Cincinnati.

How to cite PhasicFlow

If you are using PhasicFlow in your research or industrial work, cite the following article:

@article{NOROUZI2023108821,
title = {PhasicFlow: A parallel, multi-architecture open-source code for DEM simulations},
journal = {Computer Physics Communications},
volume = {291},
pages = {108821},
year = {2023},
issn = {0010-4655},
doi = {https://doi.org/10.1016/j.cpc.2023.108821},
url = {https://www.sciencedirect.com/science/article/pii/S0010465523001662},
author = {H.R. Norouzi},
keywords = {Discrete element method, Parallel computing, CUDA, GPU, OpenMP, Granular flow}
}