DLBreach

Runs DLBreach dam and levee breach simulations and couples breach outflow with CaMa-Flood routing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve? Running the DLBreach Fortran dam/levee breach model requires deep operational knowledge: card-based input formatting, mixed hour/second unit conventions, Wine-based binary execution on Linux, and coupling with CaMa-Flood. This Skill packages that expertise so an AI agent can build, execute, validate, and couple breach simulations without silent scientific errors. ## Core Features & Use Cases - End-to-end 8-stage pipeline: 11 tools covering installation verification, dam geometry and reservoir curve generation, CaMa-Flood inflow conversion, breach configuration, Fortran binary execution via Wine, 13-column output parsing, breach-flow injection back into CaMa-Flood, and hydrograph/geometry visualization. - Diagnostic recovery: 29 symptom-diagnosis-remedy triplets in diagnostics/triplets.yaml cover known failure modes such as empty output from a missing Downstream_Channel_Flow_Out card, hours-vs-seconds unit corruption, and explicit-scheme timestep instability. - Validation grounding: dag.yaml defines breach_discharge as the rank-1 validation output with cited PBIAS pass bands, and preflight_check.py verifies the binary, Wine runtime, Python environment, and test cases before any run. - Use Case: Given a dam's geometry and reservoir storage curve, extract the CaMa-Flood outflw hydrograph at the dam cell, simulate an overtopping breach with cohesive headcut erosion, then inject the resulting breach hydrograph into CaMa-Flood to route the downstream flood wave. ## Quick Start Run python preflight_check.py in this directory, then ask the agent to build and execute a DLBreach overtopping breach simulation for your dam using the staged tools.

Frequently Asked Questions about DLBreach

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

FAQPage Schema
How do I run a DLBreach dam breach simulation?

Run preflight_check.py first to verify the binary and environment, then follow the 8-stage pipeline: generate dam geometry and reservoir curve cards, convert inflow, assemble casename.txt, and execute via tools/s6_execution/run_dlbreach.py, which handles Wine invocation automatically.

How do I couple DLBreach breach outflow with CaMa-Flood?

Extract CaMa-Flood outflw at the dam grid cell with convert_cama_to_inflow.py as the DLBreach inflow. After the breach run, use inject_breach_to_cama.py to add breach plus spillway discharge as runoff at the first downstream CaMa cell, then rerun CaMa-Flood.

Can DLBreach run on Linux?

Yes, the DLBreach_Barrier.exe Fortran binary runs on Linux through Wine, invoked as echo "casename" | wine DLBreach_Barrier.exe. The run_dlbreach.py tool handles Wine execution automatically; a native Linux binary can also be supplied.

Why is my DLBreach output file empty?

The Fortran binary requires the Downstream_Channel_Flow_Out card with width, slope, and Manning's n; omitting it produces an empty output file. Regenerate the input with assemble_input_file.py, which appends this card, then rerun.

What units does DLBreach use for time and slopes?

DLBreach mixes conventions: inflow and water-level time series and output time are in hours, while Time_Step and Simulation_Period are in seconds. Slopes are V/H ratios, water levels are meters above the embankment base, and all other quantities are SI.

Which DLBreach parameters most affect peak breach discharge?

The cohesive erosion coefficient kd (2.5-30.0 cm3/N-s) is the most sensitive parameter for cohesive dams, followed by critical shear stress Tauc and inflow discharge. For non-cohesive dams, sediment diameter d50 and Breach_Manning_n dominate.