Research — Illustrative (draft, unvalidated)
Battery dispatch: energy, power limit and duration
Pick a datasheet example or type your own battery, then drag the state of charge. The pack is drawn to energy scale; the bars show the C-rate power limit, how long the stored energy lasts, how long a full charge takes, and what the round trip loses. The harness computes these values and never decides whether they are acceptable.
Battery pack to energy scale, with power, duration and round-trip loss bars
Example battery
Request as a multiple of the C-rate limit
State of charge
C-rate
Depth of discharge
Stated relative to whichever capacity you enter; check your source's convention.
Reserve held back
Round-trip efficiency
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), and 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; VALIDATION.md notes the Powerwall usable-energy case is correct but trivial (depth of discharge 100% of the usable figure), and no ingested product publishes a real sub-100% depth of discharge, so that path is checked only with synthetic numbers. The port is checked against values exported from the Python functions; nothing here calls the API.Real functions this maps to:
calculate_usable_energy, calculate_state_of_charge, calculate_c_rate_power_limit, calculate_discharge_duration, calculate_charge_duration, 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 (the C-rate is a system-level kW per kWh figure, not a cell-level electrochemical one), dispatch economics or EMS scheduling, inverter limits (kVA), and the Powerwall 2's 7 kW peak. The round-trip loss is shown for one full charge of the usable window; the harness does not shrink stored energy by the loss in its durations. The pack's band order is schematic; its heights are the kWh the functions return.See also:Battery dispatch, auto demo · Charge/discharge cycle, auto demo