Delft3D

Configures, runs, and validates Delft3D hydrodynamic simulations via scripted pipeline tools.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires netCDF4, numpy, pandas, xarray, matplotlib, pyyaml, scipy, and includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up and running Delft3D coastal, estuarine, and river hydrodynamic simulations normally requires manual GUI workflows and deep knowledge of unit conventions, file formats, and failure modes; this Skill encodes that operational expertise so an agent can prepare inputs, execute the model, and diagnose failures reliably. ## Core Features & Use Cases - Scripted 8-stage pipeline: Five validated Python tools convert GEBCO/ETOPO bathymetry, ERA5/CMFD meteorological forcing, and tide/river boundary data into Delft3D formats, run the DIMR orchestrator, and parse NetCDF outputs into metrics and plots. - Diagnostic recovery: Sixteen symptom-diagnosis-remedy triplets plus a preflight check catch silent unit errors (hPa vs Pa pressure, bathymetry sign, wind direction convention) before they corrupt results. - Validation against cited standards: Outputs are graded against literature-cited pass bands (e.g., water level RMSE <= 0.1 m) rather than intuition, with water level as the rank-1 headline variable. - Use Case: An agent tasked with modeling tidal water levels in an estuary uses the tools to convert ERA5 forcing and FES2014 tidal boundaries, execute D-Flow FM via DIMR, and validate the resulting water level series against tide gauge observations. ## Quick Start Run python preflight_check.py in this directory, then ask the agent to set up and execute a D-Flow FM simulation for your domain using the F34 example configuration as a template.

Frequently Asked Questions about Delft3D

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

FAQPage Schema
How do I run a Delft3D D-Flow FM simulation from the command line?

Run the DIMR orchestrator with a dimr_config.xml that references your .mdu master definition file, or use the run_delft3d.py tool which adds preflight checks and monitoring. Parallel runs use mpirun -np N dimr dimr_config.xml.

How do I convert GEBCO bathymetry to Delft3D depth format?

Use convert_bathymetry.py with the --negate_depth flag, because GEBCO stores elevation positive-up while Delft3D expects depth positive-down. The tool reads the NetCDF file, interpolates onto your grid, and writes .xyz, .dep, or NetCDF output with plausibility checks.

What is the difference between D-Flow FM and Delft3D-FLOW?

D-Flow FM is the modern unstructured flexible-mesh engine using .mdu configuration and UGRID NetCDF grids, while Delft3D-FLOW is the legacy structured curvilinear-grid engine using .mdf and .grd files. Both are orchestrated through DIMR and supported by this pipeline.

Why does my Delft3D run produce wrong water levels without crashing?

Silent water-level errors usually come from unit conventions: atmospheric pressure in hPa instead of Pa weakens the inverse-barometer response about 100x, and unprojected geographic coordinates corrupt cell areas. Check diagnostics/triplets.yaml for the matching symptom-remedy entry.

What input data does a Delft3D hydrodynamic model require?

You need a grid file, bathymetry (e.g., GEBCO), meteorological forcing such as ERA5 wind and pressure, open-boundary conditions from a tide model like FES2014 or TPXO, and optionally river discharge from gauges or CaMa-Flood. Observation data from tide gauges is used for validation.

What are the limitations of Delft3D shallow-water simulations?

The hydrostatic shallow-water approximation cannot resolve non-hydrostatic vertical accelerations such as plunging breakers or sharp fronts. Wave dynamics, sediment kinetics, and water quality require separate coupled modules (D-Waves, D-Water Quality) rather than the hydrodynamic kernel alone.