DuMux

Configure, run, and validate DuMux groundwater flow simulations with unit-safe conversion tools.

155|6|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill dumux-lzwei196
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: DuMux
Source: https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation/tree/main/models/DuMux
Command: npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill dumux-lzwei196

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pandas, matplotlib, pyyaml, vtk, meshio, and includes scripts (resource) and references (resource) components.

What problem does it solve? Running DuMux (the DUNE-based porous-media flow simulator) correctly requires deep operational knowledge: converting soil and forcing data into strict SI units, writing valid INI parameter files, building C++ examples, and diagnosing silent failures like inverted recharge signs or gauge-vs-absolute pressure errors. This Skill packages that expertise so an agent can execute real DuMux groundwater simulations without substituting approximations. ## Core Features & Use Cases - Validated pipeline tools: Four Python tools convert meteorological forcing to Neumann recharge fluxes (kg/(m²·s)), convert soil/HWSD data to intrinsic permeability and van Genuchten parameters, run the DuMux binary, and parse VTK output into CSV time series. - Diagnostic recovery: 22 symptom→diagnosis→remedy triplets plus a preflight check script catch known failure modes (unit traps, Newton divergence, grid mismatches) before and during runs. - Use Case: Simulate steady-state groundwater head over the High Plains aquifer: convert GLHYMPS permeability and CMFD recharge, run the 1p Darcy model, then compare simulated hydraulic head against 14,351 well observations (documented NSE=0.74). ## Quick Start Run python preflight_check.py in this directory, then ask the agent to build and execute the DuMux 1ptracer example with your domain, recharge, and permeability inputs.

Frequently Asked Questions about DuMux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a DuMux groundwater simulation?

Run preflight_check.py first to verify the binary and environment, then configure the domain grid, convert forcing and soil data with the provided tools, and execute via tools/run_dumux.py. Output is written as VTK files parseable into CSV time series.

How to convert hydraulic conductivity to DuMux permeability?

DuMux requires intrinsic permeability in m², not hydraulic conductivity in m/s. Convert with K[m²] = K_h[m/s] × μ/(ρ×g) ≈ K_h × 1.02e-7; the convert_soil_to_dumux.py tool handles this automatically from m/s, cm/day, or darcy inputs.

Why is my DuMux recharge boundary condition wrong?

DuMux Neumann fluxes are positive outward, so recharge (inflow) must be negative, and units must be kg/(m²·s), not mm/day. Divide mm/day by 86400 and negate the sign, otherwise recharge silently acts as extraction.

Does DuMux use gauge or absolute pressure?

DuMux uses absolute pressure in Pa; the surface is approximately 101325 Pa and hydrostatic pressure is p = 101325 + ρ·g·depth. Using gauge pressure shifts the head solution by about 10.3 m and can reverse flow direction.

What are the limitations of the documented DuMux groundwater cases?

The validated cases use uniform permeability (GLHYMPS median) and steady-state 1p flow, so they cannot capture heterogeneity-driven or pumping-dominated head fields. Pumping wells require transient mode with explicit source/sink terms.