LIVEdataset aec-bench@releasetasks 552models 18last submission … · built …
civilwith-tool

Tidal Prism

Calculates the tidal prism exchanged by an estuary, lagoon, or basin using the reduced relation P = basin surface area x tidal range. It also estimates mean exchange flow and mean inlet velocity from the inlet flow area and exchange duration, giving a deterministic coastal hydraulics screening calculation.

with-tool: The model is given an executable Python calculator script.

Standards

USACE Coastal Engineering Manual

Tags

civilcoastaldeterministichydraulicsinlettidal-prism

How this task is generated

One template produces many comparable benchmark tasks while keeping the scoring contract fixed.

  1. 01

    Template

    The reusable contract shown on this page.

  2. 02

    Scenario

    An archetype and site context are sampled.

  3. 03

    Difficulty tier

    Inputs may be hidden at harder tiers.

  4. 04

    Task prompt

    The model responds with the declared outputs.

Parameters

Inputs the model receives, and the outputs it is scored on.

Inputs

5 inputs

Always given

Included directly in every task prompt.

4

  • Basin surface area

    basin_surface_area_m2

    Water surface area of the tidal basin

    10000 – 50000000 m2

  • Tidal range

    tidal_range_m

    Representative tidal range over the exchange cycle

    0.1 – 8 m

  • Inlet width

    inlet_width_m

    Hydraulic width of the inlet throat

    5 – 1000 m

  • Inlet average depth

    inlet_average_depth_m

    Average flow depth through the inlet throat

    0.5 – 30 m

Hidden at higher difficulty

Visible in easier tasks and withheld in one or more harder tiers.

1

  • Exchange duration

    exchange_duration_h

    Duration of the flood or ebb exchange

    Hidden at hard difficulty.

    1 – 12.5 h

Scored outputs

4 outputs

Tidal prism m3

tidal_prism_m3

Tidal prism volume exchanged over the tide

Scores if within ±3% of the reference value.

Inlet flow area m2

inlet_flow_area_m2

Approximate inlet flow area

Scores if within ±3% of the reference value.

Mean tidal flow

mean_tidal_flow_m3_s

Mean tidal exchange flow rate

Scores if within ±3% of the reference value.

Mean tidal velocity m s

mean_tidal_velocity_m_s

Mean velocity through the inlet throat

Scores if within ±3% of the reference value.

Difficulty

Each template is sampled at three tiers. Harder tiers may hide inputs, forcing the model to infer them from the scenario description.

easy

All inputs given

All tidal prism inputs given for a small basin

Exchange duration h restricted to: 6.2

medium

All inputs given

Mixed estuary sizes and exchange durations

hard

Some inputs hidden

Large basin context with exchange duration hidden

Hidden inputs

  • Exchange duration hexchange_duration_h

Prompt replacement text

Use a representative semi-diurnal flood or ebb exchange duration for {{ archetype.description }}.

Exchange duration h restricted to: 6.2

Task bundle

The exact instruction and parameter contract used to generate this task, pinned to the published library source.

/workspace

  • instruction.md
  • tidal-prism_calc.py

Teal lines show Jinja input conditions, not task visibility policy. A line renders only when that input or tool is visible.

1You are a senior coastal engineer estimating tidal exchange through an inlet.2 3## Problem4 5Calculate the tidal prism, inlet flow area, mean tidal flow rate, and mean inlet velocity for the basin.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Basin surface area | {{ basin_surface_area_m2 }} | m2 |12| Tidal range | {{ tidal_range_m }} | m |13| Inlet width | {{ inlet_width_m }} | m |14| Inlet average depth | {{ inlet_average_depth_m }} | m |15{% if exchange_duration_h is defined %}16| Exchange duration | {{ exchange_duration_h }} | h |17{% endif %}18{% if archetype_description is defined %}19 20### Site Context21 22{{ archetype_description }}23{% endif %}24 25{% if tool_available %}26## Available Tool27 28A tidal prism calculation tool is available at `/workspace/tidal-prism_calc.py`. Run it with:29 30```bash31python3 /workspace/tidal-prism_calc.py --help32```33{% endif %}34 35## Required36 37Calculate:38 391. Tidal prism volume in m3402. Inlet flow area in m2413. Mean tidal flow rate in m3/s424. Mean inlet velocity in m/s43 44## Constraints45 46- Use `tidal_prism = basin_surface_area x tidal_range`.47- Use `inlet_flow_area = inlet_width x inlet_average_depth`.48- Use `mean_tidal_flow = tidal_prism / exchange_duration_seconds`.49- Use `mean_tidal_velocity = mean_tidal_flow / inlet_flow_area`.50 51## Output Format52 53Show your working in Markdown. At the end, include a JSON block with exactly these keys:54 55```json56{57 "tidal_prism_m3": <numeric_value>,58 "inlet_flow_area_m2": <numeric_value>,59 "mean_tidal_flow_m3_s": <numeric_value>,60 "mean_tidal_velocity_m_s": <numeric_value>61}62```63 64Write your complete solution to `/workspace/output.md`.65

Scenario archetypes

Each generated task is drawn from one of these realistic scenario bands.

Site contexts ground each scenario in a real locale the model can use to infer hidden values.

Small lagoon

small_lagoon

Small lagoon entrance with modest tidal range

coastal-lagoontidal-creek
Parameter ranges
basin_surface_area_m2
10000 – 250000
tidal_range_m
0.3 – 1.5
inlet_width_m
5 – 40
inlet_average_depth_m
0.5 – 3

Estuary inlet

estuary_inlet

Medium estuary with a trained or natural inlet

east-coast-estuaryurban-river-mouth
Parameter ranges
basin_surface_area_m2
250000 – 5000000
tidal_range_m
0.8 – 3
inlet_width_m
30 – 250
inlet_average_depth_m
2 – 12

Large embayment

large_embayment

Large embayment or harbour with broad exchange area

harbour-entrancelarge-estuary
Parameter ranges
basin_surface_area_m2
5000000 – 50000000
tidal_range_m
1 – 8
inlet_width_m
150 – 1000
inlet_average_depth_m
6 – 30

Example task

east-coast-estuary-estuary-inlet-preview — hard difficulty, some inputs hidden.

Medium estuary with a trained or natural inlet. east-coast-estuary. Required outputs: tidal_prism_m3, inlet_flow_area_m2, mean_tidal_flow_m3_s, mean_tidal_velocity_m_s

The model sees

Scenario context and visible inputs.

basin_surface_area_m2
250000 to 5000000 m2
tidal_range_m
0.8 to 3 m
inlet_width_m
30 to 250 m
inlet_average_depth_m
2 to 12 m

Executable tool: tidal-prism_calc.py

The model must infer

Inputs withheld at this difficulty.

  • Exchange duration h

    exchange_duration_h

Stand-in text in the prompt

Use a representative semi-diurnal flood or ebb exchange duration for {{ archetype.description }}.

The model must produce

The scored JSON answer schema.

{
  "tidal_prism_m3": <number>,
  "inlet_flow_area_m2": <number>,
  "mean_tidal_flow_m3_s": <number>,
  "mean_tidal_velocity_m_s": <number>
}
  • tidal_prism_m3 · scored within ±3%
  • inlet_flow_area_m2 · scored within ±3%
  • mean_tidal_flow_m3_s · scored within ±3%
  • mean_tidal_velocity_m_s · scored within ±3%