Skip to content

Battery Cycle-Life Analyzer v0.1.0

Latest

Choose a tag to compare

@mohammadrezwankhan mohammadrezwankhan released this 25 Jul 21:29

Battery Cycle-Life Analyzer v0.1.0 is a compact, inspectable Python baseline
for fitting battery capacity-fade data and projecting an end-of-life threshold
inside an explicit extrapolation limit.

Highlights:

  • linear, power-law, and logarithmic SciPy fits with parameter covariance;
  • RMSE and R^2 diagnostics for every candidate model;
  • bounded EOL projection that returns no estimate when the threshold is
    outside the supported window;
  • CSV/TSV cycle-capacity import plus a provenance-aware long-form schema for
    cell ID, chemistry, timestamps, temperature, C-rate, rest time, protocol,
    cycling rate, depth of discharge, throughput, and duty-cycle descriptors;
  • deterministic synthetic LFP/NMC demonstrations;
  • bcla console command, Python API, Colab notebook, and publication-ready
    Matplotlib figures;
  • 33 tests passing on Python 3.9, 3.10, 3.11, and 3.12.

Install directly from the tagged source:

python -m pip install \
  "git+https://github.com/mohammadrezwankhan/battery-cycle-life-analyzer.git@v0.1.0"
bcla --help

This is an empirical research and educational tool, not an electrochemical,
pack-safety, or production BMS model. The bundled data are synthetic, the
current release does not propagate confidence intervals into RUL, and the
Arrhenius helper is not coupled to the fitted capacity-fade trajectory.

Documentation:
https://github.com/mohammadrezwankhan/battery-cycle-life-analyzer#readme

Changelog:
https://github.com/mohammadrezwankhan/battery-cycle-life-analyzer/blob/main/CHANGELOG.md