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

Voltage Regulation

Calculates voltage drop, voltage regulation, receiving-end voltage, and real power loss for a balanced three-phase line. The reduced method uses per-kilometre R and X, line length, real and reactive load, and sending-end voltage.

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

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

6 inputs

Always given

Included directly in every task prompt.

5
  • Line resistance ohm per km

    line_resistance_ohm_per_km

    Positive-sequence line resistance

    0 – 5 ohm/km
  • Line reactance ohm per km

    line_reactance_ohm_per_km

    Positive-sequence line reactance

    0 – 5 ohm/km
  • Line length

    line_length_km

    Line length

    0.1 – 500 km
  • Load real power

    load_real_power_mw

    Three-phase real load

    0.1 – 1000 MW
  • Sending voltage

    sending_voltage_kv

    Sending-end line-to-line voltage

    1 – 765 kV

Hidden at higher difficulty

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

1
  • Load reactive power

    load_reactive_power_mvar

    Three-phase reactive load

    Hidden at hard difficulty.

    -500 – 500 MVAr

Scored outputs

4 outputs

Voltage drop kv

voltage_drop_kv

Approximate line voltage drop

Scores if within ±3% of the reference value.

Voltage regulation pct

voltage_regulation_pct

Voltage drop as a percentage of sending voltage

Scores if within ±3% of the reference value.

Receiving end voltage kv

receiving_end_voltage_kv

Receiving-end line-to-line voltage

Scores if within ±3% of the reference value.

Power loss mw

power_loss_mw

Three-phase real power loss

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

Subtransmission line with all values visible

medium

All inputs given

Subtransmission or transmission line

hard

Some inputs hidden

Reactive load hidden in power factor context

Hidden inputs

  • Load reactive power mvarload_reactive_power_mvar

Prompt replacement text

Use the lagging reactive load implied by {{ archetype.description }}.

Load reactive power mvar restricted to: 100

Task bundle

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

/workspace

  • instruction.md
  • voltage-regulation_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 power systems engineer calculating line voltage regulation.2 3## Given4 5| Parameter | Value | Unit |6|-----------|-------|------|7| Line resistance | {{ line_resistance_ohm_per_km }} | ohm/km |8| Line reactance | {{ line_reactance_ohm_per_km }} | ohm/km |9| Line length | {{ line_length_km }} | km |10| Real load | {{ load_real_power_mw }} | MW |11{% if load_reactive_power_mvar is defined %}12| Reactive load | {{ load_reactive_power_mvar }} | MVAr |13{% endif %}14| Sending-end voltage | {{ sending_voltage_kv }} | kV |15 16## Constraints17 18- Use total R and X over the full line length.19- Use the approximate drop formula `deltaV_kV = (R_total P_MW + X_total Q_MVAr) / V_kV`.20- Voltage regulation equals `deltaV / sending_voltage x 100`.21- Receiving voltage equals sending voltage minus voltage drop.22- Estimate three-phase real power loss using line current from apparent power.23 24## Output Format25 26Include a JSON block with exactly these keys:27 28```json29{30 "voltage_drop_kv": <numeric_value>,31 "voltage_regulation_pct": <numeric_value>,32 "receiving_end_voltage_kv": <numeric_value>,33 "power_loss_mw": <numeric_value>34}35```36 37Write your complete solution to `/workspace/output.md`.38

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.

Subtransmission line

subtransmission_line

Subtransmission feeder supplying a regional load

regional-feedersubtransmission-line
Parameter ranges
line_resistance_ohm_per_km
0.05 – 0.4
line_reactance_ohm_per_km
0.1 – 0.6
line_length_km
5 – 100
load_real_power_mw
5 – 100
load_reactive_power_mvar
0 – 40
sending_voltage_kv
33 – 132

Transmission line

transmission_line

Transmission line supplying a bulk load

bulk-transmissioninterconnector
Parameter ranges
line_resistance_ohm_per_km
0.01 – 0.15
line_reactance_ohm_per_km
0.1 – 0.5
line_length_km
50 – 300
load_real_power_mw
50 – 600
load_reactive_power_mvar
0 – 250
sending_voltage_kv
132 – 500

Example task

bulk-transmission-transmission-line-previewhard difficulty, some inputs hidden.

Transmission line supplying a bulk load. bulk-transmission. Required outputs: voltage_drop_kv, voltage_regulation_pct, receiving_end_voltage_kv, power_loss_mw

The model sees

Scenario context and visible inputs.

line_resistance_ohm_per_km
0.01 to 0.15 ohm/km
line_reactance_ohm_per_km
0.1 to 0.5 ohm/km
line_length_km
50 to 300 km
load_real_power_mw
50 to 600 MW
sending_voltage_kv
132 to 500 kV

Executable tool: voltage-regulation_calc.py

The model must infer

Inputs withheld at this difficulty.

  • Load reactive power mvar

    load_reactive_power_mvar

Stand-in text in the prompt

Use the lagging reactive load implied by {{ archetype.description }}.

The model must produce

The scored JSON answer schema.

{
  "voltage_drop_kv": <number>,
  "voltage_regulation_pct": <number>,
  "receiving_end_voltage_kv": <number>,
  "power_loss_mw": <number>
}
  • voltage_drop_kv · scored within ±3%
  • voltage_regulation_pct · scored within ±3%
  • receiving_end_voltage_kv · scored within ±3%
  • power_loss_mw · scored within ±3%