Dc ac ratio
dc_ac_ratio
DC/AC ratio (Inverter Loading Ratio)
Scores if within ±1% of the reference value.
Calculates the DC/AC ratio (inverter loading ratio) for solar PV systems and estimates annual energy yield accounting for system losses, inverter efficiency, and clipping losses from inverter overloading. Uses a quadratic clipping model to balance higher array utilisation against peak-hour energy curtailment, per IEC 62548 and AS/NZS 5033.
with-tool: The model is given an executable Python calculator script.
Standards
One template produces many comparable benchmark tasks while keeping the scoring contract fixed.
01
The reusable contract shown on this page.
02
An archetype and site context are sampled.
03
Inputs may be hidden at harder tiers.
04
The model responds with the declared outputs.
Inputs the model receives, and the outputs it is scored on.
4 inputs
Included directly in every task prompt.
Dc array capacity
dc_array_capacity_kwp
Total PV array DC power capacity at STC
Inverter ac capacity
inverter_ac_capacity_kw
Total inverter AC power capacity (nameplate rating)
System losses pct
system_losses_pct
Total system losses excluding clipping (soiling, wiring, mismatch, temperature)
Sampled from the scenario and inferable from its description.
Annual psh
annual_psh
Annual peak sun hours for the site location
Derived from the archetype scenario. Hidden at hard difficulty.
4 outputs
dc_ac_ratio
DC/AC ratio (Inverter Loading Ratio)
Scores if within ±1% of the reference value.
estimated_clipping_loss_pct
Estimated annual clipping loss (%)
Scores if within ±5% of the reference value.
annual_energy_yield_kwh
Estimated annual energy yield (kWh)
Scores if within ±3% of the reference value.
specific_yield_kwh_per_kwp
Specific yield (kWh per kWp installed)
Scores if within ±3% of the reference value.
Each template is sampled at three tiers. Harder tiers may hide inputs, forcing the model to infer them from the scenario description.
All inputs given
Residential scale, all parameters given, moderate ILR
All inputs given
Commercial or utility scale, all parameters given, wider ILR range
Some inputs hidden
Peak sun hours hidden, agent must infer from site location context
Hidden inputs
Prompt replacement text
The project site is located in {{ archetype.site_context }}, a {{ archetype.description | lower }} environment.
The exact instruction and parameter contract used to generate this task, pinned to the published library source.
/workspace
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 electrical engineer specializing in solar PV system design.2 3## Problem4 5Calculate the DC/AC ratio (inverter loading ratio) for a solar PV installation, estimate the annual clipping losses, and determine the expected annual energy yield per IEC 62548 and AS/NZS 5033.6 7## Given8 9| Parameter | Value | Unit |10|-----------|-------|------|11| DC array capacity | {{ dc_array_capacity_kwp }} | kWp |12| Inverter AC capacity | {{ inverter_ac_capacity_kw }} | kW |13{% if annual_psh is defined %}14| Annual peak sun hours | {{ annual_psh }} | h |15{% endif %}16| System losses (excl. clipping) | {{ system_losses_pct }} | % |17{% if archetype_description is defined %}18 19### Site Context20 21{{ archetype_description }}22{% endif %}23 24{% if tool_available %}25## Available Tool26 27A DC/AC ratio calculation tool is available at `/workspace/dc-ac-ratio_calc.py`. Run it with:28 29```bash30python3 /workspace/dc-ac-ratio_calc.py --help31```32 33You may use this tool to verify your calculations or compute values directly.34{% endif %}35 36## Required37 38Calculate the following:39 401. DC/AC ratio (Inverter Loading Ratio, ILR) — ratio of DC array capacity to inverter AC capacity412. Estimated annual clipping loss (%) — energy lost when DC output exceeds inverter capacity423. Annual energy yield (kWh) — total AC energy produced over one year434. Specific yield (kWh/kWp) — energy produced per kWp of installed DC capacity44 45## Applicable Standards46 47- IEC 62548 — Photovoltaic (PV) arrays — Design requirements48- AS/NZS 5033 — Installation and safety requirements for photovoltaic (PV) arrays49 50## Constraints51 52- No internet access is available. Work from engineering knowledge and the provided tool.53- DC/AC ratio: ILR = DC array capacity (kWp) / inverter AC capacity (kW)54- Clipping loss estimation (quadratic model for moderate-irradiance sites):55 - For ILR ≤ 1.0: clipping = 0%56 - For ILR > 1.0: clipping_pct = 10.0 × (ILR - 1)² + (-0.5) × (ILR - 1), minimum 0%57- Inverter efficiency: 96.5% (CEC weighted)58- Annual energy yield: E = P_dc × PSH × (1 - system_losses/100) × η_inv × (1 - clipping/100)59- Specific yield: E / P_dc (kWh per kWp)60 61## Output Format62 63Show your step-by-step working in Markdown, including the ILR calculation, clipping loss estimation, and energy yield computation. At the end of your solution, include a JSON block with your final answers in exactly this format:64 65```json66{67 "dc_ac_ratio": <numeric_value>,68 "estimated_clipping_loss_pct": <numeric_value>,69 "annual_energy_yield_kwh": <numeric_value>,70 "specific_yield_kwh_per_kwp": <numeric_value>71}72```73 74Write your complete solution to `/workspace/output.md`.75 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.
residential_rooftop
Residential rooftop solar installation
commercial_rooftop
Commercial rooftop solar installation in Melbourne/Sydney (BOM avg 1400-1600 PSH)
utility_scale
Utility-scale ground-mounted solar farm in North Queensland (BOM avg 1800-2100 PSH)
arid_high_irradiance
Solar installation in arid high-irradiance region near Alice Springs/Broken Hill (BOM avg 2200-2500 PSH)
melbourne-commercial-commercial-rooftop-preview — hard difficulty, some inputs hidden.
Commercial rooftop solar installation in Melbourne/Sydney (BOM avg 1400-1600 PSH). melbourne-commercial. Required outputs: dc_ac_ratio, estimated_clipping_loss_pct, annual_energy_yield_kwh, specific_yield_kwh_per_kwp
Scenario context and visible inputs.
Executable tool: dc-ac-ratio_calc.py
Inputs withheld at this difficulty.
Annual psh
annual_psh
Stand-in text in the prompt
The project site is located in {{ archetype.site_context }}, a {{ archetype.description | lower }} environment.
The scored JSON answer schema.
{
"dc_ac_ratio": <number>,
"estimated_clipping_loss_pct": <number>,
"annual_energy_yield_kwh": <number>,
"specific_yield_kwh_per_kwp": <number>
}