Open engineering · evidence first

Inspect the model, the result, and the boundary before trusting the claim.

This collection connects battery physics, estimation, power conversion, grid operation, and project acceptance through executable models, research benchmarks, playbooks, notes, and evidence controls.

Collection map

From cell behavior to accepted project evidence.

  1. 01Battery physicsElectrical states, heat generation, cooling, degradation
  2. 02EstimationSOC correction, fitted degradation, bounded EOL/RUL
  3. 03Power conversionDC link, converter dynamics, active and reactive limits
  4. 04Grid operationFollowing, forming, voltage, frequency, reserve, energy
  5. 05Project acceptanceRequirements, tests, evidence IDs, revisions, handover

Evidence legend

Validated does not mean universally qualified.

Validated reference
Automated checks passed for stated equations, invariants, or scenarios at a pinned source.
Research benchmark
Experimental protocol and result bundle are inspectable; deployment claims remain out of scope.
Illustrative / synthetic
Useful for demonstrating a method, never presented as measured plant or cell performance.

Models and simulation laboratories

Executable battery, converter, thermal, estimation, and control references.

Models and simulation laboratoryValidated reference

MATLAB Simulink Energy Lab

How can battery, thermal, converter, and supervisory-control assumptions be turned into small executable models with deterministic evidence?

Stack
MATLAB · Simulink
Evidence
26 current-main entry points passed
Source
v0.10.0 · 2026-08-19
Reference modelsValidated reference

Battery and Power Electronics Reference Models

Which early thermal and DC-link assumptions should be made explicit before higher-fidelity design work begins?

Stack
Python · MATLAB
Evidence
6 unit tests passed
Source
7d9f61f · 2026-07-28

Analysis software

Transparent tooling for degradation fitting and bounded projection.

Analysis softwareAnalysis software

Battery Cycle-Life Analyzer

Which empirical degradation model best describes observed capacity fade, and how far can EOL projection be bounded honestly?

Stack
Python
Evidence
33 tests passed
Source
v0.1.0 · 2026-07-28

Research benchmarks

Audit-ready experiments with explicit information and result protocols.

Research benchmarkResearch benchmark

VoltRL

How do finite-state policies compare when information timing, holdout separation, battery constraints, degradation assumptions, and diagnostic bounds are explicit?

Stack
Python
Evidence
13 deterministic tests passed
Source
v1.1.0 · 2026-07-28

Engineering notes and validation guides

Executable references connected to assumptions, uncertainty, and traceability.

Engineering notes and validation guideResearch notes

Battery Thermal Modeling Notes

What evidence chain is needed to move a battery thermal claim from an equation or source into a reviewable engineering decision?

Stack
Python · Markdown
Evidence
84 tests + 10 subtests passed
Source
14e399f · 2026-07-28

Grid-storage playbooks

Constraint-aware references for active, reactive, frequency, voltage, and energy services.

Executable playbookExecutable playbook

Smart Grid Storage Playbook

How can grid-support commands be composed so every curtailment, capability limit, energy boundary, and illustrative assumption remains inspectable?

Stack
Python · Markdown
Evidence
151 tests + 372 subtests passed
Source
3ce0b4b · 2026-07-28

QA/QC and commissioning toolkits

Evidence controls for delivery, readiness, acceptance, and handover.

Engineering toolkitEngineering toolkit

BESS QA/QC Toolkit

How can project requirements, checks, evidence IDs, revisions, owners, deadlines, and acceptance decisions remain traceable through BESS delivery?

Stack
Python · Markdown · JSON
Evidence
142 tests + 4 subtests passed
Source
61d89bf · 2026-07-28
These artifacts are inspectable starting points, not qualified design authorities. Review the human-supervised workflow Inspect the public repository record