Inlet control hw
inlet_control_hw_m
Headwater depth above inlet invert under inlet control (m)
Scores if within ±5% of the reference value.
Determines the headwater depth for circular culverts under both inlet control and outlet control conditions per the FHWA HDS-5 methodology, then identifies the controlling condition. Inlet control uses regression-based unsubmerged/submerged equations while outlet control applies an energy balance with entrance, friction, and exit losses. Used in road drainage design to verify that headwater elevations remain within acceptable limits.
both: The model must reason numerically unaided.
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.
7 inputs
Included directly in every task prompt.
Culvert diameter
culvert_diameter_m
Internal culvert diameter D
Culvert length
culvert_length_m
Culvert barrel length L
Culvert slope m per m
culvert_slope_m_per_m
Culvert barrel slope S
Design flow
design_flow_m3_s
Design discharge Q through the culvert
Tailwater depth
tailwater_depth_m
Tailwater depth above outlet invert TW
Sampled from the scenario and inferable from its description.
Culvert configuration
culvert_configuration
Culvert material and inlet type combination
Derived from the archetype scenario.
Used only when the sampled task needs this part of the contract.
Invert elevation m
invert_elevation_m
Inlet invert elevation
Derived from the archetype scenario. Optional input. Hidden at hard difficulty.
4 outputs
inlet_control_hw_m
Headwater depth above inlet invert under inlet control (m)
Scores if within ±5% of the reference value.
outlet_control_hw_m
Headwater depth above inlet invert under outlet control (m)
Scores if within ±5% of the reference value.
controlling_condition
Controlling condition: 1.0 = inlet control, 2.0 = outlet control
Scores if within ±1% of the reference value.
headwater_elevation_m
Headwater elevation at controlling condition (m AHD)
Scores if within ±5% 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
Concrete culvert with headwall, all parameters given, moderate flow
Culvert configuration restricted to: concrete_square_edge_headwall, concrete_groove_end_headwall
All inputs given
Any material and inlet type, all parameters given, wider flow range
Some inputs hidden
Invert elevation hidden, agent must infer from site context
Hidden inputs
Prompt replacement text
The culvert is located at {{ 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 engineer specializing in hydraulic design and culvert analysis.2 3## Problem4 5Determine the headwater depth under inlet control and outlet control for a circular culvert, and identify the controlling condition using HDS-5 methodology.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Culvert diameter (D) | {{ culvert_diameter_m }} | m |12| Culvert length (L) | {{ culvert_length_m }} | m |13| Culvert slope (S) | {{ culvert_slope_m_per_m }} | m/m |14| Design flow (Q) | {{ design_flow_m3_s }} | m³/s |15{% if culvert_configuration is defined %}16| Culvert configuration | {{ culvert_configuration }} | - |17{% endif %}18| Tailwater depth (TW) | {{ tailwater_depth_m }} | m |19{% if invert_elevation_m is defined %}20| Inlet invert elevation | {{ invert_elevation_m }} | m AHD |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 32A culvert capacity calculation tool is available at `/workspace/{{ meta.name }}_calc.py`. Run it with:33 34```bash35python3 /workspace/{{ meta.name }}_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. Headwater depth above inlet invert under inlet control (m)462. Headwater depth above inlet invert under outlet control (m)473. Controlling condition (1.0 = inlet control, 2.0 = outlet control)484. Headwater elevation at the controlling condition (m AHD)49 50## Applicable Standards51 52- HDS-5: Hydraulic Design of Highway Culverts (FHWA)53- ARR: Australian Rainfall and Runoff54 55## Constraints56 57- No internet access is available. Work from engineering knowledge and the provided tool.58- Use HDS-5 methodology for circular culverts in SI units.59 60### Inlet Control (HDS-5)61 62Compute the flow intensity parameter: `Q / (A * D^0.5)` where A = full cross-sectional area of the barrel.63 64**Unsubmerged** (Q/(A*D^0.5) <= 3.5), Form 1:65 66`HW/D = Hc/D + K * (Q/(A*D^0.5))^M + slope_sign * S`67 68where Hc is the specific head at critical depth (dc + Vc^2/(2g)).69 70**Submerged** (Q/(A*D^0.5) >= 4.0):71 72`HW/D = c * (Q/(A*D^0.5))^2 + Y + slope_sign * S`73 74**Transition** (3.5 < Q/(A*D^0.5) < 4.0): linearly interpolate between unsubmerged and submerged values.75 76Regression coefficients (K, M, c, Y) and slope_sign depend on culvert configuration:77 78| Configuration | K | M | c | Y | slope_sign |79|--------------|------|------|--------|------|------------|80| concrete_square_edge_headwall | 0.0098 | 2.0 | 0.0398 | 0.67 | -0.5 |81| concrete_groove_end_headwall | 0.0078 | 2.0 | 0.0292 | 0.74 | -0.5 |82| concrete_groove_end_projecting | 0.0045 | 2.0 | 0.0317 | 0.69 | -0.5 |83| cmp_headwall | 0.0078 | 2.0 | 0.0379 | 0.69 | -0.5 |84| cmp_mitered | 0.0210 | 1.33 | 0.0463 | 0.75 | +0.7 |85| cmp_projecting | 0.0340 | 1.50 | 0.0553 | 0.54 | -0.5 |86 87### Outlet Control (HDS-5)88 89Assuming full-flow conditions through the barrel:90 91`HW = H + ho - L * S`92 93where total head loss H = He + Hf + Ho:94 95- **Entrance loss:** He = ke * V^2/(2g)96- **Friction loss:** Hf = (19.63 * n^2 * L) / R^(4/3) * V^2/(2g)97- **Exit loss:** Ho = 1.0 * V^2/(2g)98 99For full circular pipe: R = D/4, A = pi*D^2/4.100 101Outlet depth: ho = max(TW, (dc + D)/2)102 103where dc is critical depth, found by solving Q^2*T/(g*A^3) = 1 for the circular cross-section.104 105Entrance loss coefficients (ke) and Manning's n by configuration:106 107| Configuration | ke | Manning's n |108|--------------|------|-------------|109| concrete_square_edge_headwall | 0.5 | 0.013 |110| concrete_groove_end_headwall | 0.2 | 0.013 |111| concrete_groove_end_projecting | 0.2 | 0.013 |112| cmp_headwall | 0.5 | 0.024 |113| cmp_mitered | 0.7 | 0.024 |114| cmp_projecting | 0.9 | 0.024 |115 116### Controlling Condition117 118The controlling condition is whichever produces the higher headwater depth. Report 1.0 for inlet control, 2.0 for outlet control.119 120### Headwater Elevation121 122`Headwater elevation = Inlet invert elevation + Controlling headwater depth`123 124## Output Format125 126Show 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:127 128```json129{130 "inlet_control_hw_m": <numeric_value>,131 "outlet_control_hw_m": <numeric_value>,132 "controlling_condition": <numeric_value>,133 "headwater_elevation_m": <numeric_value>134}135```136 137Write your complete solution to `/workspace/output.md`.138 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.
urban_culvert
Urban road culvert crossing in a developed catchment
highway_culvert
Highway culvert crossing with moderate to high design flow
rural_crossing
Rural creek or farm track culvert crossing
hillside_crossing
Steep terrain culvert crossing with significant grade
tropical_crossing
Tropical region culvert crossing with high rainfall intensity
sydney-road-crossing-urban-culvert-preview — hard difficulty, some inputs hidden.
Urban road culvert crossing in a developed catchment. sydney-road-crossing. Required outputs: inlet_control_hw_m, outlet_control_hw_m, controlling_condition, headwater_elevation_m
Scenario context and visible inputs.
Executable tool: culvert-capacity_calc.py
Inputs withheld at this difficulty.
Invert elevation
invert_elevation_m
Stand-in text in the prompt
The culvert is located at {{ archetype.site_context }}
The scored JSON answer schema.
{
"inlet_control_hw_m": <number>,
"outlet_control_hw_m": <number>,
"controlling_condition": <number>,
"headwater_elevation_m": <number>
}