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

Oxygen Requirements

Calculates activated sludge oxygen demand from BOD removal, nitrogen oxidation, sludge production, and denitrification credit. The template uses explicit stoichiometric factors for carbonaceous demand adjustment, nitrification oxygen demand, and denitrification oxygen recovery.

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

Standards

WEF MOP 8

Tags

activated-sludgedeterministicmechanicaloxygen-demandwastewater

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

  • Flow rate

    flow_rate_m3_d

    Process flow rate

    10 – 1000000 m3/d

  • Influent bod

    influent_bod_mg_l

    Influent BOD concentration

    10 – 1000 mg/L

  • Effluent bod

    effluent_bod_mg_l

    Effluent BOD concentration

    0 – 100 mg/L

  • Influent tkn

    influent_tkn_mg_l

    Influent TKN concentration

    1 – 150 mg/L

  • Effluent tkn

    effluent_tkn_mg_l

    Effluent TKN concentration

    0 – 50 mg/L

  • Sludge production

    sludge_production_kg_d

    Biomass sludge production

    0 – 100000 kg/d

  • Denitrified nitrogen

    denitrified_nitrogen_mg_l

    Nitrate-nitrogen denitrified for oxygen credit

    0 – 100 mg/L

Scored outputs

5 outputs

Bod removed kg d

bod_removed_kg_d

BOD removed

Scores if within ±3% of the reference value.

Carbonaceous oxygen kg d

carbonaceous_oxygen_kg_d

Carbonaceous oxygen demand after sludge credit

Scores if within ±3% of the reference value.

Nitrogenous oxygen kg d

nitrogenous_oxygen_kg_d

Nitrogenous oxygen demand

Scores if within ±3% of the reference value.

Denitrification credit kg d

denitrification_credit_kg_d

Denitrification oxygen credit

Scores if within ±3% of the reference value.

Total oxygen kg d

total_oxygen_kg_d

Total oxygen demand

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 package activated sludge plant
medium:
All parameters given across package and municipal plants
hard:
All parameters given for nutrient removal oxygen demand

Task bundle

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

/workspace

  • instruction.md
  • oxygen-requirements_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 wastewater treatment process design.2 3## Problem4 5Calculate activated sludge oxygen demand for carbonaceous oxidation, nitrogen oxidation, and denitrification credit.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| Flow rate | {{ flow_rate_m3_d }} | m3/d |12| Influent BOD | {{ influent_bod_mg_l }} | mg/L |13| Effluent BOD | {{ effluent_bod_mg_l }} | mg/L |14| Influent TKN | {{ influent_tkn_mg_l }} | mg/L |15| Effluent TKN | {{ effluent_tkn_mg_l }} | mg/L |16| Sludge production | {{ sludge_production_kg_d }} | kg/d |17| Denitrified nitrogen | {{ denitrified_nitrogen_mg_l }} | mg/L |18 19{% if archetype_description is defined %}20### Process Context21 22{{ archetype_description }}23{% endif %}24 25{% if tool_available %}26## Available Tool27 28An oxygen demand 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. BOD removed (kg/d)422. Carbonaceous oxygen demand after sludge credit (kg/d)433. Nitrogenous oxygen demand (kg/d)444. Denitrification oxygen credit (kg/d)455. Total oxygen demand (kg/d)46 47## Constraints48 49- No internet access is available. Work from engineering knowledge and the provided tool.50- Use BOD removed = flow x (influent BOD - effluent BOD) / 1000.51- Use carbonaceous oxygen = BOD removed - 1.42 x sludge production, not less than zero.52- Use nitrogen removed = flow x (influent TKN - effluent TKN) / 1000.53- Use nitrogenous oxygen = 4.57 x nitrogen removed.54- Use denitrification credit = 2.86 x denitrified nitrogen load.55- Use total oxygen = carbonaceous + nitrogenous - denitrification credit, not less than zero.56 57## Output Format58 59Show 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:60 61```json62{63 "bod_removed_kg_d": <numeric_value>,64 "carbonaceous_oxygen_kg_d": <numeric_value>,65 "nitrogenous_oxygen_kg_d": <numeric_value>,66 "denitrification_credit_kg_d": <numeric_value>,67 "total_oxygen_kg_d": <numeric_value>68}69```70 71Write your complete solution to `/workspace/output.md`.72

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.

Package plant

package_plant

Package activated sludge plant

remote-community-wwtpindustrial-package-wwtp
Parameter ranges
flow_rate_m3_d
100 – 5000
influent_bod_mg_l
150 – 400
effluent_bod_mg_l
5 – 30
influent_tkn_mg_l
20 – 80
effluent_tkn_mg_l
2 – 25
sludge_production_kg_d
20 – 1500
denitrified_nitrogen_mg_l
0 – 30

Municipal nutrient removal

municipal_nutrient_removal

Municipal nutrient removal activated sludge plant

regional-wwtpurban-nutrient-removal-plant
Parameter ranges
flow_rate_m3_d
5000 – 500000
influent_bod_mg_l
150 – 350
effluent_bod_mg_l
2 – 20
influent_tkn_mg_l
25 – 90
effluent_tkn_mg_l
1 – 15
sludge_production_kg_d
1000 – 80000
denitrified_nitrogen_mg_l
5 – 60

Example task

regional-wwtp-municipal-nutrient-removal-preview — hard difficulty, all inputs given.

Municipal nutrient removal activated sludge plant. regional-wwtp. Required outputs: bod_removed_kg_d, carbonaceous_oxygen_kg_d, nitrogenous_oxygen_kg_d, denitrification_credit_kg_d, total_oxygen_kg_d

The model sees

Scenario context and visible inputs.

flow_rate_m3_d
5000 to 500000 m3/d
influent_bod_mg_l
150 to 350 mg/L
effluent_bod_mg_l
2 to 20 mg/L
influent_tkn_mg_l
25 to 90 mg/L
effluent_tkn_mg_l
1 to 15 mg/L
sludge_production_kg_d
1000 to 80000 kg/d
denitrified_nitrogen_mg_l
5 to 60 mg/L

Executable tool: oxygen-requirements_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.

{
  "bod_removed_kg_d": <number>,
  "carbonaceous_oxygen_kg_d": <number>,
  "nitrogenous_oxygen_kg_d": <number>,
  "denitrification_credit_kg_d": <number>,
  "total_oxygen_kg_d": <number>
}
  • bod_removed_kg_d · scored within ±3%
  • carbonaceous_oxygen_kg_d · scored within ±3%
  • nitrogenous_oxygen_kg_d · scored within ±3%
  • denitrification_credit_kg_d · scored within ±3%
  • total_oxygen_kg_d · scored within ±3%