Research — Illustrative (draft, unvalidated)
Charge/discharge cycle: auto walk
A full battery discharges to the floor you pick, pauses, and recharges while a cursor sweeps both charts. The tick on the progress bar is the moment discharge ends and recharge begins. Change the example battery, the floor, or ask for more power than the C-rate limit allows and watch the harness cap it and stretch the time.
Example battery
Discharge down to
Power asked for, as a multiple of the C-rate limit
Progress through one cycle
fulldischarge ends, recharge startsfull again
Reading —
Power and state of charge against time, one full cycle
Cycle status
Durations
Applied power
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 Megapack's 4-Hour and 2-Hour durations come out at exactly 4.00 h and 2.00 h, and the Powerwall usable-energy case is correct but trivial. Example batteries are read from the harness's standards/ files; the Megapack datasheet publishes no depth of discharge, so 100% is assumed there. The tick marks where discharge ends and recharge starts, a plain landmark and not a pass/fail threshold.Real functions this maps to:
calculate_discharge_duration, calculate_charge_duration, calculate_state_of_charge, calculate_round_trip_efficiency_loss, calculate_usable_energy, calculate_c_rate_power_limit.Not modeled: degradation or cycle-life fade, thermal derating, temperature effects on the rated numbers, voltage sag at high C-rate, taper or constant-voltage charging (power is flat for each leg), dispatch economics or EMS scheduling, and inverter kVA limits. The round-trip loss is reported for the recharge energy but not applied to the stored energy or the durations, because the harness functions do not do that either.See also:Charge/discharge cycle, interactive · Battery dispatch, auto demo