Battery Evaluation and Early Prediction (BEEP)

February 8, 2026 · View on GitHub

Testing - main Python PyPI version GitHub Repo Size

BEEP is a set of tools designed to support Battery Evaluation and Early Prediction of cycle life corresponding to the research of the d3batt program and the Toyota Research Institute.

Installation

pip install beep

For development:

git clone https://github.com/TRI-AMDD/beep.git
cd beep
pip install -e ".[dev]"

Supported Cyclers

Quick Start

from beep.structure.maccor import MaccorDatapath

# Load and structure a cycler file
datapath = MaccorDatapath.from_file("path/to/file.txt")
datapath.structure()

# Access structured data
print(datapath.structured_summary)

How to cite

If you use BEEP, please cite this article:

P. Herring, C. Balaji Gopal, M. Aykol, J.H. Montoya, A. Anapolsky, P.M. Attia, W. Gent, J.S. Hummelshøj, L. Hung, H.-K. Kwon, P. Moore, D. Schweigert, K.A. Severson, S. Suram, Z. Yang, R.D. Braatz, B.D. Storey, SoftwareX 11 (2020) 100506. https://doi.org/10.1016/j.softx.2020.100506