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

Detention Outlet Hgl Package

Calculates source-bound stormwater detention and outlet-control metrics from a deterministic stormwater task-owned source pack. The template combines Rational Method peak flow, simplified triangular-hydrograph detention storage, basin storage volume, orifice release, emergency weir release, freeboard, downstream HGL clearance, and an overall synthetic pass score.

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

Standards

EPA SWMMFHWA HEC-22HEC-HMSstormwater detention outlet workflows

Tags

civildetentiondeterministichglorificeoutlet-controlstormwaterweir

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

22 inputs

Always given

Included directly in every task prompt.

22
Show 22 inputs

  • Catchment area

    catchment_area_ha

    CATCH-03-DET-01 total contributing catchment area

    6.4 ha

  • Runoff coefficient

    runoff_coefficient

    CATCH-03-DET-01 composite runoff coefficient

    0.72

  • Rainfall intensity

    rainfall_intensity_mm_h

    RAIN-03-IDF-10YR base rainfall intensity

    78 mm/h

  • Climate factor

    climate_factor

    RAIN-03-IDF-10YR source-owned climate factor applied to intensity

    1.1

  • Allowable release rate

    allowable_release_rate_m3_s

    Criteria target for controlled detention discharge

    0.42 m3/s

  • Storm duration hr

    storm_duration_hr

    RAIN-03-IDF-10YR storm duration used for the triangular hydrograph

    2 h

  • Storage bottom area

    storage_bottom_area_m2

    DET-03-BASIN-01 bottom area at active storage base

    640 m2

  • Storage top area

    storage_top_area_m2

    DET-03-BASIN-01 top area at active storage depth

    1040 m2

  • Active storage depth

    active_storage_depth_m

    DET-03-BASIN-01 active storage depth

    1.2 m

  • Orifice diameter

    orifice_diameter_mm

    OUT-03-ORIFICE-01 selected low-flow orifice diameter

    420 mm

  • Orifice discharge coefficient

    orifice_discharge_coefficient

    OUT-03-ORIFICE-01 discharge coefficient

    0.61

  • Orifice head

    orifice_head_m

    Head over OUT-03-ORIFICE-01 centreline at design water surface

    1.05 m

  • Major event peak flow

    major_event_peak_flow_m3_s

    REPORT-03-SWMMTRACE-01 major event peak flow for emergency weir check

    1.28 m3/s

  • Emergency weir length

    emergency_weir_length_m

    OUT-03-WEIR-01 clear crest length

    2.4 m

  • Emergency weir head

    emergency_weir_head_m

    Head over OUT-03-WEIR-01 during the major event check

    0.28 m

  • Weir discharge coefficient

    weir_discharge_coefficient

    OUT-03-WEIR-01 source-owned weir discharge coefficient

    0.62

  • Basin bottom elevation

    basin_bottom_elevation_m

    DET-03-BASIN-01 basin bottom elevation

    41.05 m

  • Embankment crest elevation

    embankment_crest_elevation_m

    DET-03-BASIN-01 embankment crest elevation

    42.55 m

  • Minimum freeboard

    minimum_freeboard_m

    Minimum required basin freeboard

    0.25 m

  • Downstream tailwater elevation

    downstream_tailwater_elevation_m

    HGL-03-OUTLET-01 downstream tailwater elevation

    41.2 m

  • Outlet loss

    outlet_loss_m

    HGL-03-OUTLET-01 outlet loss added to tailwater

    0.18 m

  • Downstream rim elevation

    downstream_rim_elevation_m

    HGL-03-OUTLET-01 downstream access/rim elevation for HGL clearance

    41.65 m

Scored outputs

17 outputs

Adjusted rainfall intensity mm h

adjusted_rainfall_intensity_mm_h

Rainfall intensity after source-owned climate factor

Scores if within ±3% of the reference value.

Post development peak flow

post_development_peak_flow_m3_s

Rational Method post-development peak flow

Scores if within ±3% of the reference value.

Required storage volume m3

required_storage_volume_m3

Required detention storage from the simplified triangular hydrograph

Scores if within ±3% of the reference value.

Available storage volume m3

available_storage_volume_m3

Available active basin storage volume from the source storage areas

Scores if within ±3% of the reference value.

Storage volume margin m3

storage_volume_margin_m3

Available storage minus required storage

Scores if within ±3% of the reference value.

Orifice area m2

orifice_area_m2

