Open Data Schema for Energy
Get Started in 5 Minutes

Standardize energy data from any OEM — generation, consumption, and net metering

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

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_FIELD warnings from validate()
  • 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
Read Changelog →

Documentation Sections

Learn

Understand what ODS-E is, why it exists, and how the architecture works

Start Learning →

Build

Quickstart, tutorials, CLI walkthrough, and integration guides

Get Started →

Patterns

Copy-paste pipeline recipes for common workflows

View Patterns →

Reference

Schema specs, Python SDK, and validation rule details

View Reference →

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 →

Contributing

Add OEM transforms, improve schemas, and submit pull requests

Contribute →

Community & Support

© 2026 Open Data Schema for Energy. All rights reserved. ODS-E specification licensed under CC-BY-SA 4.0.