Metadata-Version: 2.4
Name: beep
Version: 2026.2.7
Summary: beep is a python package supporting Battery Estimation and Early Prediction of battery cycle life.
Author: Energy and Materials - Toyota Research Institute
Maintainer: Energy and Materials - Toyota Research Institute
License: Apache-2.0
Project-URL: Homepage, https://github.com/TRI-AMDD/beep
Project-URL: Repository, https://github.com/TRI-AMDD/beep
Project-URL: Documentation, https://github.com/TRI-AMDD/beep
Keywords: materials,battery,chemistry,science,electrochemistry,energy,AI,artificial intelligence
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=2.0
Requires-Dist: monty[yaml]>=2024.0
Requires-Dist: scipy>=1.14
Requires-Dist: scikit-learn>=1.5
Requires-Dist: pandas>=2.2
Requires-Dist: tqdm>=4.66
Requires-Dist: boto3>=1.34
Requires-Dist: botocore>=1.34
Requires-Dist: pytz>=2024.1
Requires-Dist: watchtower>=3.2
Requires-Dist: msgpack-python>=0.5.6
Requires-Dist: python-dateutil>=2.9
Requires-Dist: ruamel.yaml>=0.18
Requires-Dist: xmltodict>=0.13
Requires-Dist: pydash>=8.0
Requires-Dist: lmfit>=1.3
Requires-Dist: click>=8.1
Requires-Dist: matplotlib>=3.7
Requires-Dist: h5py>=3.11
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Requires-Dist: memory_profiler>=0.61; extra == "test"
Requires-Dist: requests; extra == "test"
Provides-Extra: dev
Requires-Dist: beep[test]; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: pre-commit>=3.7; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.1; extra == "docs"
Requires-Dist: mkdocstrings>=0.18; extra == "docs"
Dynamic: license-file

# Battery Evaluation and Early Prediction (BEEP)

<h4 align="center">

![Testing - main](https://github.com/TRI-AMDD/beep/workflows/Testing%20-%20main/badge.svg)
![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12-blue)
[![PyPI version](https://badge.fury.io/py/beep.svg)](https://badge.fury.io/py/beep)
[![GitHub Repo Size](https://img.shields.io/github/repo-size/TRI-AMDD/beep?label=Repo+Size)](https://github.com/TRI-AMDD/beep/graphs/contributors)

</h4>

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](https://d3batt.mit.edu/) and the [Toyota Research Institute](http://www.tri.global/accelerated-materials-design-and-discovery/).

* **Documentation:** https://tri-amdd.github.io/beep
* **Source code:** https://github.com/TRI-AMDD/beep
* **PyPI release:** https://pypi.org/project/beep/

## Installation

```bash
pip install beep
```

For development:

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

## Supported Cyclers

- [Arbin Instruments](https://www.arbin.com/)
- [Novonix Group](https://novonixgroup.com/)
- [MACCOR](http://www.maccor.com/)
- [BioLogic](https://www.biologic.net/product_category/battery-cyclers/)
- [Neware](https://newarebattery.com/)
- [Battery Archive](https://www.batteryarchive.org/) data

## Quick Start

```python
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](https://doi.org/10.1016/j.softx.2020.100506)
