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

Minor Losses Calculation

Calculates total minor head loss through fittings from explicit K factors and quantities. The template reports summed K factor, velocity head, total minor loss, and equivalent straight-pipe length using an explicit Darcy friction factor.

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

Standards

AWWA M11Crane TP-410

Tags

deterministicfittingsmechanicalminor-lossespipe-hydraulics

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

9 inputs

Always given

Included directly in every task prompt.

9
Show 9 inputs

  • Fitting 1 k

    fitting_1_k

    K factor for the first fitting group

    0 – 20

  • Fitting 1 quantity

    fitting_1_quantity

    Quantity of first fitting group

    0 – 30

  • Fitting 2 k

    fitting_2_k

    K factor for the second fitting group

    0 – 20

  • Fitting 2 quantity

    fitting_2_quantity

    Quantity of second fitting group

    0 – 30

  • Fitting 3 k

    fitting_3_k

    K factor for the third fitting group

    0 – 20

  • Fitting 3 quantity

    fitting_3_quantity

    Quantity of third fitting group

    0 – 30

  • Flow velocity

    flow_velocity_m_s

    Mean pipe flow velocity

    0.1 – 8 m/s

  • Pipe diameter

    pipe_diameter_mm

    Pipe internal diameter

    10 – 3000 mm

  • Darcy friction factor

    darcy_friction_factor

    Darcy friction factor used for equivalent length

    0.005 – 0.08

Scored outputs

4 outputs

Total k

total_k

Summed fitting K factor

Scores if within ±3% of the reference value.

Velocity head

velocity_head_m

Velocity head

Scores if within ±3% of the reference value.

Total minor loss

total_minor_loss_m

Total minor head loss

Scores if within ±3% of the reference value.

Equivalent length

equivalent_length_m

Equivalent straight pipe length

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 pump station pipework
medium:
All parameters given across pump station and process pipework
hard:
All parameters given for process pipework

Task bundle

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

/workspace

  • instruction.md
  • minor-losses-calculation_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 mechanical engineer specializing in pipe hydraulics.2 3## Problem4 5Calculate total minor head loss for a pipe run using explicit fitting K factors.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Fitting 1 K factor | {{ fitting_1_k }} | - |12| Fitting 1 quantity | {{ fitting_1_quantity }} | - |13| Fitting 2 K factor | {{ fitting_2_k }} | - |14| Fitting 2 quantity | {{ fitting_2_quantity }} | - |15| Fitting 3 K factor | {{ fitting_3_k }} | - |16| Fitting 3 quantity | {{ fitting_3_quantity }} | - |17| Flow velocity | {{ flow_velocity_m_s }} | m/s |18| Pipe diameter | {{ pipe_diameter_mm }} | mm |19| Darcy friction factor | {{ darcy_friction_factor }} | - |20 21{% if archetype_description is defined %}22### Pipework Context23 24{{ archetype_description }}25{% endif %}26 27{% if tool_available %}28## Available Tool29 30A minor losses calculation tool is available at `/workspace/{{ meta.name }}_calc.py`. Run it with:31 32```bash33python3 /workspace/{{ meta.name }}_calc.py --help34```35 36You may use this tool to verify your calculations or compute values directly.37{% endif %}38 39## Required40 41Calculate the following:42 431. Total K factor442. Velocity head in metres453. Total minor head loss in metres464. Equivalent pipe length in metres using the supplied Darcy friction factor47 48## Constraints49 50- No internet access is available. Work from engineering knowledge and the provided tool.51- Use total K = sum of each fitting K factor multiplied by its quantity.52- Use velocity head = velocity squared / (2g), with g = 9.81 m/s2.53- Use total minor loss = total K x velocity head.54- Use equivalent length = total minor loss x pipe diameter / (Darcy friction factor x velocity head).55 56## Output Format57 58Show 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:59 60```json61{62 "total_k": <numeric_value>,63 "velocity_head_m": <numeric_value>,64 "total_minor_loss_m": <numeric_value>,65 "equivalent_length_m": <numeric_value>66}67```68 69Write your complete solution to `/workspace/output.md`.70 71

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.

Pump station header

pump_station_header

Pump station header with valves and bends

water-pump-stationwastewater-pump-station
Parameter ranges
fitting_1_k
0.2 – 1.5
fitting_1_quantity
2 – 12
fitting_2_k
0.5 – 5
fitting_2_quantity
1 – 8
fitting_3_k
0 – 3
fitting_3_quantity
0 – 8
flow_velocity_m_s
0.8 – 3
pipe_diameter_mm
100 – 1200
darcy_friction_factor
0.012 – 0.04

Process pipework

process_pipework

Industrial process pipework fitting loss check

industrial-process-plantchemical-dosing-skid
Parameter ranges
fitting_1_k
0.1 – 3
fitting_1_quantity
1 – 20
fitting_2_k
0.2 – 8
fitting_2_quantity
1 – 15
fitting_3_k
0 – 10
fitting_3_quantity
0 – 10
flow_velocity_m_s
1 – 5
pipe_diameter_mm
25 – 500
darcy_friction_factor
0.01 – 0.05

Example task

industrial-process-plant-process-pipework-preview — hard difficulty, all inputs given.

Industrial process pipework fitting loss check. industrial-process-plant. Required outputs: total_k, velocity_head_m, total_minor_loss_m, equivalent_length_m

The model sees

Scenario context and visible inputs.

fitting_1_k
0.1 to 3 -
fitting_1_quantity
1 to 20 -
fitting_2_k
0.2 to 8 -
fitting_2_quantity
1 to 15 -
fitting_3_k
0 to 10 -
fitting_3_quantity
0 to 10 -
flow_velocity_m_s
1 to 5 m/s
pipe_diameter_mm
25 to 500 mm
darcy_friction_factor
0.01 to 0.05 -

Executable tool: minor-losses-calculation_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.

{
  "total_k": <number>,
  "velocity_head_m": <number>,
  "total_minor_loss_m": <number>,
  "equivalent_length_m": <number>
}
  • total_k · scored within ±3%
  • velocity_head_m · scored within ±3%
  • total_minor_loss_m · scored within ±3%
  • equivalent_length_m · scored within ±3%