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

Hazen Williams Headloss

Calculates friction head loss in pressurised water mains using the Hazen-Williams empirical formula hf = 10.67 * L * Q^1.852 / (C^1.852 * D^4.87), along with the hydraulic gradient and flow velocity. The C-factor encodes pipe material and condition. Widely used in municipal water distribution design per AWWA and AS/NZS 3500 for sizing pipes and evaluating network pressure losses.

inputs

4 fields

context

4 archetypes

engine

with-tool

outputs

3 scored fields

contract fields

Parameter Map

4 inputs to 3 scored outputs

  • flow_rate_l_s

    float

    Volumetric flow rate Q

    0.5 to 500L/s

  • pipe_diameter_mm

    float

    Internal pipe diameter D

    50 to 2000mm

  • pipe_length_m

    float

    Pipe length L

    10 to 5000m

  • c_factor

    floatfrom archetypehidden in hard

    Hazen-Williams roughness coefficient C

    60 to 150
head_loss_mtol 0.03

Friction head loss hf (m)

hydraulic_gradienttol 0.05

Hydraulic gradient S = hf / L (dimensionless)

flow_velocity_m_stol 0.03

Mean flow velocity V (m/s)

visibility contract

Difficulty Ladder

all_giveneasy

All parameters given, smooth new pipe, moderate flow

all fields visible
all_givenmedium

All parameters given, any pipe material and flow regime

all fields visible
partialhard

C-factor hidden, agent must infer from pipe material description

c_factor

scenario bands

Archetype Atlas

new_pvc

2 contexts

New PVC or HDPE pipeline

c_factor140 to 150

sydney-greenfield / brisbane-suburban

new_ductile_iron

2 contexts

New cement-lined ductile iron pipeline

c_factor130 to 140

melbourne-trunk-main / adelaide-distribution

aged_cast_iron

2 contexts

Aged unlined cast iron pipeline with moderate tuberculation

c_factor80 to 100

sydney-inner-west-legacy / melbourne-inner-legacy

corroded_steel

2 contexts

Corroded steel water main

c_factor60 to 80

darwin-industrial-reticulation / cairns-coastal-reticulation

rendered task

Generation Preview

sydney-greenfield-new-pvc-preview

difficulty
hard
visibility
partial
archetype
new_pvc
site context
sydney-greenfield
instruction excerpthazen-williams-headloss_calc.py

visible fields

  • flow_rate_l_s0.5 to 500 L/s
  • pipe_diameter_mm50 to 2000 mm
  • pipe_length_m10 to 5000 m

withheld schema

c_factorhead_loss_mhydraulic_gradientflow_velocity_m_s
New PVC or HDPE pipeline. sydney-greenfield. Required outputs: head_loss_m, hydraulic_gradient, flow_velocity_m_s