pyLBM is an all-in-one package for numerical simulations using Lattice Boltzmann solvers.

pyLBM is licensed under the BSD license, enabling reuse with few restrictions.

Getting started

pyLBM can be a simple way to make numerical simulations by using the Lattice Boltzmann method.

To install pyLBM, you have several ways. You can install the last version on Pypi

pip install pyLBM

You can also clone the project

git clone https://github.com/pylbm/pylbm

and then use the commands

pip install -r requirements.txt
python setup.py install

or

pip install -r requirements.txt
python setup.py install --user

Once the package is installed you just have to understand how build a dictionary that will be understood by pyLBM to perform the simulation. The dictionary should contain all the needed informations as

  • the geometry (see here for documentation)
  • the scheme (see here for documentation)
  • the boundary conditions (see here for documentation)
  • another informations like the space step, the scheme velocity, the generator of the functions...

To understand how to use pyLBM, you have a lot of Python notebooks in the tutorial.

Documentation of the code

The most important classes

Geometry(dico) Create a geometry that defines the fluid part and the solid part.
Domain([dico, geometry, stencil, ...]) Create a domain that defines the fluid part and the solid part and computes the distances between these two states.
Scheme(dico[, stencil]) Create the class with all the needed informations for each elementary scheme.
Simulation(dico[, domain, scheme, sorder, dtype]) create a class simulation

The modules

References

[dH92]D. D’HUMIERES, Generalized Lattice-Boltzmann Equations, Rarefied Gas Dynamics: Theory and Simulations, 159, pp. 450-458, AIAA Progress in astronomics and aeronautics (1992).
[D08]F. DUBOIS, Equivalent partial differential equations of a lattice Boltzmann scheme, Computers and Mathematics with Applications, 55, pp. 1441-1449 (2008).
[G14]B. GRAILLE, Approximation of mono-dimensional hyperbolic systems: a lattice Boltzmann scheme as a relaxation method, Journal of Comutational Physics, 266 (3179757), pp. 74-88 (2014).
[QdHL92]Y.H. QIAN, D. D’HUMIERES, and P. LALLEMAND, Lattice BGK Models for Navier-Stokes Equation, Europhys. Lett., 17 (6), pp. 479-484 (1992).

Indices and tables