Cell Capacity

The battery data toolkit uses a simple defintion of the charge and discharge capacity of a battery with nuanced implications. In short, we integrate the power and current moving out of the battery over time then use the maximum change from the start of the cycle to determine the capacity. We illustrate the subtle parts below.

%matplotlib inline
from matplotlib import pyplot as plt
from batdata.postprocess.integral import StateOfCharge, CapacityPerCycle
from batdata.data import BatteryDataset
from pathlib import Path

Load Example Data

We have two simple cells that vary only by the where the “cycle” starts.

from_charged = BatteryDataset.from_batdata_hdf('../../tests/files/example-data/single-resistor-constant-charge_from-charged.hdf')

from_discharged = BatteryDataset.from_batdata_hdf('../../tests/files/example-data/single-resistor-constant-charge_from-discharged.hdf')

Step 1: Intergrate Current and Power

First integrate the current (\(I\)) and power output (\(IV\)) of a battery to determine the amount of charge and energy transfered from the battery during each cycle.

The StateOfCharge tool in battery-data-toolkit computes these integrals.

charge = StateOfCharge()

charge.compute_features(from_charged);
charge.compute_features(from_discharged);

fig, axxs = plt.subplots(2, 2, sharex=True, sharey='row', figsize=(6., 4.))

for axs, data, label in zip(axxs.T, [from_charged, from_discharged], ['Charged', 'Discharged']):
    axs[0].set_title(f'From {label}', fontsize=10)
    axs[0].plot(data.raw_data['test_time'], data.raw_data['cycle_energy'])
    axs[1].plot(data.raw_data['test_time'], data.raw_data['cycle_capacity'])

axxs[0, 0].set_ylabel('$\Delta$Energy (W-hr)')
axxs[1, 0].set_ylabel('$\Delta$Capacity (A-hr)')

for ax in axxs[-1, :]:
    ax.set_xlabel('Time (s)')

fig.tight_layout()

Step 2: Assess Whether the Starting Point is Charged

We determine the starting point of the battery as “charged” or “discharged” as whether the maximum change from the start is positive or negative. It’s clear in the image above that the “from charged” battery releases charge in the beginning of the cycle before returning to zero, and the “from discharged” doe sthe opposite.

Note: This definition assumes that a cycle returns a battery to as close to the initial charging state as possible.

Step 3: Assign Capacities

We set capacities are using the maximum change from starting capacity, and the difference between that maximum and the change between the start and end of a cycle. What each difference represents depends on whether the battery starts by discharging or charging.

capc = CapacityPerCycle()

fig, axxs = plt.subplots(2, 2, sharex=True, sharey='row', figsize=(6., 4.))

for axs, data, label in zip(axxs.T, [from_charged, from_discharged], ['Charged', 'Discharged']):
    capc.compute_features(data)

    # Start with the changes over time
    axs[0].set_title(f'From {label}', fontsize=10)
    axs[0].plot(data.raw_data['test_time'], data.raw_data['cycle_energy'])
    axs[1].plot(data.raw_data['test_time'], data.raw_data['cycle_capacity'])

    # Annotate the capacities/energies
    row = data.cycle_stats.iloc[0]
    axs[0].set_xlim(ax.get_xlim())
    for ax in axs:
        ax.plot([0, 3600], [0, 0], 'k-', lw=1)

    # Plot the energies
    for i, t in enumerate(['energy', 'capacity']):
        first_level = (-row[f'{t}_discharge'] if label == 'Charged' else row[f'{t}_charge'])
        axs[i].arrow(3600, 0, 0, first_level, color='red')
        axs[i].text(3700, first_level / 2., '$' + t[0].upper() + '_{' + ("dhg" if label == "Charged" else "chg") + '}$')

        axs[i].plot([3600, 7200], [first_level] * 2, 'k-', lw=1)
        second_level = (-row[f'{t}_discharge'] if label != 'Charged' else row[f'{t}_charge'])
        axs[i].arrow(7200, first_level, 0, second_level, color='red')
        axs[i].text(7200, first_level / 2., '$' + t[0].upper() + '_{' + ("dhg" if label != "Charged" else "chg") + '}$', ha='right')


axxs[0, 0].set_ylabel('$\Delta$Energy (W-hr)')
axxs[1, 0].set_ylabel('$\Delta$Capacity (A-hr)')

for ax in axxs[-1, :]:
    ax.set_xlabel('Time (s)')

fig.tight_layout()
fig.savefig('figures/explain-capacities.png', dpi=320)

The charge and discharge energies (or capacities) for the battery is the same for both cycles, we just have to look a different parts of the curve for each cycle.

Demonstrate on a Complex Cycling

As an example for how the capacity measurements aren’t always meaningful, let’s consider the same battery but with a charging cycle which is interrupted with a short discharge