OUT-03-ORIFICE-01 selected orifice area

Scores if within ±3% of the reference value.

Controlled orifice release

controlled_orifice_release_m3_s

Controlled discharge through OUT-03-ORIFICE-01

Scores if within ±3% of the reference value.

Outlet release margin

outlet_release_margin_m3_s

Allowable release rate minus controlled orifice release

Scores if within ±3% of the reference value.

Emergency weir release

emergency_weir_release_m3_s

Emergency overflow capacity through OUT-03-WEIR-01

Scores if within ±3% of the reference value.

Major event excess flow

major_event_excess_flow_m3_s

Major event peak flow remaining after controlled orifice release

Scores if within ±3% of the reference value.

Emergency weir margin

emergency_weir_margin_m3_s

Emergency weir release minus major event excess flow

Scores if within ±3% of the reference value.

Design water surface elevation

design_water_surface_elevation_m

Design water surface elevation at active storage depth

Scores if within ±3% of the reference value.

Basin freeboard

basin_freeboard_m

Embankment crest elevation minus design water surface elevation

Scores if within ±3% of the reference value.

Freeboard margin

freeboard_margin_m

Basin freeboard minus minimum required freeboard

Scores if within ±3% of the reference value.

Downstream hgl

downstream_hgl_m

Downstream HGL elevation after tailwater and outlet loss

Scores if within ±3% of the reference value.

Hgl clearance

hgl_clearance_m

Downstream rim elevation minus downstream HGL

Scores if within ±3% of the reference value.

Overall pass score

overall_pass_score

Pass score for the task-owned storage, outlet, freeboard, and HGL checks

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 source-pack values given for the stormwater detention outlet HGL package
medium:
All source-pack values given for the stormwater detention outlet HGL package
hard:
All source-pack values given for the stormwater detention outlet HGL package

Task bundle

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

