LIVEdataset releasetasks 552models 18last submission · built
task library
built templatearmor-stabilitywith-tool

Hudson Armor Sizing

Determines the required median armor stone weight and nominal diameter for breakwater and revetment stability using Hudson's (1959) formula from the USACE Coastal Engineering Manual and CIRIA C683 Rock Manual. Accounts for design wave height, rock and water densities, structure slope, and the stability coefficient KD which depends on armor type and placement method.

inputs

5 fields

context

5 archetypes

engine

with-tool

outputs

3 scored fields

contract fields

Parameter Map

5 inputs to 3 scored outputs

  • design_wave_height_m

    float

    Design wave height H

    0.5 to 8m
  • rock_density_kg_m3

    floatfrom archetypehidden in hard

    Armor rock density rho_r

    2200 to 3000kg/m³
  • water_density_kg_m3

    floatfrom archetypehidden in hard

    Water density rho_w

    1000 to 1035kg/m³
  • slope_angle_deg

    float

    Structure slope angle alpha from horizontal

    18 to 45degrees
  • stability_coefficient_kd

    floatfrom archetypehidden in hard

    Hudson stability coefficient KD

    1 to 16-
specific_gravity_srtol 0.03

Specific gravity of rock Sr = rho_r / rho_w

armor_weight_tonnestol 0.05

Median armor unit weight W (tonnes)

nominal_diameter_mtol 0.05

Nominal armor diameter Dn50 (m)

visibility contract

Difficulty Ladder

all_giveneasy

Moderate wave height, all parameters given — straightforward Hudson formula

all fields visible
all_givenmedium

Larger wave height, steeper slopes — same formula, bigger numbers

all fields visible
partialhard

Rock density, water density, and KD hidden — agent must infer from site description

rock_density_kg_m3water_density_kg_m3stability_coefficient_kd

scenario bands

Archetype Atlas

rough_quarrystone_random

3 contexts

Rough angular quarrystone placed randomly on trunk section

rock_density_kg_m32500 to 2700
water_density_kg_m31020 to 1030
stability_coefficient_kd3 to 4

queensland-outer-reef / nsw-coastal-headland / wa-exposed-coast

rough_quarrystone_special

2 contexts

Rough angular quarrystone with special placement on trunk

rock_density_kg_m32500 to 2700
water_density_kg_m31020 to 1030
stability_coefficient_kd5 to 6.5

sydney-harbour-breakwater / melbourne-port-revetment

basalt_armor_random

2 contexts

Dense basalt armor stone placed randomly

rock_density_kg_m32800 to 3000
water_density_kg_m31020 to 1030
stability_coefficient_kd3.5 to 4.5

victoria-basalt-coast / north-qld-volcanic

freshwater_quarrystone

3 contexts

Quarrystone armor for freshwater dam or lake revetment

rock_density_kg_m32500 to 2700
water_density_kg_m31000 to 1005
stability_coefficient_kd3 to 4

murray-river-weir / snowy-hydro-dam / wivenhoe-dam

concrete_unit_random

2 contexts

Concrete armor units (cubes) placed randomly

rock_density_kg_m32300 to 2400
water_density_kg_m31020 to 1030
stability_coefficient_kd6 to 7.5

darwin-harbour-breakwater / townsville-port-expansion

rendered task

Generation Preview

queensland-outer-reef-rough-quarrystone-random-preview

difficulty
hard
visibility
partial
archetype
rough_quarrystone_random
site context
queensland-outer-reef
instruction excerpthudson-armor-sizing_calc.py

visible fields

  • design_wave_height_m0.5 to 8 m
  • slope_angle_deg18 to 45 degrees

withheld schema

water_density_kg_m3stability_coefficient_kdrock_density_kg_m3specific_gravity_srarmor_weight_tonnesnominal_diameter_m
Rough angular quarrystone placed randomly on trunk section. queensland-outer-reef. Required outputs: specific_gravity_sr, armor_weight_tonnes, nominal_diameter_m