Quantum Reservoir Computing for Battery State-of-Health Estimation from Electrochemical Impedance Spectroscopy

v1.1.0 — Public Release

First tagged public release of the code accompanying the manuscript Quantum Reservoir Computing for Battery State-of-Health Estimation from Electrochemical Impedance Spectroscopy (Applied Energy, under review).

What's New Since Initial Public Push

• LICENSE — Apache License 2.0.
• CITATION.cff — machine-readable citation metadata with Zenodo DOI and preferred-citation pointing to the manuscript.
• .env.example — template for IBM Quantum credentials (IBM_ACC{1,2,3}_API / _CRN) consumed by Phase 6 hardware runs.
• README.md — expanded with license / DOI badges, the 12-phase public-order table, hardware notes, data-roots layout, IBM credential setup, and a How To Cite section.

What This Release Contains

• src/ — analysis pipelines, model code, dataset loaders, and the public phase registry (src/public_release.py).
• environment.qiskit.yml — conda environment specification (escl-quantum, Python 3.10, Qiskit + qiskit-ibm-runtime + qiskit-aer + scikit-learn + xgboost + torch).
• data/README.md — dataset access notes and redistribution status.

Covers the Warwick primary workstream, Stanford support experiments, ESCL temporal validation, and IBM hardware feasibility runs.

What This Release Does Not Contain

• Raw datasets — Warwick (Mendeley, public) and Stanford (OSF, public) must be downloaded from their original sources; ESCL lab data is restricted and not redistributed.
• Manuscript drafts, reference PDFs, internal planning notes, and generated result/ folders.

Quick Start

conda env create -f environment.qiskit.yml
conda activate escl-quantum
python -m src.public_release --list

For Phase 6 (IBM hardware) only: cp .env.example .env and fill in your IBM Cloud Quantum API token + instance CRN.

How To Cite

Software (this release): see CITATION.cff or use the Zenodo DOI 10.5281/zenodo.19591235.

Manuscript: Hernowo, B. E., Lee, M., Isaiah, E. O., Barancira, T. D., & Kim, J. (2026). Quantum Reservoir Computing for Battery State-of-Health Estimation from Electrochemical Impedance Spectroscopy. Applied Energy (under review).

License

Apache License 2.0 — see LICENSE.