Skip to content
View PhasicFlow's full-sized avatar
Block or Report

Block or report PhasicFlow

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
PhasicFlow/README.md

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}
}

Popular repositories

  1. phasicFlow phasicFlow Public

    Parallel, highly efficient code (CPU and GPU) for DEM and CFD-DEM simulations.

    C++ 30 21

  2. PhasicFlowPlus PhasicFlowPlus Public

    Fluid-particle coupling for multiphase flow based on PhasicFlow and OpenFOAM

    C++ 18 6