ODS-E: Open Data Schema for Energy
Schema
v0.4.0
|
Python
v0.4.0
|
License
CC-BY-SA 4.0 / Apache 2.0
Get Started in 5 Minutes
Standardize energy data from any OEM — generation, consumption, and net metering
Install
Quick Links
Code Examples
Copy-paste examples to get started quickly
Transform OEM Data
from odse import transform
# Huawei CSV to ODS-E records
rows = transform("huawei_export.csv", source="huawei")
print(rows[0])
# {"timestamp": "2026-02-09T12:00:00Z",
# "kWh": 4.17, "error_type": "normal"}
View Full Example →
Validate Consumption Data
from odse import validate
result = validate({
"timestamp": "2026-02-09T14:00:00Z",
"kWh": 12.3,
"error_type": "normal",
"direction": "consumption",
"end_use": "cooling",
"fuel_type": "electricity"
})
print(result.is_valid) # True
View Validation Guide →
What ODS-E Covers
Generation
Solar, wind, CHP — 10 OEM transforms included
Consumption
Grid meters, sub-meters, end-use tagging
Net Metering
Bidirectional flows with signed kWh
Asset Taxonomy
10 asset types from solar PV to fuel cells
Building Metadata
ComStock/ResStock-compatible fields
Validation
Schema + semantic + physical bounds
Supported OEMs
Huawei, Enphase, Solarman, SolarEdge, Fronius, Switch, SMA, FIMER, Solis, SolaX
View Support Matrix →What's New in v0.4.0
- Market context extension fields for settlement parties, tariff context, and municipal/grid topology
- Runtime enrichment helper (`odse.enrich`) for post-transform context injection
- SA market reform extension coverage: wheeling, tariff components, curtailment, BRP/imbalance, municipal reconciliation, certificates, and grid capacity lifecycle
- Conformance profile validation support for trading and settlement workflows
- Municipal emissions modeling guide and implementation workflows
Documentation Sections
Trading Integration
Settlement, wheeling, tariffs, curtailment, BRP, and municipal reconciliation
View Guide →Building Integration
Join ODS-E data to NREL ComStock/ResStock benchmarks for EUI analysis
View Guide →Community & Support
© 2026 Open Data Schema for Energy. All rights reserved. ODS-E specification licensed under CC-BY-SA 4.0.