Single-Phase Multi-Scale Porous Media (Greyscale Model - lbpm_greyscale_simulator)¶
The LBPM model to simulate single-phase multi-scale porous media, also called greyscale model, is constructed to approximate the solution of the Darcy-Brinkman equations in grey regions, coupled to a Navier-Stokes solution in open regions. The generalized model for isothermal fluid flow in porous media employs volume-averaged Navier-Stokes equations that account for both linear and nonlinear drag effects:
In this formulation, \(p\) and \(\boldsymbol{u}\) denote the volume-averaged pressure and velocity, respectively, and \(\rho\) represents the fluid density. The model incorporates \(\nu\) as the kinematic viscosity of the fluid and \(\nu_eff\) as an effective viscosity parameter. External force effects are captured through the acceleration term \(\boldsymbol{g}\). The geometric function \(F_e\), derived from Ergun’s experimental investigations, characterizes the porous medium structure through the relation:
LBM Formulation¶
Click here to open: LBM Formulation
A multiple-relaxation-time (MRT) lattice Boltzmann equation with D3Q19 discretization describes momentum transport for the phase-averaged equations:
The total force \(\boldsymbol{F}\) is imposed based on the discrete force construction developed by Guo et al. (2002):
The fluid velocity is computed through the relation for the forcing scheme:
However, to handle the nonlinearity arising from the velocity-dependent force term, an explicit solution for the velocity is employed:
that utilizes a temporal velocity field \(\boldsymbol{v}\):
and the coefficients governing this nonlinear transformation are:
where \(c_s^2 = 1/3\) is the speed of sound and \(\boldsymbol{\xi}_q\) are the unit lattice vectors for the D3Q19 lattice discretization:
The moments defined in the Gram-Schmidt basis are linearly independent functions of the distribution functions:
The equilibrium formulation is adapted from the generalized volume-averaged macroscopic equations. As established in the appendix of Guo and Zhao (2002), the definition of the equilibrium distribution function yields the following moments, where the presence of the porous matrix modifies the second-order velocity terms by a factor of \(1/\epsilon\):
Applying this to the D3Q19 MRT basis yields the corresponding equilibrium moments, given by:
Note
Although the theoretical derivation of the macroscopic equations yields the non-zero expressions shown above for \(m_{10}^{eq}\) and \(m_{12}^{eq}\), the actual LBPM MRT implementation enforces these moments to be strictly zero (i.e., \(m_{10}^{eq} = 0\) and \(m_{12}^{eq} = 0\)). The theoretical values remain commented out in the source code.
The relaxation parameters for the momentum diffusion (collision operator) are determined based on the effective relaxation time \(\tau_{eff}\):
where the effective relaxation time \(\tau_{eff}\) is related to the effective kinematic viscosity of the fluid by \(\nu_{eff} = (\tau_{eff} - 1/2)/3\). Note that in the generalized volume-averaged formulation, this effective viscosity \(\nu_{eff}\) dictates the viscous momentum diffusion (Brinkman term), while the linear drag term (Darcy) depends strictly on the thermodynamic fluid kinematic viscosity \(\nu\), defined by the base relaxation time \(\tau\). The relation imposed on the even relaxation times enforces the no-slip velocity condition exactly at a position one-half lattice spacing from the solid boundary. Consequently, it leads to a viscosity-independent numerical error in the permeability estimate.
Run lbpm_greyscale_simulator¶
To use the lbpm_greyscale_simulator, the input image should be segmented into “grey” and open regions. Each particular “grey” label should be assigned both a porosity and permeability value.
A typical command to launch the LBPM color simulator is as follows
`
mpirun -np $NUMPROCS lbpm_greyscale_simulator input.db
`
where $NUMPROCS is the number of MPI processors to be used and input.db is
the name of the input database that provides the simulation parameters.
Note that the specific syntax to launch MPI tasks may vary depending on your system.
For additional details please refer to your local system documentation.
Model parameters¶
The essential model parameters for the single phase greyscale model are
tau– control the fluid viscosity – \(0.7 < \tau < 1.5\)
The kinematic viscosity is given by