ODS-E: Open Data Schema for Energy
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, BESS, SCADA — 17 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, Higeco, Sungrow, Sungrow BESS, BYD, Vestas, Siemens Gamesa, Nordex, Terraco, IEC 62056 Meter
View Support Matrix →What's New in v0.11.0
- Per-phase electrical fields (
voltage_ac_l1/l2/l3,current_ac_l1/l2/l3) for distribution-grid unbalance analysis (SEP-049, SEP-051) - Strict schema conformance harness — Draft 2020-12 validation of transformer output in CI, plus non-fatal
UNKNOWN_FIELDwarnings fromvalidate() - IEC 62056 (OBIS) billing-meter transform (
iec62056_meter) — cumulative registers to interval deltas, import/export directions, multipliers (SEP-052) - pvlib adapter realigned to canonical keys with legacy input aliases retained under a deprecation grace period (SEP-050)
- 17 OEM transforms supported across solar, wind, BESS, billing meters, and SCADA historians
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.