Skip to main content

BattINFO Converter

PyPI version License Python Versions Checks Coverage

BattINFO Converter is a Python-based web application that simplifies the semantic annotation of battery metadata. It converts coin cell battery metadata from an Excel-based schema into a JSON-LD format using the BattINFO ontology, ensuring standardized and machine-readable metadata. This tool is designed for non-technical users, eliminating the need for manual JSON-LD creation. Researchers only need to fill in an Excel template, and the converter automates the transformation process, enhancing data interoperability, reproducibility, and FAIRness. By adopting BattINFO Converter, research groups can ensure that their battery metadata is structured, shareable, and reusable, facilitating better collaboration and advancing battery research.

🔗 Visit BattINFO converter to use the app.

Python package

The backend that powers the web application is available as a Python package, which can be used for batch/automation tasks or reused in other projects. Install with:

pip install battinfoconverter-backend

Use the XLSX → JSON-LD conversion with:

from battinfoconverter_backend import convert_excel_to_jsonld

result = convert_excel_to_jsonld("example.xlsx")

If you want to run the streamlit app locally, clone the repo and use streamlit run. For example, with uv:

git clone https://github.com/empaeconversion/battinfoconverter  # Clone the repo
cd battinfoconverter  # Go into the cloned folder
uv sync --extras=app # Install battinfoconverter with app dependencies
uv run streamlit run ./battinfo_app/BattInfo_converter.py  # Run the app

Citation

Nukorn Plainpan, Simon Clark, and Corsin Battaglia. "BattINFO Converter: An Automated Tool for Semantic Annotation of Battery Cell Metadata." Batteries & Supercaps (2025): 2500151. doi.org/10.1002/batt.202500151

Acknowledgements

The BattINFO converter web application was developed by Dr. Nukorn Plainpan, Dr. Graham Kimbell, and Prof. Dr. Corsin Battaglia at Empa, the Swiss Federal Laboratories for Materials Science and Technology in the Laboratory Materials for Energy Conversion. We acknowledge stimulating discussions and support from Dr. Simon Clark, SINTEF.

The development of BattINFO converter was supported by funding for the Battery2030+ initiative from the European Union’s research and innovation program under grant agreement No. 957213 and No. 101104022 and from the Swiss State Secretariat for Education, Research, and Innovation (SERI) under contract No. 2300313 as well as funding for the PREMISE project from the open research data program of the ETH Board.

Sponsors

Metadata

Release files for battinfoconverter-backend 3.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for battinfoconverter-backend 3.4.0
File Size Uploaded
battinfoconverter_backend-3.4.0.tar.gz 152.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for battinfoconverter-backend 3.4.0
File Interpreter ABI Platform
battinfoconverter_backend-3.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 296.0 kB

Release files / battinfoconverter_backend-3.4.0.tar.gz

Download URL battinfoconverter_backend-3.4.0.tar.gz
Size 152.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b42d0fb85515ae94ae1d5558ab424a0637bffbf7fc998bdd98fc8b5cc36b2a04
BLAKE2b-256 checksum
How to use checksums
3691467a79d7d9acebc997942031e9243c6900680efc5ec6125a0d5f64282f01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / battinfoconverter_backend-3.4.0-py3-none-any.whl

Download URL battinfoconverter_backend-3.4.0-py3-none-any.whl
Size 143.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a25ad5b33fc0a0c41e0ead9ed570f574f09082999d79fc10abc1685c7dc6677c
BLAKE2b-256 checksum
How to use checksums
4c49d3adeb042c3b5b4331946be2f9239be08ec4d3ddd95dbdcc12a791de16e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

3.4.0 This release

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.0

2 release files

3.1.2

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.1

2 release files

2.2.5

2 release files

2.2.2

2 release files

2.2.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page