Abstract
•A detailed, practical description of a 2D lattice Boltzmann (LB) free-surface model and its coupling with a 1D LB shallow water model is provided.•A Python code is provided, that implements the Gaussian droplet benchmark of the research article (Thorimbert et al., 2019) corresponding to this method article.•Particular attention is given to the details of the free-surface implementation which, in the literature, vary among authors. These ambiguities must be addressed in order to build a reproducible scheme, as well as the exact implementation and parameters of the coupling model proposed in the associated research article.