Docs
Overview
Battery Data Standard converts raw battery cycler exports into validated BDS tables.
Normalize
Map vendor files into consistent time, voltage, current, capacity, energy, and metadata columns.
Validate
Check required BDS fields before outputs enter notebooks, ETL jobs, or automated analysis.
Report
Preserve schema version, provenance, adapter metadata, warnings, and repair operations.
Use BDS for laboratory workflows and battery data pipelines that need a repeatable path from vendor-specific cycler exports to analysis-ready CSV or Parquet files.
Start with the CLI
Detect the source format, inspect adapter coverage, convert the file, and validate the result before using it downstream.
# Install
$ pip install --upgrade battery-data-standard
# Explain file
$ bds explain raw_export.csv --text
# Detect kind
$ bds detect raw_export.csv
# Doctor
$ bds doctor raw_export.csv
# Convert
$ bds convert raw_export.csv normalized.bds.csv --cycler auto --report auto
# Audit
$ bds audit raw_exports --recursive --json audit.json
Explore the docs
Quickstart
Install the CLI and run your first BDS conversion.
OpenSupported formats
Review cycler, EIS, archive, and generic inputs plus support and evidence tiers.
OpenExport template
Understand output labels, units, and column order.
OpenDiagnostics
Use explain, doctor, audit, and conversion reports to review mapping, repairs, and anomalies.
OpenBDS integrations
Prepare BDS outputs for DuckDB, Polars, cellpy, BEEP, PyBaMM, PyProBE, and Battery Archive.
Open