/workspace

  • instruction.md
  • detention-outlet-hgl-package_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 civil drainage engineer checking a task-owned synthetic stormwater detention, outlet-control, and HGL package for one stormwater design event.2 3Use only the task-owned synthetic source pack values shown below for numeric grading. External EPA SWMM, FHWA HEC-22, and HEC-HMS routes shape the workflow context only; they are not extra data sources for this instance.4 5## Scene6 7- Drainage case: `CASE-SSC03-DET-001`8- Catchment table: `CATCH-03-DET-01`9- Rainfall event: `RAIN-03-IDF-10YR`10- Detention basin: `DET-03-BASIN-01`11- Low-flow outlet: `OUT-03-ORIFICE-01`12- Emergency overflow: `OUT-03-WEIR-01`13- Downstream HGL check: `HGL-03-OUTLET-01`14- Report-output trace placeholder: `REPORT-03-SWMMTRACE-01`15- Drainage memo: `MEMO-03-DRAINAGE-01`16 17## Hydrology And Storage Basis18 19| Item | Value |20|------|-------|21| Catchment area | {{ catchment_area_ha }} ha |22| Runoff coefficient | {{ runoff_coefficient }} |23| Base rainfall intensity | {{ rainfall_intensity_mm_h }} mm/h |24| Climate factor | {{ climate_factor }} |25| Allowable release rate | {{ allowable_release_rate_m3_s }} m3/s |26| Storm duration | {{ storm_duration_hr }} h |27| DET-03-BASIN-01 bottom storage area | {{ storage_bottom_area_m2 }} m2 |28| DET-03-BASIN-01 top storage area | {{ storage_top_area_m2 }} m2 |29| Active storage depth | {{ active_storage_depth_m }} m |30 31Hydrology and storage checks:32 33- Adjusted rainfall intensity equals `rainfall_intensity_mm_h x climate_factor`.34- Rational Method post-development peak flow equals `runoff_coefficient x adjusted_rainfall_intensity_mm_h x catchment_area_ha / 360` in m3/s.35- Required storage uses the simplified triangular hydrograph method from the source pack.36- If `allowable_release_rate_m3_s < post_development_peak_flow_m3_s / 2`, required storage equals `storm_duration_hr x 3600 x (post_development_peak_flow_m3_s / 2 - allowable_release_rate_m3_s)`.37- If `allowable_release_rate_m3_s` is at least half the peak but less than the peak, required storage equals `(post_development_peak_flow_m3_s - allowable_release_rate_m3_s)^2 x storm_duration_hr x 3600 / (2 x post_development_peak_flow_m3_s)`.38- Available storage equals `(bottom_area + top_area) / 2 x active_storage_depth_m`.39- Storage volume margin equals available storage minus required storage.40 41## Outlet, Freeboard, And HGL Basis42 43| Item | Value |44|------|-------|45| OUT-03-ORIFICE-01 diameter | {{ orifice_diameter_mm }} mm |46| Orifice discharge coefficient | {{ orifice_discharge_coefficient }} |47| Orifice head | {{ orifice_head_m }} m |48| Major event peak flow | {{ major_event_peak_flow_m3_s }} m3/s |49| OUT-03-WEIR-01 length | {{ emergency_weir_length_m }} m |50| Emergency weir head | {{ emergency_weir_head_m }} m |51| Weir discharge coefficient | {{ weir_discharge_coefficient }} |52| Basin bottom elevation | {{ basin_bottom_elevation_m }} m |53| Embankment crest elevation | {{ embankment_crest_elevation_m }} m |54| Minimum freeboard | {{ minimum_freeboard_m }} m |55| Downstream tailwater elevation | {{ downstream_tailwater_elevation_m }} m |56| Outlet loss | {{ outlet_loss_m }} m |57| Downstream rim elevation | {{ downstream_rim_elevation_m }} m |58 59Outlet, freeboard, and HGL checks:60 61- Orifice area equals `pi x diameter_m^2 / 4`.62- Orifice velocity equals `sqrt(2 x 9.81 x orifice_head_m)`.63- Controlled orifice release equals `orifice_discharge_coefficient x orifice_area_m2 x orifice_velocity_m_s`.64- Outlet release margin equals allowable release rate minus controlled orifice release.65- Emergency weir coefficient equals `weir_discharge_coefficient x sqrt(2 x 9.81)`.66- Emergency weir release equals `weir_coefficient x emergency_weir_length_m x emergency_weir_head_m^1.5`.67- Major event excess flow equals major event peak flow minus controlled orifice release.68- Emergency weir margin equals emergency weir release minus major event excess flow.69- Design water surface elevation equals basin bottom elevation plus active storage depth.70- Basin freeboard equals embankment crest elevation minus design water surface elevation.71- Freeboard margin equals basin freeboard minus minimum freeboard.72- Downstream HGL equals downstream tailwater elevation plus outlet loss.73- HGL clearance equals downstream rim elevation minus downstream HGL.74- Overall pass score is `1.0` only when storage margin, outlet release margin, emergency weir margin, freeboard margin, and HGL clearance are all non-negative; otherwise it is `0.0`.75 76## Output Format77 78Write a compact memo to `/workspace/output.md`. Include a source-boundary statement that this is a task-owned synthetic source pack. Explain the calculations briefly, preserve the object IDs above, and state whether the baseline source pack passes the current docs-only checks.79 80Do not claim authority approval, accepted project evidence, software export validity, full standards compliance, executable real source-pack parsing, generated SWMM report-output evidence, generated benchmark readiness, or benchmark readiness.81 82Include a fenced JSON block with exactly these numeric keys:83 84```json85{86 "adjusted_rainfall_intensity_mm_h": <numeric_value>,87 "post_development_peak_flow_m3_s": <numeric_value>,88 "required_storage_volume_m3": <numeric_value>,89 "available_storage_volume_m3": <numeric_value>,90 "storage_volume_margin_m3": <numeric_value>,91 "orifice_area_m2": <numeric_value>,92 "controlled_orifice_release_m3_s": <numeric_value>,93 "outlet_release_margin_m3_s": <numeric_value>,94 "emergency_weir_release_m3_s": <numeric_value>,95 "major_event_excess_flow_m3_s": <numeric_value>,96 "emergency_weir_margin_m3_s": <numeric_value>,97 "design_water_surface_elevation_m": <numeric_value>,98 "basin_freeboard_m": <numeric_value>,99 "freeboard_margin_m": <numeric_value>,100 "downstream_hgl_m": <numeric_value>,101 "hgl_clearance_m": <numeric_value>,102 "overall_pass_score": <numeric_value>103}104```105

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.

Stormwater detention outlet case

stormwater_detention_outlet_case

Stormwater detention basin with controlled orifice, emergency weir, freeboard, and HGL clearance

