GrainLearning
Unsure about the parameters of your grains in a computer simulation? Use Iterative Bayesian Filtering to learn parameter distributions from limited data. Is your model running slowly? Speed up your simulations with machine-learning surrogates. All these features are integrated within GrainLearning.
Cite this software
Description
GrainLearning is a Bayesian uncertainty quantification toolbox for computer simulations of granular materials. The software is primarily used to infer model parameter distributions from observation or reference data, also known as inverse analyses or data assimilation. Implemented in Python, GrainLearning can be loaded into a Python environment to process your simulation and observation data, or used as an independent tool where simulations are run separately, e.g., from the command line.
If you use GrainLearning, please cite this paper.
If you want to know more about how the method works, the following papers can be interesting:
- H. Cheng, T. Shuku, K. Thoeni, P. Tempone, S. Luding, V. Magnanimo. An iterative Bayesian filtering framework for fast and automated calibration of DEM models. Comput. Methods Appl. Mech. Eng., 350 (2019), pp. 268-294, 10.1016/j.cma.2019.01.027
- P. Hartmann, H. Cheng, K. Thoeni. Performance study of iterative Bayesian filtering to develop an efficient calibration framework for DEM. Computers and Geotechnics 141, 104491, 10.1016/j.compgeo.2021.104491
Participating organisations
Reference papers
- 1.Author(s): Hongyang Cheng, Luisa Orozco, Retief Lubbe, Aron Jansen, Philipp Hartmann, Klaus ThoeniPublished in Journal of Open Source Software by The Open Journal in 2024, page: 633810.21105/joss.06338
- 2.Author(s): Hongyang Cheng, Takayuki Shuku, Klaus Thoeni, Pamela Tempone, Stefan Luding, Vanessa MagnanimoPublished in Computer Methods in Applied Mechanics and Engineering by Elsevier BV in 2019, page: 268-29410.1016/j.cma.2019.01.027
Mentions
- 1.Author(s): Hongyang Cheng, Vanessa Magnanimo, Takayuki Shuku, Stefan Luding, Thomas WeinhartPublished in Lecture Notes in Civil Engineering, Challenges and Innovations in Geomechanics by Springer International Publishing in 2021, page: 837-84510.1007/978-3-030-64514-4_90
- 2.Author(s): Brian H. Pittenger, Andrés D. OrlandoPublished in The Minerals, Metals & Materials Series, Light Metals 2020 by Springer International Publishing in 2020, page: 1166-117010.1007/978-3-030-36408-3_158
- 1.Author(s): A. Thornton, Q. Nguyen, H. Polman, J. Bisschop, R. Weinhart-Mejia, M. Vesal, T. Weinhart, M. Post, I. OstaninPublished in VIII International Conference on Particle-Based Methods by CIMNE in 202310.23967/c.particles.2023.015
- 2.Author(s): Carolyn Matl, Yashraj Narang, Ruzena Bajcsy, Fabio Ramos, Dieter FoxPublished in 2020 IEEE International Conference on Robotics and Automation (ICRA) by IEEE in 2020, page: 2770-277710.1109/icra40945.2020.9197063
- 1.Author(s): YuHang Guo, SiHong Liu, ShaoYi Feng, ChaoMin ShenPublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 202510.1007/s40571-025-01057-1
- 2.Author(s): Christopher R.K. Windows-Yule, Kay A. Buist, Kianoosh Taghizadeh, Giulia Finotello, Andrei L. NicuşanPublished in Particuology by Elsevier BV in 2025, page: 3-1710.1016/j.partic.2024.04.009
- 3.Author(s): Ahmed Hadi, Yusong Pang, Dingena SchottPublished in Powder Technology by Elsevier BV in 2025, page: 12119010.1016/j.powtec.2025.121190
- 4.Author(s): M.A. Adam, S.S.K. Singh, S. Abdullah, M.A.M. JediPublished in Results in Engineering by Elsevier BV in 2025, page: 10450510.1016/j.rineng.2025.104505
- 5.Author(s): Ni An, Guanqi Wang, Di Wang, Gang Ma, Xiaolin Chang, Wei ZhouPublished in Acta Geotechnica by Springer Science and Business Media LLC in 2025, page: 1379-140110.1007/s11440-025-02537-7
- 6.Author(s): Xiaoxiong Zhou, Hongyi Xu, Qiuming Gong, Yanan Ma, Weiqiang XiePublished in Scientific Reports by Springer Science and Business Media LLC in 202510.1038/s41598-025-99480-0
- 7.Author(s): Jianyang Yu, Lingyu Meng, Shijie Ren, Xubin Song, Hongzhi Liang, Jiachen Cao, Yanping Xue, Wangbin ZhouPublished in Granular Matter by Springer Science and Business Media LLC in 202510.1007/s10035-025-01542-7
- 8.Author(s): Lokeshwar Mahto, Jayanta Chakraborty, Jitendra Kumar, Anurag Tripathi, Maitraye Sen, William KetterhagenPublished in Powder Technology by Elsevier BV in 2025, page: 12090310.1016/j.powtec.2025.120903
- 9.Author(s): Jiang Bing, Yu DanshengPublished in Results in Mathematics by Springer Science and Business Media LLC in 202510.1007/s00025-025-02501-7
- 10.Author(s): Yangpan Fu, Huawei Tong, Jie Yuan, Yizhao Wang, Jie Cui, Yi ShanPublished in Environmental Earth Sciences by Springer Science and Business Media LLC in 202510.1007/s12665-025-12138-y
- 11.Author(s): Marc Fransen, Andreas Fürst, Deepak Tunuguntla, Daniel N. Wilke, Benedikt Alkin, Daniel Barreto, Johannes Brandstetter, Miguel Angel Cabrera, Xinyan Fan, Mengwu Guo, Bram Kieskamp, Krishna Kumar, John Morrissey, Jonathan Nuttall, Jin Ooi, Luisa Orozco, Stefanos-Aldo Papanicolopulos, Tongming Qu, Dingena Schott, Takayuki Shuku, WaiChing Sun, Thomas Weinhart, Dongwei Ye, Hongyang ChengPublished in Archives of Computational Methods in Engineering by Springer Science and Business Media LLC in 202510.1007/s11831-025-10322-8
- 12.Author(s): Runpeng Shang, Yugui Yang, Bingxiang Huang, Yong Chen, Chao Qiu, Wang LiuPublished in Computers and Geotechnics by Elsevier BV in 2025, page: 10686310.1016/j.compgeo.2024.106863
- 13.Author(s): Yaodong Ni, Xianlun Leng, Ruirui Wang, Fengmin Xia, Feng Wang, Chengtang WangPublished in International Journal for Numerical and Analytical Methods in Geomechanics by Wiley in 2025, page: 3897-391610.1002/nag.70043
- 14.Author(s): Xin Li, George Kouretzis, Klaus ThoeniPublished in Computers and Geotechnics by Elsevier BV in 2025, page: 10753910.1016/j.compgeo.2025.107539
- 15.Author(s): Yassir Mubarak Hussein Mustafa, Hamzah M. B. Al-Hashemi, Omar Saeed Baghabra Al-Amoudi, Omar Hamdi JasimPublished in Arabian Journal for Science and Engineering by Springer Science and Business Media LLC in 2025, page: 8663-868610.1007/s13369-024-09942-2
- 16.Author(s): Yangpan Fu, Huawei Tong, Jie Yuan, Jie Cui, Yi ShanPublished in 202510.1016/j.jrmge.2025.10.001
- 17.Author(s): Haiyang Zeng, Zhifeng Lin, Guohong Huang, Xiaoqing Yang, Yanfeng Li, Jiabao Su, Wei XuPublished in Journal of Terramechanics by Elsevier BV in 2025, page: 10101210.1016/j.jterra.2024.101012
- 18.Author(s): Xiu-Yang Liu, Ding-Ping Xu, Quan Jiang, Shao-Jun Li, Kang Bian, Shi-Li QiuPublished in Computers and Geotechnics by Elsevier BV in 2025, page: 10741210.1016/j.compgeo.2025.107412
- 19.Author(s): J. E. Alvarez, A. H. Nijkamp, H. Cheng, S. Luding, T. WeinhartPublished in Granular Matter by Springer Science and Business Media LLC in 202410.1007/s10035-024-01395-6
- 20.Author(s): Chang Xia, Zhen Liu, Wei Hu, Jin Liao, Cuiying ZhouPublished in International Journal of Geomechanics by American Society of Civil Engineers (ASCE) in 202410.1061/ijgnai.gmeng-9381
- 21.Author(s): Momme Jahn, Martin MeywerkPublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 2024, page: 2971-299310.1007/s40571-024-00769-0
- 22.Author(s): Zhihao Zhou, Zhen-Yu YIN, Geng-Fu He, Pin Zhang, Mingjing JiangPublished in Computers and Geotechnics by Elsevier BV in 2024, page: 10613710.1016/j.compgeo.2024.106137
- 23.Author(s): Hidenobu Murata, Mikio Yamanoi, Yoshihiro SuzukiPublished in Journal of the Ceramic Society of Japan by Ceramic Society of Japan in 2024, page: 189-19210.2109/jcersj2.23135
- 24.Author(s): Yaodong Ni, Ruirui Wang, Xianlun Leng, Fengmin Xia, Feng WangPublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 2024, page: 371-39810.1007/s40571-024-00806-y
- 25.Author(s): Mengli Kang, Junping Bian, Boyu Li, Xing Fan, Yu Xi, Yaping Wang, Yang Liu, Yao Zhu, Wenhua ZiPublished in International Communications in Heat and Mass Transfer by Elsevier BV in 2024, page: 10775810.1016/j.icheatmasstransfer.2024.107758
- 26.Author(s): Ahmed Hadi, Morteza Moradi, Yusong Pang, Dingena SchottPublished in Scientific Reports by Springer Science and Business Media LLC in 202410.1038/s41598-024-78455-7
- 27.Author(s): Xin-zhi Li, Xian-pu Xiao, Kang Xie, Hong-fei Yang, Liang Xu, Tai-feng LiPublished in Construction and Building Materials by Elsevier BV in 2024, page: 13773410.1016/j.conbuildmat.2024.137734
- 28.Author(s): J.E. Alvarez, H. Cheng, S. Luding, T. WeinhartPublished in International Journal of Solids and Structures by Elsevier BV in 2024, page: 11278610.1016/j.ijsolstr.2024.112786
- 29.Author(s): Xin Li, George Kouretzis, Klaus ThoeniPublished in Computers and Geotechnics by Elsevier BV in 2024, page: 10595710.1016/j.compgeo.2023.105957
- 30.Author(s): Chang Tang, Zi-Jun Cao, Yi Hong, Wei LiPublished in Géotechnique by Emerald in 2024, page: 697-71110.1680/jgeot.22.00144
- 31.Author(s): Ruihuan Ge, Qing LiuPublished in Digital Engineering by Elsevier BV in 2024, page: 10000810.1016/j.dte.2024.100008
- 32.Author(s): Lie Kong, Junlong Shang, Pathegama Gamage Ranjith, Bing Qiuyi Li, Yuqi Song, Wuqiang Cai, Fanlin LingPublished in Engineering Geology by Elsevier BV in 2024, page: 10764910.1016/j.enggeo.2024.107649
- 33.Author(s): Simon Girnth, Tim Heitkamp, Christian Wacker, Nils Waldt, Günter Klawitter, Klaus DröderPublished in Progress in Additive Manufacturing by Springer Science and Business Media LLC in 2024, page: 1967-198310.1007/s40964-023-00543-3
- 34.Author(s): Shiwei Zhao, Jidong ZhaoPublished in Computer Methods in Applied Mechanics and Engineering by Elsevier BV in 2023, page: 11637010.1016/j.cma.2023.116370
- 35.Author(s): Min Wang, Zhenxing Lu, Yanlin Zhao, Wen WanPublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 2023, page: 839-85210.1007/s40571-023-00656-0
- 36.Author(s): Guilherme Barros, Victor Sapucaia, Philipp Hartmann, Andre Pereira, Jerzy Rojek, Klaus ThoeniPublished in Computer Methods in Applied Mechanics and Engineering by Elsevier BV in 2023, page: 11604010.1016/j.cma.2023.116040
- 37.Author(s): Xianyang Liu, Qunwei Wang, Yongwei Wang, Qinxi DongPublished in Scientific Reports by Springer Science and Business Media LLC in 202310.1038/s41598-023-39446-2
- 38.Author(s): Hongyang Cheng, Anthony R. Thornton, Stefan Luding, Andrew L. Hazel, Thomas WeinhartPublished in Computer Methods in Applied Mechanics and Engineering by Elsevier BV in 2023, page: 11565110.1016/j.cma.2022.115651
- 39.Author(s): Sudip Laudari, Benjy Marks, Pierre RognonPublished in Granular Matter by Springer Science and Business Media LLC in 202310.1007/s10035-023-01357-4
- 40.Author(s): Shaojun Feng, Peng Hao, Hao Liu, Bo Wang, Bin Wang, Chen YuePublished in Computer Methods in Applied Mechanics and Engineering by Elsevier BV in 2023, page: 11584110.1016/j.cma.2022.115841
- 41.Author(s): Junsen Xiao, Kenta Tozato, Shuji Moriguchi, Yu Otake, Kenjiro TeradaPublished in Soils and Foundations by Elsevier BV in 2023, page: 10137810.1016/j.sandf.2023.101378
- 42.Author(s): Joaquín Irazábal, Fernando Salazar, David J. VicentePublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 2023, page: 1031-104710.1007/s40571-022-00550-1
- 43.Author(s): Jidong Zhao, Shiwei Zhao, Stefan LudingPublished in Nature Reviews Physics by Springer Science and Business Media LLC in 2023, page: 505-52510.1038/s42254-023-00617-9
- 44.Author(s): Marc P. Fransen, Matthijs Langelaar, Dingena L. SchottPublished in Powder Technology by Elsevier BV in 2023, page: 11852610.1016/j.powtec.2023.118526
- 45.Author(s): Momme Jahn, Martin MeywerkPublished in Computational Particle Mechanics by Springer Science and Business Media LLC in 2023, page: 277-29310.1007/s40571-023-00622-w
- 46.Author(s): Luca Orefice, Johannes G. KhinastPublished in Powder Technology by Elsevier BV in 2023, page: 11877710.1016/j.powtec.2023.118777
- 47.Author(s): Christopher Windows-Yule, Aurelien NeveuPublished in Papers in Physics by Papers in Physics in 2022, page: 14001010.4279/pip.140010
- 48.Author(s): Jacek S. LeszczyńskiPublished in Nonlinear Dynamics by Springer Science and Business Media LLC in 2022, page: 2591-260510.1007/s11071-022-07973-8
- 49.Author(s): Jan Nečas, Jiří Rozbroj, Jakub Hlosta, Jan Diviš, Jiří Kaprálek, David Žurovec, Jiří ZegzulkaPublished in Powder Technology by Elsevier BV in 2022, page: 11741710.1016/j.powtec.2022.117417
- 50.Author(s): Zongqing Zhou, Songsong Bai, Kaiwei Chu, Jinglong Li, Jiwei Sun, Meixia Wang, Yi Sun, Minghao Li, Yuhan LiuPublished in Granular Matter by Springer Science and Business Media LLC in 202210.1007/s10035-022-01264-0
- 1.Author(s): Runpeng Shang, Yugui Yang, Bingxiang Huang, Yong Chen, Chao Qiu, Wang LiuPublished by Elsevier BV in 202410.2139/ssrn.4858451
- 2.Author(s): Xianyang Liu, Qunwei Wang, Yongwei Wang, Qinxi DongPublished by Research Square Platform LLC in 202310.21203/rs.3.rs-2820552/v1
- 3.Author(s): Dusan Ilic, André KatterfeldPublished in Simulations in Bulk Solids Handling by Wiley in 2023, page: 41-7810.1002/9783527835935.ch2
- 4.Author(s): Carolyn Matl, Yashraj Narang, Ruzena Bajcsy, Fabio Ramos, Dieter FoxPublished in 2020
Contributors
Contact person
Related projects
GrainLearning
An artificial brain for interpreting and accelerating physics-based simulations of granular materials