Exit gradient
exit_gradient
Exit gradient at the downstream toe i_exit (dimensionless)
Scores if within ±3% of the reference value.
Computes the exit hydraulic gradient at a dam or levee downstream toe using i_exit = delta_h / L_seepage, and the critical gradient for piping initiation from i_cr = (G_s - 1) / (1 + e), per USACE EM 1110-2-1901. Derives the factor of safety against piping and the saturated and buoyant unit weights of the foundation soil. Used in dam safety and geotechnical seepage analysis.
with-tool: The model is given an executable Python calculator script.
Standards
One template produces many comparable benchmark tasks while keeping the scoring contract fixed.
01
The reusable contract shown on this page.
02
An archetype and site context are sampled.
03
Inputs may be hidden at harder tiers.
04
The model responds with the declared outputs.
Inputs the model receives, and the outputs it is scored on.
5 inputs
Included directly in every task prompt.
Head difference
head_difference_m
Head difference across the structure (upstream pool minus tailwater level)
Seepage path length
seepage_path_length_m
Total seepage path length through the foundation from upstream to downstream toe
Sampled from the scenario and inferable from its description.
Specific gravity
specific_gravity
Specific gravity of foundation soil solids G_s
Derived from the archetype scenario. Hidden at hard difficulty.
Void ratio
void_ratio
Void ratio of the foundation soil e
Derived from the archetype scenario. Hidden at hard difficulty.
Foundation soil type
foundation_soil_type
Foundation soil classification
Derived from the archetype scenario. Hidden at hard difficulty.
5 outputs
exit_gradient
Exit gradient at the downstream toe i_exit (dimensionless)
Scores if within ±3% of the reference value.
critical_gradient
Critical hydraulic gradient for piping initiation i_cr (dimensionless)
Scores if within ±3% of the reference value.
factor_of_safety
Factor of safety against piping FoS = i_cr / i_exit (dimensionless)
Scores if within ±3% of the reference value.
saturated_unit_weight_kn_m3
Saturated unit weight of foundation soil gamma_sat (kN/m3)
Scores if within ±3% of the reference value.
buoyant_unit_weight_kn_m3
Buoyant (submerged) unit weight of foundation soil gamma_b (kN/m3)
Scores if within ±3% of the reference value.
Each template is sampled at three tiers. Harder tiers may hide inputs, forcing the model to infer them from the scenario description.
All inputs given
Simple earth dam scenario, all parameters given including soil properties
Foundation soil type restricted to: clean_sand
All inputs given
All parameters given, wider range of structure types and soil conditions
Some inputs hidden
Specific gravity, void ratio, and soil type hidden; agent infers from site context
Hidden inputs
Prompt replacement text
The structure is a {{ archetype.description }} ({{ archetype.site_context }})
The exact instruction and parameter contract used to generate this task, pinned to the published library source.
/workspace
Teal lines show Jinja input conditions, not task visibility policy. A line renders only when that input or tool is visible.
1You are a senior civil/dams engineer specializing in seepage analysis and dam safety.2 3## Problem4 5Calculate the exit gradient at the downstream toe of a hydraulic structure and determine the factor of safety against piping failure.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Head difference (delta_h) | {{ head_difference_m }} | m |12| Seepage path length (L) | {{ seepage_path_length_m }} | m |13{% if specific_gravity is defined %}14| Specific gravity of soil solids (G_s) | {{ specific_gravity }} | - |15{% endif %}16{% if void_ratio is defined %}17| Void ratio (e) | {{ void_ratio }} | - |18{% endif %}19{% if foundation_soil_type is defined %}20| Foundation soil type | {{ foundation_soil_type }} | - |21{% endif %}22{% if archetype_description is defined %}23 24### Site Conditions25 26{{ archetype_description }}27{% endif %}28 29{% if tool_available %}30## Available Tool31 32An exit gradient calculation tool is available at `/workspace/exit-gradient_calc.py`. Run it with:33 34```bash35python3 /workspace/exit-gradient_calc.py --help36```37 38You may use this tool to verify your calculations or compute values directly.39{% endif %}40 41## Required42 43Calculate the following:44 451. Exit gradient at the downstream toe i_exit (dimensionless)462. Critical hydraulic gradient for piping initiation i_cr (dimensionless)473. Factor of safety against piping FoS (dimensionless)484. Saturated unit weight of foundation soil gamma_sat (kN/m3)495. Buoyant unit weight of foundation soil gamma_b (kN/m3)50 51## Applicable Standards52 53- USACE EM 1110-2-1901 — Seepage Analysis and Control for Dams54- FEMA P-1032 — Dam Safety: Evaluation of Seepage55 56## Constraints57 58- No internet access is available. Work from engineering knowledge and the provided tool.59- Use the direct gradient approach for exit gradient:60 - **i_exit = delta_h / L_seepage**61 - Where delta_h is the head difference across the structure and L_seepage is the total seepage path length62- Use the critical gradient formula for piping initiation:63 - **i_cr = (G_s - 1) / (1 + e)**64 - Where G_s is the specific gravity of soil solids and e is the void ratio65- Factor of safety against piping:66 - **FoS = i_cr / i_exit**67 - USACE requires FoS >= 3 to 5 for dams; FoS >= 1.5 for temporary works68- Saturated unit weight:69 - **gamma_sat = (G_s + e) / (1 + e) * gamma_w**70- Buoyant (submerged) unit weight:71 - **gamma_b = gamma_sat - gamma_w = (G_s - 1) / (1 + e) * gamma_w**72- Use gamma_w = 9.81 kN/m373- Typical specific gravity values: clean sand 2.65, silty sand 2.66, sandy silt 2.67, clayey silt 2.70, silty clay 2.7274- Typical void ratio ranges: clean sand 0.55-0.75, silty sand 0.45-0.65, sandy silt 0.40-0.60, clayey silt 0.35-0.55, silty clay 0.30-0.5075 76## Output Format77 78Show your step-by-step working in Markdown, including formulas and intermediate calculations. At the end of your solution, include a JSON block with your final answers in exactly this format:79 80```json81{82 "exit_gradient": <numeric_value>,83 "critical_gradient": <numeric_value>,84 "factor_of_safety": <numeric_value>,85 "saturated_unit_weight_kn_m3": <numeric_value>,86 "buoyant_unit_weight_kn_m3": <numeric_value>87}88```89 90Write your complete solution to `/workspace/output.md`.91 Each generated task is drawn from one of these realistic scenario bands.
Site contexts ground each scenario in a real locale the model can use to infer hidden values.
earth_dam_sand
Earth embankment dam on clean sand foundation with moderate head
concrete_gravity_dam
Concrete gravity dam on silty sand foundation with high head
levee_alluvial
Levee on alluvial soil foundation with low to moderate head
sheet_pile_cofferdam
Sheet pile cofferdam on sandy foundation with low head
snowy-mountains-hydro-dam-concrete-gravity-dam-preview — hard difficulty, some inputs hidden.
Concrete gravity dam on silty sand foundation with high head. snowy-mountains-hydro-dam. Required outputs: exit_gradient, critical_gradient, factor_of_safety, saturated_unit_weight_kn_m3, buoyant_unit_weight_kn_m3
Scenario context and visible inputs.
Executable tool: exit-gradient_calc.py
Inputs withheld at this difficulty.
Specific gravity
specific_gravity
Void ratio
void_ratio
Foundation soil type
foundation_soil_type
Stand-in text in the prompt
The structure is a {{ archetype.description }} ({{ archetype.site_context }})
The scored JSON answer schema.
{
"exit_gradient": <number>,
"critical_gradient": <number>,
"factor_of_safety": <number>,
"saturated_unit_weight_kn_m3": <number>,
"buoyant_unit_weight_kn_m3": <number>
}