LIVEdataset releasetasks 552models 18last submission · built
task library
built templatewave-overtoppingboth

Wave Runup

Calculates the 2% exceedance wave runup height Ru2% on sloped coastal structures using the EurOtop (2018) TAW formula, which evaluates both breaking and surging runup expressions and takes the governing (minimum) value. Accounts for structure slope, surface roughness, and berm geometry to determine freeboard requirements for dikes, seawalls, and breakwaters.

inputs

5 fields

context

4 archetypes

engine

both

outputs

3 scored fields

contract fields

Parameter Map

5 inputs to 3 scored outputs

  • wave_height_m

    float

    Significant spectral wave height H_m0

    0.3 to 6m
  • wave_period_s

    floatfrom archetypehidden in hard

    Spectral wave period T_m-1,0

    3 to 16s
  • structure_slope

    float

    Structure slope tan(alpha), e.g. 0.33 for 1:3 slope

    0.1 to 0.75-
  • roughness_factor

    floatfrom archetypehidden in hard

    Roughness reduction factor gamma_f (1.0 = smooth, lower = rougher)

    0.35 to 1-
  • berm_factor

    floatfrom archetypehidden in hard

    Berm reduction factor gamma_b (1.0 = no berm, lower = larger berm)

    0.6 to 1-
breaker_parametertol 0.05

Breaker parameter (Iribarren number) xi_m-1,0

runup_height_mtol 0.05

2% exceedance wave runup height Ru2% (m)

regimetol 0.01

Wave regime: 1.0 = breaking/plunging, 2.0 = surging/non-breaking

visibility contract

Difficulty Ladder

all_giveneasy

Moderate waves on smooth structure — all parameters given, straightforward calculation

all fields visible
all_givenmedium

Larger waves on rough structures — all parameters given, more complex conditions

all fields visible
partialhard

Roughness and berm factors hidden — agent must infer from site description

roughness_factorberm_factorwave_period_s

scenario bands

Archetype Atlas

smooth_dike

3 contexts

Smooth concrete or asphalt dike with gentle seaward slope

roughness_factor0.95 to 1
berm_factor0.9 to 1
wave_period_s5 to 12

dutch-north-sea-dike / thames-estuary-embankment / brisbane-river-levee

rock_armour_revetment

3 contexts

Double-layer rock armour revetment on steep slope

roughness_factor0.5 to 0.6
berm_factor0.85 to 1
wave_period_s6 to 14

gold-coast-revetment / newcastle-foreshore-armour / darwin-seawall

concrete_seawall

3 contexts

Stepped or smooth concrete seawall with moderate roughness

roughness_factor0.85 to 0.95
berm_factor0.8 to 1
wave_period_s4 to 10

sydney-harbour-seawall / adelaide-glenelg-wall / cairns-esplanade-wall

rubble_mound_breakwater

3 contexts

Rubble mound breakwater with rough two-layer armor

roughness_factor0.38 to 0.45
berm_factor0.6 to 0.8
wave_period_s8 to 16

fremantle-outer-breakwater / townsville-port-breakwater / portland-harbour-arm

rendered task

Generation Preview

dutch-north-sea-dike-smooth-dike-preview

difficulty
hard
visibility
partial
archetype
smooth_dike
site context
dutch-north-sea-dike
instruction excerptwave-runup_calc.py

visible fields

  • wave_height_m0.3 to 6 m
  • structure_slope0.1 to 0.75 -

withheld schema

roughness_factorwave_period_sberm_factorbreaker_parameterrunup_height_mregime
Smooth concrete or asphalt dike with gentle seaward slope. dutch-north-sea-dike. Required outputs: breaker_parameter, runup_height_m, regime