OpenLB
OpenLB is a C++ package for the implementation of lattice Boltzmann methods (LBM) to address a vast range of transport problems, e.g. in computational fluid dynamics. The modular open source code enables fast implementation of academic test problems and advanced engineering applications.
Cite this software
Description
OpenLB - Open Source Lattice Boltzmann Code
The OpenLB project is a C++ package for the implementation of lattice Boltzmann
methods adressing a vast range of transport problems.
Dependencies
The only mandatory external dependency of OpenLB is GNU Make and a C++ compiler
with C++20 support. This includes all reasonably recent versions of GCC, Clang
and Intel ICX.
GPU support depends on Nvidia CUDA 12 or later.
Installation
- Adjust the
config.mkfile to fit your local compiler environment
(examples for some common configurations are available inconfig/) - Build the embedded dependencies using
make - Switch to any of the examples and compile it using
make
Documentation
A comprehensive user guide is available in doc/userGuide.
Papers featuring OpenLB are collected at 1.
Up-to-date Doxygen documentation can be generated via make doxygen
or accessed at 2.
Community
The OpenLB forum 3 is an open discussion board for all aspects of LBM and OpenLB.
Feel free to post any problems, questions, suggestions or contributions.
You can also reach us via mail at info@openlb.net
There is a yearly one-week Spring School 4 where you can learn about LBM and
OpenLB directly from the developer team and invited guest lecturers.
A list of all present and past contributors is available at 5.
How to cite OpenLB
Standardized citation metadata is available in the CITATION.cff file.
To cite OpenLB in general instead of a specific release we suggest:
@article{OpenLB2021,
title = {{OpenLB - Open Source Lattice Boltzmann Code}},
year = {2021},
issn = {08981221},
doi = {10.1016/j.camwa.2020.04.033},
journal = {Computers \& Mathematics with Applications},
author = {Krause, Mathias J. and Kummerl{\"a}nder, Adrian and Avis, Samuel J. and Kusumaatmaja, Halim and Dapelo, Davide and Klemens, Fabian and Gaedtke, Maximilian and Hafen, Nicolas and Mink, Albert and Trunk, Robin and Marquardt, Jan E. and Maier, Marie-Luise and Haussmann, Marc and Simonis, Stephan},
}
This article is available as open access 6.
Code Formatting
The basic formatting rules are described by the .editorconfig file 7
for automatic application in a wide variety of text editors and IDEs.
License
OpenLB is provided as open source under the terms of the GNU GPL v2 license.
See LICENSE for details.
Reference papers
- 1.Author(s): Adrian Kummerländer, Tim Bingert, Fedor Bukreev, Luiz Eduardo Czelusniak, Davide Dapelo, Simon Englert, Nicolas Hafen, Marc Heinzelmann, Shota Ito, Julius Jeßberger, Florian Kaiser, Eliane Kummer, Halim Kusumaatmaja, Jan E. Marquardt, Michael Rennick, Tim Pertzel, Frantisek Prinz, Martin Sadric, Maximilian Schecher, Stephan Simonis, Pascal Sitter, Dennis Teutscher, Mingliang ZHONG, Mathias J. KrausePublished in SSRN Electronic Journal by Elsevier BV in 202510.2139/ssrn.5020968
- 2.Author(s): Mathias J. Krause, Adrian Kummerländer, Samuel J. Avis, Halim Kusumaatmaja, Davide Dapelo, Fabian Klemens, Maximilian Gaedtke, Nicolas Hafen, Albert Mink, Robin Trunk, Jan E. Marquardt, Marie-Luise Maier, Marc Haussmann, Stephan SimonisPublished in Computers & Mathematics with Applications by Elsevier BV in 2021, page: 258-28810.1016/j.camwa.2020.04.033
- 1.Author(s): Adrian Kummerländer, Tim Niklas Bingert, Fedor Bukreev, Davide Dapelo, Simon Englert, Christoph Gaul, Michael Grinschewski, Shota Ito, Julius Jeßberger, Florian Kaiser, Danial Khazaeipoul, Timm Krüger, Halim Kusumaatmaja, Jan E. Marquardt, Alice Raeli, Michael Rennick, Maximilian Schecher, Andreas SchneiderPublished by Unpublished in 202510.13140/rg.2.2.26901.64486
- 2.Author(s): Adrian Kummerländer, Samuel J. Avis, Halim Kusumaatmaja, Fedor Bukreev, Michael Crocoll, Davide Dapelo, Simon Großmann, Nicolas Hafen, Shota Ito, Julius Jeßberger, Eliane Kummer, Jan E. Marquardt, Johanna Mödl, Tim Pertzel, František Prinz, Florian Raichle, Martin Sadric, Maximilian Schecher, Dennis Teutscher, Stephan SimonisPublished by arXiv in 202310.48550/arxiv.2307.11752
- 3.Author(s): Adrian Kummerländer, Samuel J. Avis, Halim Kusumaatmaja, Fedor Bukreev, Davide Dapelo, Simon Großmann, Nicolas Hafen, Claudius Holeksa, Anna Husfeldt, Julius Jeßberger, Louis Kronberg, Jan E. Marquardt, Johanna Mödl, Johannes Nguyen, Tim Pertzel, Stephan Simonis, Lukas Springmann, Nando Suntoyo, Dennis TeutscherPublished by Unpublished in 202210.13140/rg.2.2.36559.19369
Mentions
- 1.Author(s): Adrian Kummerländer, Fedor Bukreev, Simon F. R. Berg, Marcio Dorn, Mathias J. KrausePublished in High Performance Computing in Science and Engineering '22 by Springer Nature Switzerland in 2024, page: 233-24710.1007/978-3-031-46870-4_16
- 2.Author(s): Erin Sam Joe, D. Arumuga PerumalPublished in Lecture Notes in Mechanical Engineering, Fluid Mechanics and Fluid Power (Vol. 1) by Springer Nature Singapore in 2023, page: 435-44010.1007/978-981-19-7055-9_73
- 3.Author(s): Nicolas Hafen, Mathias J. Krause, Achim DittlerPublished in Proceedings, 22. Internationales Stuttgarter Symposium by Springer Fachmedien Wiesbaden in 2022, page: 292-30310.1007/978-3-658-37011-4_24
- 4.Author(s): Colin Bretl, Robin Trunk, Hermann Nirschl, Gudrun Thäter, Marcio Dorn, Mathias J. KrausePublished in High Performance Computing in Science and Engineering '20 by Springer International Publishing in 2021, page: 245-25910.1007/978-3-030-80602-6_16
- 1.Author(s): Anas Ghannam, Anas AlAzzam, Eiyad Abu-NadaPublished in International Conference on Fluid Flow and Thermal Science, Proceedings of the 4th International Conference on Fluid Flow and Thermal Science (ICFFTS 2023) by Avestia Publishing in 202310.11159/icffts23.161
- 2.Author(s): Vaibhav KaushikPublished in 2023 World Conference on Communication & Computing (WCONF) by IEEE in 2023, page: 1-710.1109/wconf58270.2023.10234973
- 3.Author(s): Fei Mengl, Yuchen Zhao, Xuanyu HuPublished in 2023 42nd Chinese Control Conference (CCC) by IEEE in 2023, page: 2633-263810.23919/ccc58697.2023.10241025
- 4.Author(s): František Prinz, Jakub Elcner, Jan Pokorný, Miroslav JíchaPublished in AIP Conference Proceedings, THE PROCEEDINGS OF THE 5TH INTERNATIONAL CONFERENCE ON MARITIME EDUCATION AND TRAINING (The 5th ICMET) 2021 by AIP Publishing in 2023, page: 02001810.1063/5.0121340
- 5.Author(s): Anas Selmi, Sahil Bhapkar, Cristian Nagel, Adrian Kummerländer, Mathias J. KrausePublished in 2023 24th International Conference on Thermal, Mechanical and Multi-Physics Simulation and Experiments in Microelectronics and Microsystems (EuroSimE) by IEEE in 2023, page: 1-610.1109/eurosime56861.2023.10100812
- 6.Author(s): Shreyas G. Ashok, Juergen RaulederPublished in AIAA AVIATION 2022 Forum by American Institute of Aeronautics and Astronautics in 202210.2514/6.2022-3750
- 7.Author(s): Isabel F. Fernandez, Bastian Horvat, Juergen RaulederPublished in AIAA AVIATION 2022 Forum by American Institute of Aeronautics and Astronautics in 202210.2514/6.2022-3675
- 8.Author(s): M. Pasquier, S. Jay, P. SagautPublished in 8th European Congress on Computational Methods in Applied Sciences and Engineering by CIMNE in 202210.23967/eccomas.2022.164
- 9.Author(s): Sijiang Fan, Jiawei Fei, Xiao-Wei Guo, Canqun Yang, Alistair RevellPublished in 50th International Conference on Parallel Processing by ACM in 2021, page: 1-1010.1145/3472456.3472525
- 10.Author(s): Zhishang Xu, Ricardo Puente, Sina StapelfeldtPublished in AIAA Scitech 2021 Forum by American Institute of Aeronautics and Astronautics in 202110.2514/6.2021-2006
- 1.Author(s): Biagio Cosenza, Luigi Crisci, Giorgio Amati, Matteo TurisiniPublished in Future Generation Computer Systems by Elsevier BV in 2026, page: 10803210.1016/j.future.2025.108032
- 2.Author(s): Lei Xu, Qingyang Zhang, Kai Lu, Zhengzheng Yan, Chunye Gong, Shengguo Li, Lin Chen, Xinhai Chen, Xuchuan Lin, Jie Liu, Zheng Wang, Rongliang ChenPublished in SIAM Journal on Scientific Computing by Society for Industrial & Applied Mathematics (SIAM) in 2025, page: B402-B42710.1137/23m1600797
- 3.Author(s): Călin A. Georgescu, Merel A. Schalkers, Matthias MöllerPublished in Computer Physics Communications by Elsevier BV in 2025, page: 10969910.1016/j.cpc.2025.109699
- 4.Author(s): Taraprasad Bhowmick, Jonas Latt, Yong Wang, Gholamhossein BagheriPublished in Computers & Fluids by Elsevier BV in 2025, page: 10669610.1016/j.compfluid.2025.106696
- 5.Author(s): Dennis Teutscher, Fedor Bukreev, Adrian Kummerländer, Stephan Simonis, Peter Bächler, Ashkan Rezaee, Mariusz Hermansdorfer, Mathias J. KrausePublished in Building and Environment by Elsevier BV in 2025, page: 11309310.1016/j.buildenv.2025.113093
- 6.Author(s): František Prinz, Jana Kánská, Jakub Elcner, Ondřej Hájek, Adrian Kummerländer, Mathias J. Krause, Miroslav Jícha, František LízalPublished in Computers in Biology and Medicine by Elsevier BV in 2025, page: 11047310.1016/j.compbiomed.2025.110473
- 7.Author(s): Jan E. Marquardt, Bastian Eysel, Martin Sadric, Cornelia Rauh, Mathias J. KrausePublished in Journal of Food Engineering by Elsevier BV in 2025, page: 11247310.1016/j.jfoodeng.2025.112473
- 8.Author(s): Fedor Bukreev, Adrian Kummerländer, Julius Jeßberger, Dennis Teutscher, Stephan Simonis, Dieter Bothe, Mathias J. KrausePublished in AIAA Journal by American Institute of Aeronautics and Astronautics (AIAA) in 2025, page: 1295-130410.2514/1.j064234
- 9.Author(s): Martin Geier, Konstantin Kutscher, Martin Schönherr, Anna Wellmann, Sören Peters, Hussein Alihussein, Jan Linxweiler, Manfred KrafczykPublished in Computer Physics Communications by Elsevier BV in 2025, page: 10981010.1016/j.cpc.2025.109810
- 10.Author(s): Dennis Teutscher, Tyll Weber-Carstanjen, Stephan Simonis, Mathias J. KrausePublished in Applied Sciences by MDPI AG in 2025, page: 493310.3390/app15094933
- 11.Author(s): Fedor Bukreev, Adrian Kummerländer, Julius Jeßberger, Dennis Teutscher, Shota Ito, Stephan Simonis, Davide Dapelo, Mohaddeseh M. Nezhad, Hermann Nirschl, Mathias J. KrausePublished in 202510.1007/s00366-025-02217-w
- 12.Author(s): Adrian Kummerländer, Fedor Bukreev, Dennis Teutscher, Marcio Dorn, Mathias J. KrausePublished in Journal of Parallel and Distributed Computing by Elsevier BV in 2025, page: 10516910.1016/j.jpdc.2025.105169
- 13.Author(s): Qingyang Zhang, Jiawei Li, Hongyang Lu, Hang Zou, Kai Li, Yuechao Liang, Bo Yang, Jie LiuPublished in Building and Environment by Elsevier BV in 2025, page: 11331310.1016/j.buildenv.2025.113313
- 14.Author(s): Matthias Hettel, Fedor Bukreev, Eric Daymo, Adrian Kummerländer, Mathias J. Krause, Olaf DeutschmannPublished in AIAA Journal by American Institute of Aeronautics and Astronautics (AIAA) in 2025, page: 1305-131810.2514/1.j064280
- 15.Author(s): Mohammad Ali Daeian, W. Spencer Smith, Zahra Keshavarz-MotamedPublished in Physics of Fluids by AIP Publishing in 202510.1063/5.0241118
- 16.Author(s): Erk Kurban, Serge Toxopeus, Juergen RaulederPublished in Ocean Engineering by Elsevier BV in 2025, page: 12078810.1016/j.oceaneng.2025.120788
- 17.Author(s): Fedor Bukreev, Adrian Kummerländer, Julius Jeßberger, Dennis Teutscher, Shota Ito, Stephan Simonis, Davide Dapelo, Mohaddeseh M. Nezhad, Hermann Nirschl, Mathias J. KrausePublished in 202510.1007/s00366-025-02216-x
- 18.Author(s): Hang Zou, Qingyang Zhang, Hongyang Lu, Min Song, Ziyi Hu, Dianqiang Jiang, Tun Li, Jie LiuPublished in 202510.1080/19942060.2025.2555335
- 19.Author(s): Alexandre de Quadro Tacques Filho, Tim Niklas Bingert, Adrian Kummerländer, Luiz Eduardo Czelusniak, Mathias J. Krause, Márcio DornPublished in Energy Storage by Wiley in 202510.1002/est2.70237
- 20.Author(s): N. I. Prasianakis, E. Laloy, D. Jacques, J. C. L. Meeussen, G. D. Miron, D. A. Kulik, A. Idiart, E. Demirer, E. Coene, B. Cochepin, M. Leconte, M. E. Savino, J. Samper-Pilar, M. De Lucia, S. V. Churakov, O. Kolditz, C. Yang, J. Samper, F. ClaretPublished in Environmental Earth Sciences by Springer Science and Business Media LLC in 202510.1007/s12665-024-12066-3
- 21.Author(s): Shang Shi, Liangxing Li, Lijun Jian, Zhenxin Lei, Yidan YuanPublished in Physics of Fluids by AIP Publishing in 202510.1063/5.0278473
- 22.Author(s): Anas Ghannam, Ahmad Chehade, Muhammad Mustafa Generous, Anas Alazzam, Clement Kleinstreuer, Goodarz Ahmadi, Eiyad Abu-NadaPublished in Physics Reports by Elsevier BV in 2025, page: 1-9610.1016/j.physrep.2025.03.001
- 23.Author(s): A. Bourada, Y.K. Benkahla, A. Boutra, D.E. AmezianiPublished in Journal of the Taiwan Institute of Chemical Engineers by Elsevier BV in 2025, page: 10606710.1016/j.jtice.2025.106067
- 24.Author(s): MohammadAli Daeian, Punya Cheema, W. Spencer Smith, Zahra Keshavarz-MotamedPublished in Computer Physics Communications by Elsevier BV in 2025, page: 10963710.1016/j.cpc.2025.109637
- 25.Author(s): Luiz Eduardo Czelusniak, Tim Niklas Bingert, Mathias J. Krause, Stephan SimonisPublished in Physics of Fluids by AIP Publishing in 202510.1063/5.0268276
- 26.Author(s): Shota Ito, Simon Großmann, Fedor Bukreev, Julius Jeßberger, Mathias J. KrausePublished in Chemical Engineering Science by Elsevier BV in 2025, page: 12146710.1016/j.ces.2025.121467
- 27.Author(s): A. Mokos, R.A. Patel, K. Karalis, S.V. Churakov, N.I. PrasianakisPublished in International Journal of Heat and Mass Transfer by Elsevier BV in 2024, page: 12574710.1016/j.ijheatmasstransfer.2024.125747
- 28.Author(s): Stephan Simonis, Johannes Nguyen, Samuel J. Avis, Willy Dörfler, Mathias J. KrausePublished in Discrete and Continuous Dynamical Systems - S by American Institute of Mathematical Sciences (AIMS) in 2024, page: 3278-329410.3934/dcdss.2023069
- 29.Author(s): Michel Takken, Robert WillePublished in Micromachines by MDPI AG in 2024, page: 12910.3390/mi15010129
- 30.Author(s): Ardian Nurcahya, Aldenia Alexandra, Fadhillah Akmal, Irwan Ary DharmawanPublished in Applied Sciences by MDPI AG in 2024, page: 750910.3390/app14177509
- 31.Author(s): Ramon G. C. Lourenço, João R. Friggo, Pedro H. Constantino, Frederico W. TavaresPublished in Physics of Fluids by AIP Publishing in 202410.1063/5.0205161
- 32.Author(s): Jan E. Marquardt, Nicolas Hafen, Mathias J. KrausePublished in Computer Physics Communications by Elsevier BV in 2024, page: 10932110.1016/j.cpc.2024.109321
- 33.Author(s): Jan E. Marquardt, Mathias J. KrausePublished in Powders by MDPI AG in 2024, page: 500-53010.3390/powders3040027
- 34.Author(s): Manuel Wegmann, Julius Jeßberger, Gudrun Thäter, Mathias J. KrausePublished in Examples and Counterexamples by Elsevier BV in 2024, page: 10015610.1016/j.exco.2024.100156
- 35.Author(s): Junwei Guo, Qi Zhou, Ron Chik-Kwong WongPublished in Physics of Fluids by AIP Publishing in 202410.1063/5.0195294
- 36.Author(s): Mingliang Zhong, Tianbai Xiao, Mathias J. Krause, Martin Frank, Stephan SimonisPublished in Journal of Computational Physics by Elsevier BV in 2024, page: 11334410.1016/j.jcp.2024.113344
- 37.Author(s): Junwei Guo, John R. Taylor, Qi ZhouPublished in Journal of Fluid Mechanics by Cambridge University Press (CUP) in 202410.1017/jfm.2024.783
- 38.Author(s): Yanchen Wu, Fei Wang, Sai Zheng, Britta NestlerPublished in Soft Matter by Royal Society of Chemistry (RSC) in 2024, page: 1523-154210.1039/d3sm01553j
- 39.Author(s): J. Weinmiller, M. P. Lautenschlaeger, B. Kellers, T. Danner, A. LatzPublished in Water Resources Research by American Geophysical Union (AGU) in 202410.1029/2023wr034770
- 40.Author(s): Ao Xu, Bo-Tao LiPublished in International Journal of Heat and Mass Transfer by Elsevier BV in 2024, page: 12475810.1016/j.ijheatmasstransfer.2023.124758
- 41.Author(s): Jan E. Marquardt, Nicolas Hafen, Mathias J. KrausePublished in Journal of Computational Science by Elsevier BV in 2024, page: 10226310.1016/j.jocs.2024.102263
- 42.Author(s): Anas Ghannam, Anas Alazzam, Eiyad Abu-NadaPublished in Physics of Fluids by AIP Publishing in 202410.1063/5.0238950
- 43.Author(s): Dennis Teutscher, Adrian Kummerländer, Fedor Bukreev, Marcio Dorn, Mathias J. KrausePublished in Applied Sciences by MDPI AG in 2024, page: 178410.3390/app14051784
- 44.Author(s): R Au-Yeung, B Camino, O Rathore, V KendonPublished in Reports on Progress in Physics by IOP Publishing in 2024, page: 11600110.1088/1361-6633/ad85f0
- 45.Author(s): Zhenliang Jiang, Yiqian Lin, Xian Chen, Shanghui Li, Peichen Cai, Yun QuePublished in Sensors by MDPI AG in 2024, page: 415610.3390/s24134156
- 46.Author(s): Martin L. Kliemank, Dominik Wilde, Mario C. Bedrunka, Andreas Krämer, Holger Foysi, Dirk ReithPublished in Discrete and Continuous Dynamical Systems - S by American Institute of Mathematical Sciences (AIMS) in 2024, page: 3205-322310.3934/dcdss.2023046
- 47.Author(s): Mohammad Saleh Sargazizadeh, Farzad Bazdidi-TehraniPublished in Sustainable Cities and Society by Elsevier BV in 2024, page: 10541310.1016/j.scs.2024.105413
- 48.Author(s): Mohammadmehdi Ataei, Hesam SalehipourPublished in Computer Physics Communications by Elsevier BV in 2024, page: 10918710.1016/j.cpc.2024.109187
- 49.Author(s): František Prinz, Jan Pokorný, Jakub Elcner, František Lízal, Ondrej Mišík, Milan Malý, Miloslav Bělka, Nicolas Hafen, Adrian Kummerländer, Mathias J. Krause, Jan Jedelský, Miroslav JíchaPublished in Computers in Biology and Medicine by Elsevier BV in 2024, page: 10799410.1016/j.compbiomed.2024.107994
- 50.Author(s): Ramiro Freile, Mauricio E. Tano, Jean C. RagusaPublished in Annals of Nuclear Energy by Elsevier BV in 2024, page: 11027510.1016/j.anucene.2023.110275
- 1.Author(s): Dennis Teutscher, Adrian Kummerländer, Fedor Bukreev, Marcio Dorn, Mathias J. KrausePublished by MDPI AG in 202410.20944/preprints202401.2184.v1
- 2.Author(s): Manuel Wegmann, Julius Jeßberger, Gudrun Thäter, Mathias J. KrausePublished by Elsevier BV in 202410.2139/ssrn.4795084
- 3.Author(s): J. E. Marquardt, N. Hafen, M. J. KrausePublished by arXiv in 202410.48550/arxiv.2401.10878
- 4.Author(s): Vidyapati Kumar, Ankita Mistri, Varnit Jain, Manojit GhoshPublished in 3D Bioprinting from Lab to Industry by Wiley in 2024, page: 301-32210.1002/9781119894407.ch10
- 5.Author(s): Benjamin Owen, Konstantinos Kechagidis, Sajad Razavi Bazaz, Romain Enjalbert, Erich Essmann, Calum Mallorie, Fatemehsadat Mirghaderi, Christian Schaaf, Krishnaveni Thota, Rohan Vernekar, Qi Zhou, Majid Ebrahimi Warkiani, Holger Stark, Timm KrügerPublished by Cold Spring Harbor Laboratory in 202310.1101/2023.04.10.536205
- 6.Author(s): Ao Xu, Bo-Tao LiPublished by arXiv in 202310.48550/arxiv.2308.16597
- 7.Author(s): Shota Ito, Julius Jeßberger, Stephan Simonis, Fedor Bukreev, Adrian Kummerländer, Alexander Zimmermann, Gudrun Thäter, Georg Pesch, J. Thöming, Mathias J. KrausePublished by Elsevier BV in 202310.2139/ssrn.4616949
- 8.Author(s): Davide Dapelo, Stefan Krause, Jesus D Gomez‐Velez, John BridgemanPublished by Wiley in 202310.22541/essoar.169651327.73221657/v1
- 9.Author(s): Jinhua Lu, Nikolaus A. AdamsPublished by Springer Science and Business Media LLC in 202310.21203/rs.3.rs-2565834/v1
- 10.Author(s): J. E. Marquardt, N. Hafen, M. J. KrausePublished by arXiv in 202310.48550/arxiv.2312.14172
- 11.Author(s): Mingwu Li, Bálint Kaszás, George HallerPublished by arXiv in 202310.48550/arxiv.2307.00730
- 12.Author(s): Mohammadmehdi Ataei, Hesam SalehipourPublished by arXiv in 202310.48550/arxiv.2311.16080
- 13.Author(s): Tadeusz TomczakPublished in 2021
- 14.Author(s): Marc Haussmann, Peter Reinshaus, Stephan Simonis, Hermann Nirschl, Mathias J. KrausePublished in 2020