LIVEdataset releasetasks 552models 18last submission … · built …
task library
built templatestormwater-pipedwith-tool

Hgl Check

Computes the hydraulic grade line (HGL) at the upstream pit of a single stormwater pipe reach using Manning's equation for friction loss and a pit loss coefficient for junction losses. Checks whether the HGL remains below the pit surface level with adequate clearance to prevent surcharging, following ARR 2019 and local council DCP methods.

inputs

8 fields

context

4 archetypes

engine

with-tool

outputs

7 scored fields

contract fields

Parameter Map

8 inputs to 7 scored outputs

  • design_flow_m3_per_s

    float

    Design peak flow Q at the pipe reach

    0.01 to 4m³/s

  • pipe_diameter_mm

    enum

    Nominal internal pipe diameter DN

    225300375450525600750900+2

  • pipe_length_m

    float

    Pipe reach length L between pits

    10 to 150m

  • mannings_n

    floatfrom archetypehidden in hard

    Manning's roughness coefficient n for the pipe material

    0.009 to 0.025

  • pit_loss_coefficient

    floatfrom archetypehidden in hard

    Pit/junction loss coefficient K (dimensionless)

    0 to 5

  • tailwater_level_m

    float

    HGL at the downstream pit (tailwater condition)

    2 to 30m AHD

  • surface_level_m

    float

    Surface level at the upstream pit

    4 to 35m AHD

  • minimum_clearance_mm

    floatoptional

    Minimum required clearance between HGL and surface level

    50 to 500mm
flow_velocity_m_per_stol 0.03

Pipe flow velocity V (m/s)

friction_loss_mtol 0.03

Friction head loss h_f through the pipe (m)

pit_loss_mtol 0.03

Pit/junction head loss h_pit (m)

hgl_upstream_mtol 0.03

HGL elevation at the upstream pit (m AHD)

clearance_mmtol 10

Clearance between surface level and HGL (mm), positive = below surface

surcharge_ratiotol 0.03

HGL to surface level ratio (> 1.0 indicates surcharging)

pass_failtol 0.01

Surcharge compliance (1.0 = pass, clearance adequate; 0.0 = fail)

visibility contract

Difficulty Ladder

all_giveneasy

Small pipe, straight pit, all parameters given including Manning's n and pit loss K

all fields visible
all_givenmedium

Any pipe size and pit configuration, all parameters given

all fields visible
partialhard

Manning's n and pit loss K hidden, agent must infer from pipe material and junction description

mannings_npit_loss_coefficient

scenario bands

Archetype Atlas

concrete_pipe_straight

2 contexts

Reinforced concrete pipe through a straight-through pit with benched invert

mannings_n0.011 to 0.015
pit_loss_coefficient0.1 to 0.5
pipe_diameter_mm300, 375, 450, 525, 600, 750
design_flow_m3_per_s0.03 to 0.21

brisbane-suburban-drainage / sydney-greenfield-subdivision

concrete_pipe_bend

2 contexts

Reinforced concrete pipe through a pit with a change in direction

mannings_n0.011 to 0.015
pit_loss_coefficient0.5 to 2.5
pipe_diameter_mm375, 450, 600, 750, 900
design_flow_m3_per_s0.05 to 0.33

melbourne-trunk-stormwater / adelaide-urban-renewal

pvc_pipe_residential

2 contexts

PVC pipe in a residential inter-allotment drainage pit

mannings_n0.009 to 0.011
pit_loss_coefficient0.1 to 0.5
pipe_diameter_mm225, 300, 375
design_flow_m3_per_s0.01 to 0.12

perth-residential-estate / gold-coast-infill-development

large_trunk_main

2 contexts

Large reinforced concrete trunk main through a junction pit with multiple inlets

mannings_n0.012 to 0.015
pit_loss_coefficient1 to 5
pipe_diameter_mm750, 900, 1050, 1200
design_flow_m3_per_s0.2 to 1.3

sydney-trunk-stormwater / brisbane-creek-diversion

rendered task

Generation Preview

brisbane-suburban-drainage-concrete-pipe-straight-preview

difficulty
hard
visibility
partial
archetype
concrete_pipe_straight
site context
brisbane-suburban-drainage
instruction excerpthgl-check_calc.py

visible fields

  • design_flow_m3_per_s0.03 to 0.21 m³/s
  • pipe_diameter_mm300 mm
  • pipe_length_m20 to 80 m
  • tailwater_level_m8 to 14 m AHD
  • surface_level_m16 to 20 m AHD
  • minimum_clearance_mm100 to 300 mm

withheld schema

mannings_npit_loss_coefficientflow_velocity_m_per_sfriction_loss_mpit_loss_mhgl_upstream_mclearance_mmsurcharge_ratiopass_fail
Reinforced concrete pipe through a straight-through pit with benched invert. brisbane-suburban-drainage. Required outputs: flow_velocity_m_per_s, friction_loss_m, pit_loss_m, hgl_upstream_m, clearance_mm, surcharge_ratio