LIVEdataset releasetasks 552models 18last submission … · built …
task library
built templatespillway-hydraulicswith-tool

Spillway Weir Capacity

Calculates spillway discharge capacity using the weir equation Q = C*L_eff*H_e^1.5 with pier and abutment contraction corrections to effective crest length and approach velocity head adjustments per USBR Design Standard No. 14 and USACE EM 1110-2-1603. Supports ogee and broad-crested weir types for dam safety and flood routing assessments.

inputs

8 fields

context

5 archetypes

engine

with-tool

outputs

5 scored fields

contract fields

Parameter Map

8 inputs to 5 scored outputs

  • crest_length_m

    float

    Gross crest length of the spillway L

    3 to 120m

  • design_head_m

    float

    Design head over the spillway crest H

    0.3 to 8m

  • discharge_coefficient

    floatfrom archetypehidden in hard

    Weir discharge coefficient C (SI metric)

    1.4 to 2.25

  • number_of_piers

    intoptional

    Number of piers on the spillway crest N

    0 to 8

  • pier_shape

    enumoptionalfrom archetypehidden in hard

    Pier nose geometry for contraction coefficient Kp

    squareroundpointed

  • abutment_shape

    enumoptionalfrom archetypehidden in hard

    Abutment geometry for contraction coefficient Ka

    squareroundedstreamlined

  • approach_channel_width_m

    floatoptional

    Width of the approach channel upstream of the spillway B

    5 to 200m

  • approach_depth_m

    floatoptional

    Depth of flow in the approach channel h_approach

    0.5 to 15m
effective_crest_length_mtol 0.03

Effective crest length after pier and abutment contraction corrections L_eff (m)

approach_velocity_head_mtol 0.05

Approach velocity head correction Va²/(2g) (m)

total_energy_head_mtol 0.03

Total energy head over crest He = H + Va²/(2g) (m)

discharge_m3_stol 0.03

Total spillway discharge capacity Q (m³/s)

unit_discharge_m3_s_per_mtol 0.03

Unit discharge per metre of effective crest q (m³/s/m)

visibility contract

Difficulty Ladder

all_giveneasy

Simple ogee spillway, no piers, all parameters given

all fields visible
all_givenmedium

All parameters given, includes pier and abutment corrections across both types

all fields visible
partialhard

Discharge coefficient, pier shape, and abutment shape hidden; agent infers from site context

discharge_coefficientpier_shapeabutment_shape

scenario bands

Archetype Atlas

small_ogee_dam

2 contexts

Small ogee spillway dam with low head and no piers

crest_length_m5 to 20
design_head_m0.5 to 1.5
discharge_coefficient2.1 to 2.18
number_of_piers0

tasmania-small-hydro / victoria-farm-dam

medium_ogee_gated

2 contexts

Medium ogee spillway with gated bays and piers

crest_length_m20 to 60
design_head_m1.5 to 4
discharge_coefficient2.12 to 2.2
number_of_piers1 to 4

nsw-water-supply-dam / queensland-irrigation-dam

large_ogee_flood

2 contexts

Large ogee flood spillway with multiple pier bays

crest_length_m50 to 120
design_head_m3 to 8
discharge_coefficient2.15 to 2.22
number_of_piers2 to 8

snowy-mountains-flood-dam / north-queensland-major-dam

broad_crested_weir

2 contexts

Broad-crested weir spillway on low-head dam or diversion structure

crest_length_m5 to 40
design_head_m0.3 to 2.5
discharge_coefficient1.5 to 1.75
number_of_piers0 to 2

south-australia-diversion-weir / western-australia-creek-crossing

broad_crested_large

2 contexts

Large broad-crested spillway with piers for multi-bay structure

crest_length_m30 to 80
design_head_m1 to 3.5
discharge_coefficient1.55 to 1.8
number_of_piers1 to 5

northern-territory-barrage / canberra-lake-overflow

rendered task

Generation Preview

snowy-mountains-flood-dam-large-ogee-flood-preview

difficulty
hard
visibility
partial
archetype
large_ogee_flood
site context
snowy-mountains-flood-dam
instruction excerptspillway-weir-capacity_calc.py

visible fields

  • crest_length_m50 to 120 m
  • design_head_m3 to 8 m
  • number_of_piers2 to 8
  • approach_channel_width_m60 to 200 m
  • approach_depth_m5 to 15 m

withheld schema

discharge_coefficientpier_shapeabutment_shapeeffective_crest_length_mapproach_velocity_head_mtotal_energy_head_mdischarge_m3_sunit_discharge_m3_s_per_m
Large ogee flood spillway with multiple pier bays. snowy-mountains-flood-dam. Required outputs: effective_crest_length_m, approach_velocity_head_m, total_energy_head_m, discharge_m3_s, unit_discharge_m3_s_per_m