Battery Pass Data Model
Standardizing and streamlining the exchange of battery-related information across the value chain to allow informed stakeholder decisions for sustainable circular economy.
https://github.com/batterypass/batterypassdatamodel
Category: Energy Storage
Sub Category: Battery
Last synced: about 20 hours ago
JSON representation
Repository metadata
Battery Passport Data Model repository from the Battery Pass Project
- Host: GitHub
- URL: https://github.com/batterypass/batterypassdatamodel
- Owner: batterypass
- Created: 2024-05-30T11:08:06.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-17T15:16:18.000Z (5 months ago)
- Last Synced: 2026-04-14T01:02:51.328Z (8 days ago)
- Language: HTML
- Homepage: https://batterypass.github.io/BatteryPassDataModel/
- Size: 64.8 MB
- Stars: 53
- Watchers: 15
- Forks: 12
- Open Issues: 22
- Releases: 0
-
Metadata Files:
- Readme: README.md
README.md
Battery Pass Data Model v1.2.0
Welcome to the Battery Pass Data Model repository! This project provides a comprehensive data model based on the DIN DKE SPEC 99100:2025-02 "Requirements for data attributes of the battery passport", aimed at standardizing and streamlining the exchange of battery-related information across the value chain to allow informed stakeholder decisions for sustainable circular economy. The defined data requirements are fully aligned with the EU Battery Regulation and the Eco-Design Directive for Sustainable Products (ESPR).
The provided data modelling approach is a proposal for a sector specific DPP (Battery Passport).
Table of Contents
Overview
The Battery Pass Data Model is designed to facilitate the digital representation of battery-related data, ensuring compliance with industry standards and regulatory requirements. This model supports the efficient exchange of data between various stakeholders in the battery lifecycle, including manufacturers, suppliers, recyclers, and regulators. The content of the data model is derived from the Battery Pass Project Data Point List.
Meanwhile the Battery Pass Consortium contributed to the DIN DKE SPEC 99100:2025-02 "Requirements for data attributes of the battery passport". This necessitates some updates of the data points, which are reflected in corresponding changes in the data models for the different parameter categories in this new version v1.2.0. In each description of a data point a reference to the corresponding chapter in the DIN DKE Spec 99100 is provided for more detailed information.
The complete Battery Passport project documentation is available at the documentation folder
Features
- Standardized Data Representation: Ensures uniformity in the way battery data is recorded and shared.
- Comprehensive Coverage: Includes all critical aspects of battery data as specified in the DIN DKE SPEC 99100:2025-02 "Requirements for data attributes of the battery passport".
- Scalability: Suitable for use in projects of varying scales, from small businesses to large enterprises.
- Interoperability: Facilitates seamless data exchange between different systems and platforms.
Installation
To use the Battery Pass Data Model, you can clone the repository and integrate it into your project. Ensure you have Git installed.
git clone https://github.com/batterypass/BatteryPassDataModel.git
cd BatteryPassDataModel
Usage
To incorporate the data model into your application, follow these steps:
-
Clone the Repository:
git clone https://github.com/batterypass/BatteryPassDataModel.git -
Import the Data Model:
Integrate the provided data model definitions into your database or application schema. Refer to the documentation in the/docsdirectory for detailed description of the battery pass data attributes. -
Customize as Needed:
Adapt the data model to fit your specific requirements. Ensure any modifications remain compliant with the DIN DKE SPEC 99100:2025-02.
Data Model Structure
The data modelling approach follows the idea to provide a common formal plattform independent description of the semantic data model by means of the W3C Resource Description Framework (RDF) from which platform specific data model formats can be derived from. The common plattform independent formal data model description shall ensure interopreability between the plattform specifc data models that can be used in diffewrent technical implementations of a battery passport solution.
The data model is organized into several parameter categories, each representing a different dedicated aspect of battery data, that can be composed to a complete battery pass data model. Below is a high-level overview. You'll find a detailed list with descriptions of the individual data points in the /doc folder. Follow the links for the different data attribute categories for further information on the individual sub-models.
General Product Information: Documentation
- Battery ID
- Manufacturer
- Battery status
- Production Date
- etc.
Alternative data representation formats for General Product Information
Carbon Footprint: Documentation
- Battery Carbon footprint
- Carbon footprint of different lifecycle stages of the battery
- Carbon footprint study and perfromance class
- etc.
Alternative data representation formats for Battery Carbon Footprint
Circularity: Documentation
- End of live management
- Safety requirements
- Recycled and renewable content
- etc.
Alternative data repreesntation formats for Circularity
Material Composition: Documentation
- Battery chemistry
- Critical raw materials
- Hazardous substances
- etc.
Alternative data representation formats for Material Composition
Performance & Durability: Documentation
- Static performance KPIs and technical specification parameters (Capacity, power capibility, etc. )
- Dynamic performance KPI representing the current condition of the battery (SoH, full charge cycles, etc.)
- Negative events
- etc.
Alternative data representation formats for Performance and Durability
Labels and Certification: Documentation
- Declaration of conformity
- Labels (Separate collection, materials)
- Test reports
- etc.
Alternative data representation formats for Battery Labels and Certification
Due Diligence: Documentation
- Third party verifications
- Sustainability report
- etc.
Alternative data representation formats for Supply Chain Due Diligence
Detailed schema definitions and relationships between entities are provided in the /BatteryPass directory.
For the compilation of the data model schema, the Eclipse Semantic Modeling Framework was used, that provides a meta model for data modelling for data exchange purpose that build upon the Resource Description Framework (RDF) and its compact textual syntax called Turtle (*.ttl). In each sub model schema folder you'll find the corresponding Turtle file and a ./gen folder that includes several derivations of the data model in differnet formats:
- JSON-Schema (
*-schema.json) - JSON-Payload(
*-payload.json) - OpenAPI Specification (
*_openapi3_0.json) - Asset Administration Shell XML (
*.xml) - Documentation (
*-documentation.html) - etc.
An example of the concrete implementation of a battery passport system based on that data model could be found here: https://thebatterypass.io/
The architectural structure of the software demonstrator and the implementation concepts behind the implementation are published in the Battery Passport Technical Guidance. The rationale for the usage of RDF and the Semantic Modelling Framework can be found in chapter 4.9 of this document.
Contributing
We welcome contributions to the Battery Pass Data Model. To contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Make your changes.
- Commit your changes (
git commit -m 'Add new feature'). - Push to the branch (
git push origin feature-branch). - Create a pull request.
Please ensure that your contributions adhere to the project's coding standards and guidelines.
Disclaimer
The battery pass data model is still in draft mode and not finished yet. The purpose of this publication is to initiate further technical alignment with other relevant stakeholders. The data model schemas are for demonstration purposes only. Therefore, none of the project partners can be held liable for any errors or omissions in the data model schemas provided, and no representation or warranty, express or implied, is made as to the accuracy, adequacy, completeness, legality, reliability or usefulness of the data model. The data model is subject to change without notice.
License
This work is made available under Creative Commons Attribution 4.0 International (CC-BY-4.0) license. See the LICENSE file for more details.
Contact
For questions, feedback, or support, please contact:
- Project website: Battery Passport Project website
- Project work package maintainer: Niko D'Agostino, Circulor GmbH, WP4 lead Battery Pass project software demonstrator
- GitHub Issues: Submit an Issue
- Follow us on LinkedIn
Thank you for using the Battery Pass Data Model! We look forward to your contributions and feedback.
This Battery Pass project receives funding from the German Federal Ministry for Economic Affairs and Climate Action by resolution of the German Bundestag under grant agreement No BZF335.
Owner metadata
- Name: batterypass
- Login: batterypass
- Email:
- Kind: organization
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/143512932?v=4
- Repositories: 1
- Last ynced at: 2024-07-25T11:07:11.179Z
- Profile URL: https://github.com/batterypass
GitHub Events
Total
- Delete event: 3
- Pull request event: 7
- Fork event: 5
- Issues event: 19
- Watch event: 27
- Issue comment event: 21
- Push event: 28
- Create event: 1
Last Year
- Delete event: 3
- Pull request event: 5
- Fork event: 1
- Issues event: 15
- Watch event: 10
- Issue comment event: 14
- Push event: 7
- Create event: 1
Committers metadata
Last synced: 4 days ago
Total Commits: 65
Total Committers: 3
Avg Commits per committer: 21.667
Development Distribution Score (DDS): 0.123
Commits in past year: 19
Committers in past year: 2
Avg Commits per committer in past year: 9.5
Development Distribution Score (DDS) in past year: 0.263
| Name | Commits | |
|---|---|---|
| Nikolai D'Agostino | nd@c****m | 57 |
| Birgit Boss | B****s@d****m | 5 |
| Jason Fox | j****x | 3 |
Committer domains:
- de.bosch.com: 1
- circulor.com: 1
Issue and Pull Request metadata
Last synced: 6 days ago
Total issues: 20
Total pull requests: 4
Average time to close issues: 5 days
Average time to close pull requests: 1 day
Total issue authors: 11
Total pull request authors: 2
Average comments per issue: 0.2
Average comments per pull request: 0.0
Merged pull request: 2
Bot issues: 0
Bot pull requests: 0
Past year issues: 10
Past year pull requests: 2
Past year average time to close issues: 8 days
Past year average time to close pull requests: less than a minute
Past year issue authors: 6
Past year pull request authors: 1
Past year average comments per issue: 0.3
Past year average comments per pull request: 0.0
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- miwamasa (6)
- BirgitBoss (5)
- SebastianSchildt (1)
- albertoabellagarcia (1)
- morandd (1)
- VladimirAlexiev (1)
- jli2972 (1)
- absoludity (1)
- nidhivyas-deftbox (1)
- basasy (1)
- GeiserX (1)
Top Pull Request Authors
- nd-circulor (2)
- jason-fox (2)
Top Issue Labels
Top Pull Request Labels
Score: 5.41610040220442