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

Berthing Energy Calc

Calculates characteristic and design berthing energy for a vessel from displacement, approach velocity, hydrodynamic and berth coefficients, and an explicit safety factor. The template applies the kinetic energy relationship E = 0.5 M V^2 and multiplies by the provided marine design coefficients.

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

Standards

AS 4997BS 6349-4PIANC WG211

Tags

berthing-energydeterministicmarineportsstructural

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

7 inputs

Always given

Included directly in every task prompt.

7
Show 7 inputs

  • Vessel displacement

    vessel_displacement_t

    Vessel displacement mass

    100 – 250000 t

  • Approach velocity

    approach_velocity_m_s

    Vessel approach velocity normal to berth

    0.02 – 0.5 m/s

  • Added mass coefficient

    added_mass_coefficient

    Added mass coefficient CM

    1 – 2.2

  • Eccentricity coefficient

    eccentricity_coefficient

    Eccentricity coefficient CE

    0.3 – 1

  • Berth configuration coefficient

    berth_configuration_coefficient

    Berth configuration coefficient CC

    0.8 – 1.2

  • Softness coefficient

    softness_coefficient

    Berth and fender softness coefficient CS

    0.8 – 1.1

  • Safety factor

    safety_factor

    Design safety factor applied to characteristic energy

    1 – 2

Scored outputs

4 outputs

Kinetic energy knm

kinetic_energy_knm

Unmodified vessel kinetic energy

Scores if within ±3% of the reference value.

Characteristic energy knm

characteristic_energy_knm

Characteristic berthing energy after coefficient product

Scores if within ±3% of the reference value.

Design energy knm

design_energy_knm

Design berthing energy

Scores if within ±3% of the reference value.

Coefficient product

coefficient_product

Product of berthing energy coefficients

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.

All inputs remain visible at every tier

For this template, difficulty scales through parameter and scenario ranges rather than hidden information.

easy:
All parameters given for a small sheltered vessel
medium:
All parameters given across small and bulk vessels
hard:
All parameters given for larger industrial berth cases

Task bundle

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

/workspace

  • instruction.md
  • berthing-energy-calc_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 structural engineer specializing in marine berthing structures.2 3## Problem4 5Calculate vessel berthing energy using the kinetic energy method and the supplied berthing coefficients.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Vessel displacement | {{ vessel_displacement_t }} | t |12| Approach velocity | {{ approach_velocity_m_s }} | m/s |13| Added mass coefficient CM | {{ added_mass_coefficient }} | - |14| Eccentricity coefficient CE | {{ eccentricity_coefficient }} | - |15| Berth configuration coefficient CC | {{ berth_configuration_coefficient }} | - |16| Softness coefficient CS | {{ softness_coefficient }} | - |17| Safety factor | {{ safety_factor }} | - |18 19{% if archetype_description is defined %}20### Berthing Context21 22{{ archetype_description }}23{% endif %}24 25{% if tool_available %}26## Available Tool27 28A berthing energy calculation tool is available at `/workspace/{{ meta.name }}_calc.py`. Run it with:29 30```bash31python3 /workspace/{{ meta.name }}_calc.py --help32```33 34You may use this tool to verify your calculations or compute values directly.35{% endif %}36 37## Required38 39Calculate the following:40 411. Unmodified vessel kinetic energy (kNm)422. Characteristic berthing energy (kNm)433. Design berthing energy (kNm)444. Product of berthing coefficients45 46## Constraints47 48- No internet access is available. Work from engineering knowledge and the provided tool.49- Convert vessel displacement from tonnes to kg by multiplying by 1000.50- Use kinetic energy = 0.5 x mass x velocity^2 / 1000 to obtain kNm.51- Use characteristic energy = kinetic energy x CM x CE x CC x CS.52- Use design energy = characteristic energy x safety factor.53 54## Output Format55 56Show your step-by-step working in Markdown. At the end of your solution, include a JSON block with your final answers in exactly this format:57 58```json59{60 "kinetic_energy_knm": <numeric_value>,61 "characteristic_energy_knm": <numeric_value>,62 "design_energy_knm": <numeric_value>,63 "coefficient_product": <numeric_value>64}65```66 67Write your complete solution to `/workspace/output.md`.68

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 service vessel

small_service_vessel

Small service vessel berthing at a sheltered wharf

service-wharfferry-terminal
Parameter ranges
vessel_displacement_t
200 – 3000
approach_velocity_m_s
0.08 – 0.25
added_mass_coefficient
1.2 – 1.8
eccentricity_coefficient
0.6 – 1
berth_configuration_coefficient
0.9 – 1.1
softness_coefficient
0.9 – 1.05
safety_factor
1.1 – 1.5

Bulk carrier berth

bulk_carrier_berth

Bulk carrier berthing at an open industrial wharf

bulk-export-berthindustrial-port-wharf
Parameter ranges
vessel_displacement_t
30000 – 180000
approach_velocity_m_s
0.06 – 0.2
added_mass_coefficient
1.4 – 2
eccentricity_coefficient
0.4 – 0.8
berth_configuration_coefficient
0.9 – 1.2
softness_coefficient
0.85 – 1
safety_factor
1.2 – 1.8

Example task

bulk-export-berth-bulk-carrier-berth-preview — hard difficulty, all inputs given.

Bulk carrier berthing at an open industrial wharf. bulk-export-berth. Required outputs: kinetic_energy_knm, characteristic_energy_knm, design_energy_knm, coefficient_product

The model sees

Scenario context and visible inputs.

vessel_displacement_t
30000 to 180000 t
approach_velocity_m_s
0.06 to 0.2 m/s
added_mass_coefficient
1.4 to 2
eccentricity_coefficient
0.4 to 0.8
berth_configuration_coefficient
0.9 to 1.2
softness_coefficient
0.85 to 1
safety_factor
1.2 to 1.8

Executable tool: berthing-energy-calc_calc.py

The model must infer

Inputs withheld at this difficulty.

Nothing. All inputs are supplied.

The model must produce

The scored JSON answer schema.

{
  "kinetic_energy_knm": <number>,
  "characteristic_energy_knm": <number>,
  "design_energy_knm": <number>,
  "coefficient_product": <number>
}
  • kinetic_energy_knm · scored within ±3%
  • characteristic_energy_knm · scored within ±3%
  • design_energy_knm · scored within ±3%
  • coefficient_product · scored within ±3%