> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Technical guide to battery electrochemistry, PyBaMM modeling, parameterization, data fitting, and design optimization.

This Technical Guide covers the science behind lithium-ion batteries and battery modeling — electrochemistry, numerical methods, parameter identification, and design optimization. The content is vendor-neutral and aimed at building intuition rather than walking through any specific tooling.

<Note>
  For hands-on workflows using the Ionworks stack (pipelines, simulations, optimizations, the Python API), see the [Documentation tab](/introduction).
</Note>

## Table of Contents

### Batteries 101

Learn the fundamentals of lithium-ion battery science, from basic electrochemistry to system-level considerations.

<CardGroup cols={2}>
  <Card title="Fundamentals" icon="atom" href="/guide/batteries-101/how-do-batteries-work">
    How batteries work, electrode essentials, open circuit voltage, and reaction kinetics
  </Card>

  <Card title="Performance" icon="gauge-high" href="/guide/batteries-101/battery-capacity">
    Battery capacity, state of charge, internal resistance, and thermal behavior
  </Card>

  <Card title="Degradation" icon="chart-line-down" href="/guide/batteries-101/state-of-health">
    State of health, degradation mechanisms, SEI growth, lithium plating, and mechanical effects
  </Card>

  <Card title="Systems" icon="car-battery" href="/guide/batteries-101/battery-packs">
    Battery packs and battery management systems
  </Card>
</CardGroup>

### Modeling

Understand the numerical methods and models used for battery simulation.

<CardGroup cols={2}>
  <Card title="Finite Volume Method" icon="grid" href="/guide/modeling/finite-volume-method">
    How PyBaMM discretizes PDEs into systems of ODEs and DAEs
  </Card>

  <Card title="Initialization & eSOH" icon="play" href="/guide/modeling/initialization-esoh">
    Model initialization, electrode state of health, and initial concentrations
  </Card>

  <Card title="MSMR Model" icon="layer-group" href="/guide/modeling/msmr-model">
    Multi-Species Multi-Reaction thermodynamic model for OCP and diffusivity
  </Card>

  <Card title="Electrolyte Transport" icon="flask" href="/guide/modeling/electrolyte-transport">
    The four binary-electrolyte transport properties and how they are measured
  </Card>
</CardGroup>

### Parameterization

Parameter calculations, data fitting, and workflow orchestration concepts.

<CardGroup cols={2}>
  <Card title="SimplePipeline" icon="bolt" href="/guide/pipelines/simple-pipelines">
    Fire-and-forget execution for single-datafit or single-validation workflows
  </Card>

  <Card title="Pipelines" icon="diagram-project" href="/guide/pipelines/overview">
    How pipelines chain direct entries, calculations, and data fits to transform parameters
  </Card>

  <Card title="Direct Entries" icon="flask" href="/guide/pipelines/direct-entries/electrolyte">
    Drop-in literature parameter sets, including electrolyte transport properties
  </Card>

  <Card title="Data Fitting" icon="chart-line" href="/guide/data-fitting/overview">
    Estimating model parameters from experimental data
  </Card>
</CardGroup>

### Optimization

Design optimization for battery performance targets.

<CardGroup cols={1}>
  <Card title="Design Optimization" icon="gears" href="/guide/optimize/design-optimization">
    Optimizing design parameters to achieve performance objectives
  </Card>
</CardGroup>

### Reference

Terminology and conventions used throughout the documentation.

<CardGroup cols={1}>
  <Card title="Terminology & Standards" icon="book" href="/guide/reference/terminology">
    Battery modeling terminology and conventions
  </Card>
</CardGroup>