complex = BatteryDataset.from_batdata_hdf('../../tests/files/example-data/single-resistor-complex-charge_from-discharged.hdf')

fig, ax = plt.subplots(figsize=(3., 1.8))

ax.plot(complex.raw_data['test_time'], complex.raw_data['current'])

ax.set_xlabel('Time (s)')
ax.set_ylabel('Current (A)')

Text(0, 0.5, 'Current (A)')

It is still possible and meaningful to measure the change in charge and the energy added to the battery system.

charge.compute_features(complex);

fig, axs = plt.subplots(2, 1, sharex=True, sharey='row', figsize=(3., 3.3))

axs[0].plot(complex.raw_data['test_time'], complex.raw_data['cycle_energy'])
axs[1].plot(complex.raw_data['test_time'], complex.raw_data['cycle_capacity'])

axs[0].set_ylabel('$\Delta$Energy (W-hr)')
axs[1].set_ylabel('$\Delta$Capacity (A-hr)')

axs[1].set_xlabel('Time (s)')

fig.tight_layout()

However, the measurements of capacity get strange

capc.compute_features(complex)

	cycle_number	energy_charge	capacity_charge	energy_discharge	capacity_discharge
0	0	2.62234	1.0	2.398389	0.999444

from_discharged.cycle_stats

	cycle_number	energy_charge	capacity_charge	energy_discharge	capacity_discharge
0	0	2.600084	1.0	2.397584	0.999167

The discharge part of the cycle is unchanged, so the estimates for the discharge energy and capacity are nearly identical (just numerical differences) between the simple and complex charge.

The charge part of the cycle is different between the two cycles. The integral of current over that time is the same, so both yield a charge capacity of 1. However, the amount of energy required to charge was larger for the complex cycle due to the energy loss during the pulse during charge, which leads to over-estimating the batteries energy of charge.

In short, take caution when comparing the capacities and energies measured during different cycling protocols.

Use on Actual Testing Data

Demonstrating on data from the XCEL Dataset

from batdata.extractors.batterydata import BDExtractor
xcel_data = BDExtractor().parse_to_dataframe(['../../tests/files/batterydata/p492-13-raw.csv'])

charge.compute_features(xcel_data);

These cells contain many aging cycles, with different provenances

fig, axs = plt.subplots(2, 1, figsize=(3, 2), sharex=True)

d = xcel_data.raw_data.query('cycle_number > 6')
ax = axs[0]
ax.plot(d['test_time'] / 3600, d['current'])
ax.set_ylabel('$I$ (A)')

ax = axs[1]
# Plot the cycle capacity
ax.plot(d['test_time'] / 3600, d['cycle_capacity'] * 1000)

# Mark where cycles start
cycle_start = d.drop_duplicates('cycle_number', keep='first')[['test_time', 'cycle_number']]
for ax in axs:
    ax.set_ylim(ax.get_ylim())
    for ind, start in zip(cycle_start['cycle_number'], cycle_start['test_time']):
        axs[0].text(start / 3600 + 0.1, 0.01, ind)
        ax.plot([start / 3600] * 2, ax.get_ylim(), 'k--', lw=1)

ax.set_ylabel('$\Delta$Capacity\n(mA-hr)')
ax.set_xlabel('Test Time (hr)')

fig.tight_layout()

The battery was determined to have a capacity of ~19 mAh, consistent with what we see in the above plot for the second cycle (Cycle 8) but not the first. As discussed above, no all cycles are good for estimating capacity but we can do it.

Note how we get values close to the known capacity for some only a few of the cycles included in our dataframe.

capc.compute_features(xcel_data)

/home/lward/Work/ROVI/battery-data-toolkit/batdata/postprocess/integral.py:83: UserWarning: Unable to clearly detect if battery started charged or discharged in cycle 6. Amount discharged is -0.00e+00 A-s, charged is 0.00e+00 A-s
  warnings.warn(f'Unable to clearly detect if battery started charged or discharged in cycle {cyc}. '

	cycle_number	energy_charge	capacity_charge	energy_discharge	capacity_discharge
0	0	5.708257e-09	1.875000e-09	2.255638e-03	7.170268e-04
1	1	8.078932e-02	2.186822e-02	7.969142e-02	2.173635e-02
2	2	3.792782e-02	1.059627e-02	0.000000e+00	0.000000e+00
3	3	4.582476e-02	1.121207e-02	7.670663e-09	1.875000e-09
4	4	0.000000e+00	0.000000e+00	1.296412e-01	3.653862e-02
5	5	2.881001e-02	7.866233e-03	0.000000e+00	0.000000e+00
6	6	-0.000000e+00	0.000000e+00	-0.000000e+00	0.000000e+00
7	7	9.563373e-09	2.875000e-09	3.320689e-02	9.473813e-03
8	8	7.072788e-02	1.894571e-02	6.924310e-02	1.900843e-02