Open-source · tested · executable

Battery engineering concepts you can inspect, run, and build on.

Learn from interactive visualizations, reusable Python models, and executable Jupyter notebooks. Every module states its assumptions, units, limitations, and validation scope.

StructureProductionAging

Chapter 1 · Battery cell foundations

Follow the concepts in order

Chapter 1 moves from cell structure and ratings through production routes and aging. Chapter 2 will develop equivalent-circuit models.

01Available

Interactive browser workbench

Cell anatomy and charge/discharge paths

Inspect the electrodes, current collectors, separator, electrolyte, electron path, and lithium-ion direction.

Launch workbench
01BAvailable

Interactive browser tutorial

Lithium-ion cell architecture

Assemble the five layers, then zoom into porous electrodes, pore electrolyte, solvent molecules, ions, and transport paths.

Launch tutorial
02Available

Python API + Jupyter notebook

Nominal capacity and C-rate

Connect capacity, current, and ideal duration using tested calculations and comparison visualizations.

Launch notebook

Binder's first launch may take a few minutes.

03Available

Interactive production simulator

Battery production

Follow a reference graphite/NMC route from mixing and coating through assembly, formation, aging, testing, and packing.

Launch simulator
03BAvailable

Interactive route-comparison simulator

All-solid-state cell production

Compare oxide, halide, sulfide, and polymer electrolyte routes from material preparation through formation and aging.

Launch SolidForge
04Available

Interactive Jupyter notebook

Battery aging

Explore how degradation mechanisms affect capacity, impedance, and self-discharge under different temperatures and cycling conditions.

Launch notebook

Binder's first launch may take a few minutes.

CH 2Planned

Tested Python models + notebooks

Equivalent Circuit Models

Build from terminal-voltage conventions and OCV to R0, one-RC, multiple-RC, identification, and validation.

Coming next
Open the Chapter 1 study guide View the complete learning roadmap

Supplementary interactive lab

Electrode potentials and battery materials

Self-contained interactive browser lab

Build cells, change voltage references, and compare electrode materials

Start with a Zn/Cu aqueous cell, inspect the water stability window, distinguish generic cells from lithium-ion intercalation, and explore material trade-offs with stated assumptions.

Open materials lab

Additional physics building block

Transport and diffusion

Tested Python module + notebook

Fick's first law

Calculate local diffusive flux with an explicit sign convention, validated inputs, scalar support, and NumPy array support.

Run notebook

How the project is built

Engineering principles

01

Explicit physics

Equations, units, assumptions, and sign conventions are written beside the model.

02

Tested behavior

Reusable functions and learning modules include automated structural and behavioral checks.

03

Honest limitations

Exact definitions, conceptual visualizations, illustrative relationships, and validated predictions are kept distinct.

Build in public

Read the code behind every lesson.

The source, tests, documentation, examples, notebooks, and project history are public on GitHub.

Explore the repository