Skip to content

ggruszczynski/TCLB

 
 

Repository files navigation

TCLB Solver Header

TCLB Solver ZENADO DOI Article

TCLB is a MPI+CUDA, MPI+CPU or MPI+HIP high-performance Computational Fluid Dynamics simulation code, based on the Lattice Boltzmann Method. It provides a clear interface for calculation of complex physics, and the implementation of new models.

Stable release (master branch):
Open in GitHub Codespaces
CPU build status CUDA build status HIP build status codecov documentation

Current release (develop branch):
Open in GitHub Codespaces
CPU build status CUDA build status HIP build status codecov documentation

How to use it

Install

git clone https://github.com/CFD-GO/TCLB.git
cd TCLB

Configure

make configure
./configure

Compile

make d2q9

Run

CLB/d2q9/main example/flow/2d/karman.xml

More information

Documentation

The documentation (including tutorials) is published at docs.tclb.io.

For the develop version, the most recent documentation can be found at develop.docs.tclb.io.

You can contribute to the documentation at CFD-GO/TCLB_docs.

Supported architectures

This code is designed to run on Linux with CUDA. We strongly recommend using Linux for compilation, computation and postprocessing.

Nevertheless, TCLB can be compiled on Windows using the Windows Subsystem for Linux, with CUDA supported on some system configurations (see nVidia's website for more info). It also can be compiled on MacOS (CPU only). Both Debian and Red Hat based Linux distributions are supported by the install.sh script described below, as is MacOS (with brew package manager).

Dependencies

For the code to compile and work you'll need a few things:

Optionally, you may need:

  • To integrate TCLB with R, you'll need R package rinside
  • To integrate TCLB with Python, you'll need python, numpy with libraries and headers
  • To develop a model using Python, you'll need python, sympy and R package reticulate

You can install many of these with the provided tools/install.sh script (note that this requires sudo):

sudo tools/install.sh essentials   # Installs essential system packages needed by TCLB
sudo tools/install.sh r            # Installs R
sudo tools/install.sh openmpi      # Installs OpenMPI
     tools/install.sh rdep         # Installs needed R packages
sudo tools/install.sh cuda         # Installs CUDA (we recommend to do it on your own)
sudo tools/install.sh python-dev   # Installs Python libraries with headers

You can run the tools/install.sh script with the --dry option, which will print the commands to run, so you can run them on your own. We do not recommend running anything with sudo without checking

develop Branch:

If you want a more recent version, you could try the development branch with git checkout develop

CPU

To compile the code for CPU, you can use the --disable-cuda option for ./configure:

./configure --disable-cuda

HIP

To compile the code for AMD GPUs (ROCm), you can use the --enable-hip option for ./configure:

./configure --enable-hip

Parallel run

To run TCLB in parallel (both on multiple CPU and multiple GPU), you can use the standard syntax of MPI parallel run:

mpirun -np 8 CLB/d2q9/main example/flow/2d/karman.xml

Running on clusters

To assist with using TCLB on HPC clusters (SLURM/PBS), there are scripts provided in the TCLB_cluster repository.

LBM-DEM computation

TCLB code can be coupled with Discrete Element Method (DEM) codes, to enable computation of flow with particles.

The DEM codes that TCLB can be integrated with are:

Refer to the documentation for instructions on compilation and coupling.

Models

For users looking to apply existing LBM methods, common/supported models are below. Note extensions to these models exist using the TCLB's overlay framework and TCLB optional compile flags.

Two-Dimensional

  • d2q9: MRT LBM for single-phase flow.
  • d2q9_les: MRT LBM with Smagorinski LES turbulence model.
  • d2q9q9_cm_cht: thermal LBM with Boussinesq approx for coupling and cumulant or cascaded relaxation kernels.
  • d2q9_pf_velocity: multiphase LBM based on the phase field model and incompressible LBM.

Three-Dimensional

  • d3q27_cumulant: cumulant LBM with options for:
    • Interpolated bounceback.
    • Smagorinski LES turbulence model.
  • d3q27q27_cm_cht: thermal LBM with Boussinesq approx for coupling and cumulant or cascaded collision relaxation kernels.
  • d3q27_pf_velocity: multiphase LBM based on the phase field model and incompressible LBM.

Particle (DEM) Coupled

  • d3q27_PSM: Applies the partially saturated model for coupling particles in single phase flow.
    • Options for Two-Relaxation-Time kernel
    • Option for Non-Equilibiurm Bounce-Back and Superposition for the DEM-LBM coupling.

About

Authors

TCLB began development in 2012 with the aim at providing a framework for efficient CFD computations with LBM, mainly for research.

Author: Łukasz Łaniewski-Wołłk

Major contributors:

Contributors:

Developed at:

Citation

Please use appropriate citations if using this software in any research publication. The publication should cite the original paper about TCLB and papers which describe the used LBM models. You can find the list of TCLB publications at docs.tclb.io/general-info/publications/. You can also find the information about published articles in the source code of the models. The code can be cited additionally, by its Zenodo DOI.

License

This software is distributed under the GPL v3 License.

If you need this software under a different license, please contact the main author.

Contact: lukasz.laniewski(monkey)pw.edu.pl

About

CudneLB - Templated MPI+CUDA/CPU Lattice Boltzmann code

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 50.5%
  • Jupyter Notebook 17.5%
  • R 16.7%
  • C 6.0%
  • Python 4.3%
  • Shell 2.0%
  • Other 3.0%