Code and benchmarks for geometry-informed drag term computation for pseudo-3D Stokes simulations with varying apertures

<b>Content:</b><br />
This data set includes snapshots of the code used to compute the benchmarks and applications in Krach et al.(2024). All software tools provided enable the user to perform pseudo-3D Stokes simulations with a geometry-informed drag term using DuMu<sup>x</sup> and to determine permeability, volumetric flux as well as local pressure and velocity fields for both, the domains in the publication as well as user defined geometries.
<br /><br /><br />

<b>Pseudo3D_Stokes:</b> <i>DuMu<sup>x</sup>submodule</i>
<br /><br />
<a href="https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes">Pseudo-3D-Stokes Module</a> for Varying Apertures is a DuMu<sup>x</sup> module developed at research institutions. <a href="https://dumux.org">DuMu<sup>x</sup></a> is a simulation framework focusing on Finite Volume discretization methods, model coupling for multi-physics applications, and flow and transport applications in porous media.
This module aims to assist researchers in planning, improving, or interpreting microfluidic experiments through numerical simulations based on the Stokes equations in an easy and intuitive way. It uses .pgm files as input to create numerical grids. These .pgm files should include 8 bit grayscale values referring to the relative height of a microfluidic cell, which can be created from microscopy images of a microfluidic experiment using suitable image processing procedures.
Based on the .pgm files, the python module localdrag (see below) should be used to create the suitable drag prefactor fields lambda1 and lambda2. For further details, refer to our publication (see below). Please check out the <a href="https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes/-/blob/d48f56741962222572a657bcd0f4b56ac83eb4b2/README.md">README</a> for information on requirements, building DuMu<sup>x</sup> including its submodule and examples.

<br /><br /><br />

<b>localdrag:</b> <i>python preprocessing module</i>
<br /><br />
<a href="https://git.iws.uni-stuttgart.de/krachdd/localdrag">localdrag</a> is a python module to create geometry informed pre-factor maps for pseudo-3D Stokes simulations with DuMu<sup>x</sup> based on local pore morphology. localdrag is used as a preprocessing tool for the DuMu<sup>x</sup> module pseud3D_stokes and is delivered directly when the pseudo3D_stokes is cloned with the recurse-submodules option (recommended, see <a href="https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes/-/blob/d48f56741962222572a657bcd0f4b56ac83eb4b2/README.md">README</a>).
<br /><br /><br />

<b>Related datasets and repositories:</b><br />
<ul>
<li>
POREMAPS, 3D Stokes solver used to create reference solutions:<br /> <a href="https://git.rwth-aachen.de/david.krach/poremaps">git repository</a>, <a href="https://doi.org/10.18419/darus-3676">DaRUS dataset</a> </li>
<li>
DuMu<sup>x</sup>: <br />
<a href="https://dumux.org">Website</a>, <a href="https://git.iws.uni-stuttgart.de/dumux-repositories/dumux">git repository</a>
</li>
<li>
Pseudo3D_Stokes: <br />
<a href="https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes">git repository</a>
</li>
<li>
Image dataset of micromodel with precipitation: <br /> <a href="https://doi.org/10.18419/darus-1799">DaRUS dataset</a>, <a href="https://doi.org/10.1007/s11242-022-01782-8">research paper</a>
</li>
<li>
localdrag python module for preprocessing and data handling:<br /> <a href="https://git.iws.uni-stuttgart.de/krachdd/localdrag">git repository</a>
</li>
<li>
Input data and results for all domains in Krach et al. (2024):<br /> <a href="https://doi.org/10.18419/darus-4347">DaRUS dataset</a>
</li>
</ul>