lbmpy
Run fast fluid simulations based on the lattice Boltzmann method in Python on CPUs and GPUs. lbmpy creates highly optimized LB compute kernels in C or CUDA, for a wide variety of different collision operators, including MRT, entropic, and cumulant schemes.
All collision operators can be easily adapted, for example, to integrate turbulence models, custom force terms, or multi-phase models. It even comes with an integrated Chapman Enskog analysis based on sympy!
Common test scenarios can be set up quickly:
from pystencils import Target
from lbmpy.session import *
ch = create_channel(domain_size=(300, 100, 100), force=1e-7, method=Method.TRT,
equilibrium_order=2, compressible=True,
relaxation_rates=[1.97, 1.6], optimization={'target': Target.GPU})
To find out more, check out the interactive tutorial notebooks online with binder.
Installation
For local installation use pip:
pip install lbmpy[interactive]
Without [interactive] you get a minimal version with very little dependencies.
All options:
gpu: use this if a NVIDIA GPU is available and CUDA is installedopencl: use this to enable the targetopencl(execution using OpenCL)alltrafos: pulls in additional dependencies for loop simplification e.g. libislinteractive: installs dependencies to work in Jupyter including image I/O, plotting etc.
Options can be combined e.g.
pip install lbmpy[interactive,gpu,doc]
Documentation
Contributing
To see how to open issues, submit bug reports, create feature requests or submit your additions to lbmpy please refer to contribution documentation of pystencils since lbmpy is heavily build on pystencils.
Many thanks go to the contributors of lbmpy.
Please cite us
If you use lbmpy in a publication, please cite the following articles:
Overview:
- F. Hennig et al, Advanced Automatic Code Generation for Multiple Relaxation-Time Lattice Boltzmann Methods. SIAM Journal on Scientific Computing, 2023. https://doi.org/10.1137/22M1531348 (Preprint)
- M. Bauer et al, lbmpy: Automatic code generation for efficient parallel lattice Boltzmann methods. Journal of Computational Science, 2021. https://doi.org/10.1016/j.jocs.2020.101269 (Preprint)
Multiphase:
- M. Holzer et al, Highly efficient lattice Boltzmann multiphase simulations of immiscible fluids at high-density ratios on CPUs and GPUs through code generation. The International Journal of High Performance Computing Applications, 2021. https://doi.org/10.1177/10943420211016525
Further Reading
- F. Hennig et al, Automatic Code Generation for the Cumulant Lattice Boltzmann Method. ICMMES, 2021. Poster Link
3 maintainers
Metadata
3 maintainers
Release files for lbmpy 2.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lbmpy-2.1.1.tar.gz | 299.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lbmpy-2.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 587.8 kB
Release files / lbmpy-2.1.1.tar.gz
| Download URL | lbmpy-2.1.1.tar.gz |
|---|---|
| Size | 299.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f307f0ffa77914c923937917d53f198476819a72c562eb15ed53cb4522e0e7a9
|
|
BLAKE2b-256 checksum How to use checksums |
096f692a3f59614caa46b310c84586058af6db7391180597714750dd3d6e6795
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / lbmpy-2.1.1-py3-none-any.whl
| Download URL | lbmpy-2.1.1-py3-none-any.whl |
|---|---|
| Size | 287.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c9abeec9e72657d770793f43d7a9733b2e0dd4eaf5f47648dd84ba713c2d6db
|
|
BLAKE2b-256 checksum How to use checksums |
0a7b52be8aeaec44a388074854c9796e97f8495b5c99cbc079aba4e3f8362a1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
