Overview
The Battery Knowledge Base (BKB) collates metadata records of battery data sets to support FAIR data management and integration with the Semantic Web. To maintain some quality control, the BKB links with curated data sources. The preferred platform for BKB dataset submissions is the Battery Knowledge Base Community on Zenodo. This How-To guide outlines the recommended process for pre-processing data and submitting for inclusion in the BKB.
Serialize in an open file format
To maximize the accessibility and re-usability of datasets, submissions should contain only data in file formats that are open and accessible. Proprietary formats are not accepted. Accepted formats include:
*If CSV files are used, make sure that numbers use a decimal point (.) and not a comma (,) ! To avoid any potential issue, it is recommended to use a tab delimiter instead of a comma delimiter in CSV submissions.
| Format
|
Description
|
MIME Type
|
| PARQUET
|
Columnar binary format ideal for large-scale structured data
|
application/vnd.apache.parquet
|
| TXT
|
Unstructured or line-based plain text, often used for configs
|
text/plain
|
| JSON
|
Structured, hierarchical data format for metadata or results
|
application/json
|
| CSV*
|
Plain-text tabular data with comma-separated values
|
text/csv
|
Adopt a standard table schema
The table schema for the dataset should adhere to an accepted standard or provide the necessary metadata to interpret the meaning of the column names. It is recommended to use the Battery Data Format table schema. For more information on how to serialize your data in the battery data format, please refer to this dedicated How-To guide.
Overview of the main keys included in the Battery Data Format specification
| Key
|
Required
|
Type
|
Description
|
IRI
|
| test_time_millisecond
|
required
|
int
|
Number of milliseconds since the start of the test
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#test_time_millisecond
|
| current_ampere
|
required
|
float
|
Instantaneous current, recorded in ampere
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#current_ampere
|
| voltage_volt
|
required
|
float
|
Instantaneous voltage, recorded in volt
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#voltage_volt
|
| cycle_count
|
required
|
int
|
Used to track evolution of performance metrics over the course of aging
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#cycle_count
|
| date_time_millisecond
|
recommended
|
int
|
Encodes actual date and time when the measurement was made using Unix time in milliseconds
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#date_time_millisecond
|
| ambient_temperature_celsius
|
optional
|
float
|
Temperature of the ambient conditions during the measurement
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#ambient_temperature_celsius
|
| ambient_pressure_pascal
|
optional
|
float
|
Pressure of the ambient conditions during the measurement
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#ambient_pressure_pascal
|
| surface_temperature_celsius
|
optional
|
float
|
Surface temperature of the cell during the measurement
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#surface_temperature_celsius
|
| surface_pressure_pascal
|
optional
|
float
|
Surface pressure of the cell during the measurement
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#surface_pressure_pascal
|
| dcir_ohm
|
optional
|
float
|
Direct current internal resistance
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#dcir_ohm
|
| step_count
|
optional
|
int
|
Step index
|
https://w3id.org/battery-data-alliance/ontology/battery-data-format#step_count
|
Create Metadata
Open a Zenodo Record
Write a Description