detention-outlet-hglstormwater-storage-control-check
Parameter ranges
catchment_area_ha
6.4
runoff_coefficient
0.72
rainfall_intensity_mm_h
78
climate_factor
1.1
allowable_release_rate_m3_s
0.42
storm_duration_hr
2
storage_bottom_area_m2
640
storage_top_area_m2
1040
active_storage_depth_m
1.2
orifice_diameter_mm
420
orifice_discharge_coefficient
0.61
orifice_head_m
1.05
major_event_peak_flow_m3_s
1.28
emergency_weir_length_m
2.4
emergency_weir_head_m
0.28
weir_discharge_coefficient
0.62
basin_bottom_elevation_m
41.05
embankment_crest_elevation_m
42.55
minimum_freeboard_m
0.25
downstream_tailwater_elevation_m
41.2
outlet_loss_m
0.18
downstream_rim_elevation_m
41.65

Example task

detention-outlet-hgl-stormwater-detention-outlet-case-preview — hard difficulty, all inputs given.

Stormwater detention basin with controlled orifice, emergency weir, freeboard, and HGL clearance. detention-outlet-hgl. Required outputs: adjusted_rainfall_intensity_mm_h, post_development_peak_flow_m3_s, required_storage_volume_m3, available_storage_volume_m3, storage_volume_margin_m3, orifice_area_m2

The model sees

Scenario context and visible inputs.

catchment_area_ha
6.4 to 6.4 ha
runoff_coefficient
0.72 to 0.72
rainfall_intensity_mm_h
78 to 78 mm/h
climate_factor
1.1 to 1.1
allowable_release_rate_m3_s
0.42 to 0.42 m3/s
storm_duration_hr
2 to 2 h
storage_bottom_area_m2
640 to 640 m2
storage_top_area_m2
1040 to 1040 m2
active_storage_depth_m
1.2 to 1.2 m
orifice_diameter_mm
420 to 420 mm
orifice_discharge_coefficient
0.61 to 0.61
orifice_head_m
1.05 to 1.05 m
major_event_peak_flow_m3_s
1.28 to 1.28 m3/s
emergency_weir_length_m
2.4 to 2.4 m
emergency_weir_head_m
0.28 to 0.28 m
weir_discharge_coefficient
0.62 to 0.62
basin_bottom_elevation_m
41.05 to 41.05 m
embankment_crest_elevation_m
42.55 to 42.55 m
minimum_freeboard_m
0.25 to 0.25 m
downstream_tailwater_elevation_m
41.2 to 41.2 m
outlet_loss_m
0.18 to 0.18 m
downstream_rim_elevation_m
41.65 to 41.65 m

Executable tool: detention-outlet-hgl-package_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.

{
  "adjusted_rainfall_intensity_mm_h": <number>,
  "post_development_peak_flow_m3_s": <number>,
  "required_storage_volume_m3": <number>,
  "available_storage_volume_m3": <number>,
  "storage_volume_margin_m3": <number>,
  "orifice_area_m2": <number>,
  "controlled_orifice_release_m3_s": <number>,
  "outlet_release_margin_m3_s": <number>,
  "emergency_weir_release_m3_s": <number>,
  "major_event_excess_flow_m3_s": <number>,
  "emergency_weir_margin_m3_s": <number>,
  "design_water_surface_elevation_m": <number>,
  "basin_freeboard_m": <number>,
  "freeboard_margin_m": <number>,
  "downstream_hgl_m": <number>,
  "hgl_clearance_m": <number>,
  "overall_pass_score": <number>
}
  • adjusted_rainfall_intensity_mm_h · scored within ±3%
  • post_development_peak_flow_m3_s · scored within ±3%
  • required_storage_volume_m3 · scored within ±3%
  • available_storage_volume_m3 · scored within ±3%
  • storage_volume_margin_m3 · scored within ±3%
  • orifice_area_m2 · scored within ±3%
  • controlled_orifice_release_m3_s · scored within ±3%
  • outlet_release_margin_m3_s · scored within ±3%
  • emergency_weir_release_m3_s · scored within ±3%
  • major_event_excess_flow_m3_s · scored within ±3%
  • emergency_weir_margin_m3_s · scored within ±3%
  • design_water_surface_elevation_m · scored within ±3%
  • basin_freeboard_m · scored within ±3%
  • freeboard_margin_m · scored within ±3%
  • downstream_hgl_m · scored within ±3%
  • hgl_clearance_m · scored within ±3%
  • overall_pass_score · scored within ±3%