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

Voltage Drop Dc

Calculates two-way DC cable voltage drop for a solar PV string using current, one-way length, cable cross-section, resistivity, and string voltage. The template also estimates annual resistive energy loss and voltage-drop margin.

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

Standards

AS/NZS 3008.1AS/NZS 5033

Tags

cabledcdeterministicelectricalsolar-pvvoltage-drop

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.

6

  • String current

    string_current_a

    PV string current at maximum power

    1 – 30 A

  • Dc cable length

    dc_cable_length_m

    One-way DC cable length from string to inverter

    1 – 300 m

  • Cable cross section

    cable_cross_section_mm2

    Cable conductor cross-section

    1.5 – 240 mm2

  • String voltage

    string_voltage_v

    PV string operating voltage

    100 – 1500 V

  • Annual operating hours

    annual_operating_hours

    Equivalent annual operating hours at the modelled current

    500 – 3000 h/year

  • Maximum voltage drop pct

    maximum_voltage_drop_pct

    Maximum permitted voltage drop percentage

    0.5 – 5 %

Hidden at higher difficulty

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

1

  • Cable resistivity

    cable_resistivity_ohm_mm2_m

    Cable conductor resistivity

    Hidden at hard difficulty.

    0.015 – 0.03 ohm.mm2/m

Scored outputs

4 outputs

Voltage drop

voltage_drop_v

Two-way DC cable voltage drop

Scores if within ±3% of the reference value.

Voltage drop pct

voltage_drop_pct

Voltage drop as a percentage of string voltage

Scores if within ±3% of the reference value.

Annual energy loss kwh

annual_energy_loss_kwh

Annual resistive energy loss

Scores if within ±3% of the reference value.

Voltage drop margin pct

voltage_drop_margin_pct

Margin against the maximum voltage drop criterion

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

Rooftop PV string with all values visible

medium

All inputs given

PV string selected from rooftop or utility cases

hard

Some inputs hidden

Utility PV string with conductor resistivity embedded in context

Hidden inputs

  • Cable resistivity ohm mm2cable_resistivity_ohm_mm2_m

Prompt replacement text

Use the conductor resistivity implied by {{ archetype.description }}.

Cable resistivity ohm mm2 restricted to: 0.0175

Task bundle

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

/workspace

  • instruction.md
  • voltage-drop-dc_calc.py

Teal lines show Jinja input conditions, not task visibility policy. A line renders only when that input or tool is visible.

1# ABOUTME: Prompt template for DC solar string voltage-drop tasks.2# ABOUTME: Presents current, length, cable size, resistivity, voltage, and hours.3 4You are a senior solar PV electrical engineer checking DC string cable voltage drop.5 6## Given7 8| Parameter | Value | Unit |9|-----------|-------|------|10| String current at maximum power | {{ string_current_a }} | A |11| One-way DC cable length | {{ dc_cable_length_m }} | m |12| Cable cross-section | {{ cable_cross_section_mm2 }} | mm2 |13| Cable resistivity | {{ cable_resistivity_ohm_mm2_m }} | ohm.mm2/m |14| String voltage | {{ string_voltage_v }} | V |15| Annual operating hours | {{ annual_operating_hours }} | h/year |16| Maximum voltage drop | {{ maximum_voltage_drop_pct }} | % |17 18## Constraints19 20- Use a two-way DC loop resistance equal to `2 * length * resistivity / cross-section`.21- Voltage drop equals string current times loop resistance.22- Voltage drop percentage equals voltage drop divided by string voltage times 100.23- Annual energy loss equals current times voltage drop times annual operating hours divided by 1000.24- Voltage drop margin equals maximum voltage drop percentage minus calculated voltage drop percentage.25 26## Output Format27 28Include a JSON block with exactly these keys:29 30```json31{32 "voltage_drop_v": <numeric_value>,33 "voltage_drop_pct": <numeric_value>,34 "annual_energy_loss_kwh": <numeric_value>,35 "voltage_drop_margin_pct": <numeric_value>36}37```38 39Write your complete solution to `/workspace/output.md`.40

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.

Rooftop pv string

rooftop_pv_string

Rooftop PV string cable run

rooftop-pvdc-cable
Parameter ranges
string_current_a
6 – 14
dc_cable_length_m
10 – 80
cable_cross_section_mm2
4 – 16
cable_resistivity_ohm_mm2_m
0.017 – 0.022
string_voltage_v
300 – 900
annual_operating_hours
1000 – 2200
maximum_voltage_drop_pct
1.5 – 3

Utility pv string

utility_pv_string

Utility PV string home-run cable

utility-pvdc-cable
Parameter ranges
string_current_a
10 – 22
dc_cable_length_m
50 – 250
cable_cross_section_mm2
10 – 95
cable_resistivity_ohm_mm2_m
0.017 – 0.022
string_voltage_v
800 – 1500
annual_operating_hours
1400 – 2600
maximum_voltage_drop_pct
1 – 3

Example task

utility-pv-utility-pv-string-preview — hard difficulty, some inputs hidden.

Utility PV string home-run cable. utility-pv. Required outputs: voltage_drop_v, voltage_drop_pct, annual_energy_loss_kwh, voltage_drop_margin_pct

The model sees

Scenario context and visible inputs.

string_current_a
10 to 22 A
dc_cable_length_m
50 to 250 m
cable_cross_section_mm2
10 to 95 mm2
string_voltage_v
800 to 1500 V
annual_operating_hours
1400 to 2600 h/year
maximum_voltage_drop_pct
1 to 3 %

Executable tool: voltage-drop-dc_calc.py

The model must infer

Inputs withheld at this difficulty.

  • Cable resistivity ohm mm2

    cable_resistivity_ohm_mm2_m

Stand-in text in the prompt

Use the conductor resistivity implied by {{ archetype.description }}.

The model must produce

The scored JSON answer schema.

{
  "voltage_drop_v": <number>,
  "voltage_drop_pct": <number>,
  "annual_energy_loss_kwh": <number>,
  "voltage_drop_margin_pct": <number>
}
  • voltage_drop_v · scored within ±3%
  • voltage_drop_pct · scored within ±3%
  • annual_energy_loss_kwh · scored within ±3%
  • voltage_drop_margin_pct · scored within ±3%