Metadata-Version: 2.4
Name: toyo-battery
Version: 0.0.1
Summary: OSS Python toolkit for TOYO battery cycler data (charge/discharge, dQ/dV, cycle stats). Installable from PyPI into Origin's embedded Python.
Project-URL: Homepage, https://github.com/tomooki/toyo-battery
Project-URL: Issues, https://github.com/tomooki/toyo-battery/issues
Project-URL: Repository, https://github.com/tomooki/toyo-battery
Project-URL: Documentation, https://tomooki.github.io/toyo-battery/
Project-URL: Changelog, https://github.com/tomooki/toyo-battery/blob/main/CHANGELOG.md
Author-email: tomooki <tomooki0414@gmail.com>
License: MIT
License-File: LICENSE
Keywords: battery,cycler,dQdV,electrochemistry,origin,toyo
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.9
Requires-Dist: numpy>=1.23
Requires-Dist: pandas>=2.0
Requires-Dist: scipy>=1.10
Provides-Extra: all
Requires-Dist: kaleido>=0.2.1; extra == 'all'
Requires-Dist: matplotlib>=3.7; extra == 'all'
Requires-Dist: plotly>=5.18; extra == 'all'
Requires-Dist: rich>=13; extra == 'all'
Requires-Dist: typer>=0.12; extra == 'all'
Provides-Extra: cli
Requires-Dist: rich>=13; extra == 'cli'
Requires-Dist: typer>=0.12; extra == 'cli'
Provides-Extra: gui
Requires-Dist: matplotlib>=3.7; extra == 'gui'
Provides-Extra: origin
Provides-Extra: plot
Requires-Dist: matplotlib>=3.7; extra == 'plot'
Provides-Extra: plotly
Requires-Dist: kaleido>=0.2.1; extra == 'plotly'
Requires-Dist: plotly>=5.18; extra == 'plotly'
Description-Content-Type: text/markdown

# toyo-battery

OSS Python toolkit for TOYO battery cycler data.

Reads output from TOYO System battery charge/discharge testers, computes
cycle capacity, Coulombic efficiency, dQ/dV curves, and summary statistics.
Pure Python, installable from PyPI — including into OriginLab's embedded
Python.

> Status: **0.0.1 — pre-alpha scaffold.** Core logic is being ported from the
> private `TOYO_origin` scripts. Public API is unstable.

## Installation

```bash
# Core only
pip install toyo-battery

# With Matplotlib plotting
pip install "toyo-battery[plot]"

# Everything except Origin
pip install "toyo-battery[all]"
```

### CLI

With the `[cli]` extra (`pip install "toyo-battery[cli]"`) the `toyo-battery`
command offers batch operations over one or more cell directories:

```bash
toyo-battery process cell_A cell_B --out ./csvs        # chdis/cap/dqdv CSVs
toyo-battery plot    cell_A cell_B --out ./pngs        # chdis/cycle/dqdv PNGs
toyo-battery stats   cell_A cell_B --cycles 10,50 --out stats.csv
```

### Installing into Origin's embedded Python

Open Origin, go to **Connectivity → Python Packages**, then in the Origin
Python console:

```python
import subprocess
import sys

subprocess.check_call([sys.executable, "-m", "pip", "install", "toyo-battery"])
```

The `toyo_battery.origin` submodule uses `originpro` (shipped with Origin)
and is only importable inside Origin's Python environment.

## Quick start

```python
from toyo_battery import Cell

cell = Cell.from_dir("path/to/cell_dir")
cell.cap_df.to_csv("cycle.csv")
```

## License

MIT — see [LICENSE](./LICENSE).
