Research — Illustrative (draft, unvalidated)
Battery dispatch: power cap sweep
The battery sits at 50% state of charge while the requested power climbs past its C-rate limit. Below the tick the duration shrinks as power rises; at the tick the harness starts capping the power at the limit and the duration stops improving. Pick a datasheet example to see the same walk at another scale.
Example battery
Requested power, as a multiple of the C-rate limit
0.25× limit1× · limit reached2× limit
Reading —
Battery pack to energy scale, with power, duration and round-trip loss bars
Dispatch status
Usable energy
Power limit
Round-trip loss
How the check read it
Client-side port:the logic and table in this page are a TypeScript port of the harness function, checked against values exported from the Python tests. Not a live API call. Module maturity, quoted from the harness repo: “Draft/unreviewed as of 2026-08-12 — no human domain-expert (power/storage systems engineer) has reviewed this code” (KICKOFF.md); VALIDATION.md calls its own pre-review “not a human SME sign-off.” The README says the functions are validated against the Tesla Powerwall 2 and Megapack 2 XL datasheets; the Powerwall usable-energy case is correct but trivial (100% depth of discharge of the usable figure). The example batteries' numbers are read from the harness's standards/ datasheet files; the datasheets publish no depth of discharge for the Megapack, so 100% is assumed there. The tick marks where the requested power equals the C-rate limit, a plain comparison and not a pass/fail threshold.Real functions this maps to:
calculate_c_rate_power_limit, calculate_discharge_duration, calculate_charge_duration, calculate_usable_energy, calculate_state_of_charge, calculate_round_trip_efficiency_loss.Not modeled: degradation or cycle-life fade, thermal derating, temperature effects on the rated numbers, voltage sag at high C-rate, dispatch economics or EMS scheduling, inverter kVA limits, and the Powerwall 2's 7 kW peak. The harness caps power but does not model what happens to a battery asked for more than its limit; a real system would be limited by its own controls.See also:Battery dispatch, interactive · Charge/discharge cycle, auto demo