LIVEdataset releasetasks 552models 18last submission · built
task library
built templatecoastal-drainageboth

Freeboard Calculation

Determines the total freeboard and minimum crest or floor level for coastal and flood-prone structures by summing component allowances for wave overtopping, sea level rise, construction tolerance, and a consequence-based safety margin, per NZS 4404:2010 and MfE Guidance 2024. Used in coastal and floodplain development to set minimum building levels above the design water surface.

inputs

5 fields

context

4 archetypes

engine

both

outputs

2 scored fields

contract fields

Parameter Map

5 inputs to 2 scored outputs

  • design_water_level_m

    float

    Design still-water level including tidal and storm surge components (m above datum)

    0.5 to 8m
  • wave_allowance_m

    floatfrom archetypehidden in hard

    Wave overtopping allowance depending on wave height and structure type

    0.3 to 1m
  • slr_allowance_m

    floatfrom archetypehidden in hard

    Climate change sea level rise allowance for planning horizon

    0.1 to 1m
  • construction_tolerance_m

    floatfrom archetypehidden in hard

    Construction tolerance allowance

    0.05 to 0.15m
  • safety_margin_m

    floatfrom archetypehidden in hard

    Safety margin based on consequence category

    0.15 to 0.5m
total_freeboard_mtol 0.03

Total freeboard allowance (m)

minimum_crest_level_mtol 0.05

Minimum crest or floor level (m above datum)

visibility contract

Difficulty Ladder

all_giveneasy

Low consequence structure, all parameters given — straightforward addition

all fields visible
all_givenmedium

Higher consequence, larger allowances — all parameters given, same formula

all fields visible
partialhard

Wave allowance, SLR allowance, construction tolerance, and safety margin hidden — agent must infer from structure type and consequence category

wave_allowance_mslr_allowance_mconstruction_tolerance_msafety_margin_m

scenario bands

Archetype Atlas

residential_coastal

3 contexts

Residential coastal dwelling with low consequence category

wave_allowance_m0.3 to 0.5
slr_allowance_m0.3 to 0.6
construction_tolerance_m0.05 to 0.1
safety_margin_m0.15 to 0.25

gold-coast-beachfront-house / auckland-harbour-dwelling / christchurch-estuary-residence

commercial_waterfront

3 contexts

Commercial waterfront development with medium consequence category

wave_allowance_m0.4 to 0.7
slr_allowance_m0.4 to 0.8
construction_tolerance_m0.08 to 0.12
safety_margin_m0.25 to 0.35

sydney-darling-harbour-precinct / wellington-waterfront-retail / brisbane-river-commercial

critical_infrastructure

3 contexts

Critical infrastructure with high consequence category (hospital, power station)

wave_allowance_m0.6 to 1
slr_allowance_m0.6 to 1
construction_tolerance_m0.1 to 0.15
safety_margin_m0.35 to 0.5

tauranga-port-substation / darwin-hospital-coastal / townsville-water-treatment-plant

seawall_revetment

3 contexts

Seawall or revetment structure protecting coastal assets

wave_allowance_m0.5 to 0.8
slr_allowance_m0.4 to 0.9
construction_tolerance_m0.08 to 0.12
safety_margin_m0.2 to 0.4

napier-marine-parade-seawall / cairns-esplanade-revetment / perth-scarborough-seawall

rendered task

Generation Preview

gold-coast-beachfront-house-residential-coastal-preview

difficulty
hard
visibility
partial
archetype
residential_coastal
site context
gold-coast-beachfront-house
instruction excerptfreeboard-calculation_calc.py

visible fields

  • design_water_level_m0.5 to 8 m

withheld schema

slr_allowance_mwave_allowance_msafety_margin_mconstruction_tolerance_mtotal_freeboard_mminimum_crest_level_m
Residential coastal dwelling with low consequence category. gold-coast-beachfront-house. Required outputs: total_freeboard_m, minimum_crest_level_m