Code and benchmarks for a vertically averaged drag term for pseudo-3D Stokes simulations

<b>Content:</b><br />
This data set includes snapshots of the code used to compute the benchmarks and applications in Krach et al (2026). The included software tools allow users to conduct pseudo-3D Stokes simulations with a geometry-informed drag term as well as analytical drag terms using DuMu<sup>x</sup>. Users can determine permeability, volumetric flux, and local pressure and velocity fields for both the geometries featured in the publication and custom-defined domains.
<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 within academic research. <a href="https://dumux.org">DuMu<sup>x</sup></a> is a simulation toolkit specializing in Finite Volume discretization, multi-physics model coupling, and flow and transport processes in porous media.
This module is designed to help researchers plan, optimize, or analyze microfluidic systems through easy-to-use numerical simulations tools based on the Stokes equations. It utilizes .pgm files as input to generate numerical grids. These files should contain 8-bit grayscale values representing the relative height of a microfluidic cell, which can be derived from microscopy images of microfluidic experiments using appropriate image processing techniques.
Using the .pgm files, the python module localdrag (see below) may be used to create the suitable drag prefactor fields lambda1 and lambda2 or the user can choose the analytical drag formulation. 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 that generates geometry-informed prefactor maps for pseudo-3D Stokes simulations in DuMu<sup>x</sup>, based on local pore morphology. It serves as a preprocessing tool for the DuMu<sup>x</sup> module pseud3D_stokes and is automatically included when 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>

**内容：**
本数据集包含用于复现Krach等人(2026)研究中基准测试与应用的代码快照。所附软件工具支持用户基于DuMuˣ开展带有几何感知阻力项及解析阻力项的伪三维斯托克斯（Stokes）模拟。用户可针对论文中提及的几何构型与自定义域，计算渗透率、体积流量以及局部压力与速度场。

**Pseudo3D_Stokes：DuMuˣ子模块**
面向变孔径的伪三维斯托克斯模块（Pseudo-3D-Stokes Module）是一项基于学术研究开发的DuMuˣ模块。DuMuˣ是一款专注于有限体积离散、多物理场耦合以及多孔介质内流动与输运过程的仿真工具包。
本模块旨在通过基于斯托克斯（Stokes）方程的易用数值仿真工具，助力研究人员规划、优化或分析微流控系统。该模块采用.pgm文件作为输入以生成数值网格，此类文件需包含代表微流控单元相对高度的8位灰度值，这类数据可通过对微流控实验的显微图像采用合适的图像处理技术获取。
借助.pgm文件，可使用Python模块localdrag（详见下文）生成适配的阻力预因子场λ₁与λ₂，用户也可选择解析阻力公式。更多细节请参阅我们的相关论文（详见下文）。请查阅[README文档](https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes/-/blob/d48f56741962222572a657bcd0f4b56ac83eb4b2/README.md)以了解环境要求、包含子模块的DuMuˣ构建方法及示例。

**localdrag：Python预处理模块**
localdrag是一款Python模块，可基于局部孔隙形貌为DuMuˣ中的伪三维斯托克斯（Stokes）模拟生成几何感知的预因子映射图。该模块作为DuMuˣ的pseud3D_stokes模块的预处理工具，当通过`--recurse-submodules`选项克隆pseudo3D_stokes时，会自动包含该模块（推荐操作，详见[README文档](https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes/-/blob/d48f56741962222572a657bcd0f4b56ac83eb4b2/README.md)）。

**相关数据集与存储库：**
- POREMAPS：用于生成参考解的三维斯托克斯（Stokes）求解器：[Git存储库](https://git.rwth-aachen.de/david.krach/poremaps)、[DaRUS数据集](https://doi.org/10.18419/darus-3676)
- DuMuˣ：[官方网站](https://dumux.org)、[Git存储库](https://git.iws.uni-stuttgart.de/dumux-repositories/dumux)
- Pseudo3D_Stokes：[Git存储库](https://git.iws.uni-stuttgart.de/krachdd/pseudo3D_stokes)
- 带有沉淀过程的微模型图像数据集：[DaRUS数据集](https://doi.org/10.18419/darus-1799)、[研究论文](https://doi.org/10.1007/s11242-022-01782-8)
- 用于预处理与数据处理的localdrag Python模块：[Git存储库](https://git.iws.uni-stuttgart.de/krachdd/localdrag)
- Krach等人(2024)研究中所有域的输入数据与结果：[DaRUS数据集](https://doi.org/10.18419/darus-4347)