EnergyDataModel

Modules

Use Cases

Community

Docs

Get started

EnergyDataModel
The Pythonic data model for distributed energy systems
The Pythonic data model for distributed energy systems
Create and structure energy system representations in pure Python for improved modularity and readability. Full JSON-compatability.
Create and structure energy system representations in pure Python for improved modularity and readability. Full JSON-compatability.

Try now in Colab

Try now in Colab

Documentation

Documentation

0

stars

Give us a ⭐

Give us a ⭐

Input
import energydatamodel as edm

pvsystem = edm.PVSystem(name="PVSystem",
                        capacity=2400,
                        surface_azimuth=180,
                        surface_tilt=25)

battery = edm.Battery(name="Battery",
                      storage_capacity=1000,
                      min_soc=150,
                      max_charge=500,
                      max_discharge=500)

site = edm.Site(name="MySite",
                assets=[pvsystem, battery],
                latitude=46, 
                longitude=64)

portfolio = edm.Portfolio(name="MyPortfolio",
                          sites=[site])
Diagram
Tree
JSON
portfolio.to_diagram()
Input
Tree
Diagram
JSON
import energydatamodel as edm

pvsystem = edm.PVSystem(name="PVSystem",
                        capacity=2400,
                        surface_azimuth=180,
                        surface_tilt=25)

battery = edm.Battery(name="Battery",
                      storage_capacity=1000,
                      min_soc=150,
                      max_charge=500,
                      max_discharge=500)

site = edm.Site(name="MySite",
                assets=[pvsystem, battery],
                latitude=46, 
                longitude=64)

portfolio = edm.Portfolio(name="MyPortfolio",
                          sites=[site])
Input
Tree
Diagram
JSON
import energydatamodel as edm

pvsystem = edm.PVSystem(name="PVSystem",
                        capacity=2400,
                        surface_azimuth=180,
                        surface_tilt=25)

battery = edm.Battery(name="Battery",
                      storage_capacity=1000,
                      min_soc=150,
                      max_charge=500,
                      max_discharge=500)

site = edm.Site(name="MySite",
                assets=[pvsystem, battery],
                latitude=46, 
                longitude=64)

portfolio = edm.Portfolio(name="MyPortfolio",
                          sites=[site])

Modules

Modules

Modules and Data Classes

EnergyDataModel gives you atomic building blocks that enables to build up intuitive representations of real-world energy assets with expressive notation. Readability counts.

Check out the docs

Check out the docs

Battery

Battery

Module to represent batteries with capacity and charging constraints.

View code

View code

Docs

Docs

Solar

SolarPowerArea

PVArray

PVSystem

FixedMount

SingleAxisTrackerMount

Module to represent solar modules and arrays. Compatible with pvlib.

View code

View code

View code

Docs

Docs

Docs

Wind

WindTurbine

WindFarm

WindPowerArea

Module to represent wind turbines and wind farms. Compatible with windpowerlib and PyWake.

View code

View code

View code

Docs

Docs

Docs

Heat Pump

Heatpump

Module to represent heat pumps and heat exchangers. Compatible with tespy.

View code

View code

View code

Docs

Docs

Docs

Hydro

HydroTurbine

HydroPowerPlant

Reservoir

RiverSection

CatchmentArea

Module to represent hydropower plants and systems. Compatible with shyft.

View code

View code

View code

Docs

Docs

Docs

Power Grid

Bus

Carrier

Line

Link

Network

SubNetwork

Transformer

Represent both high- and low-voltage power grids. Compatible with PyPSA and pandapower.

View code

View code

View code

Docs

Docs

Docs

Time Series

TimeSeries

TimeSeriesTable

Module to represent time series data together with metadata. Compatible with pandas.

View code

View code

View code

Docs

Docs

Docs

Geospatial

GeoLocation

GeoLine

GeoPolygon

GeoGraph

+3

Module to represent geospatial objects. Compatible with shapley and GeoJSON.

View code

View code

View code

Docs

Docs

Docs

And more

And more

And more

Use Cases

Use Cases

Use Cases

Serialise to JSON and store in PostgreSQL

The edm-postgresql project provides a schema to convieniently store data structures created with EnergyDataModel in a PostgreSQL database.

Visualise energy assets on map

The Rebase Map project uses EnergyDataModel to represent and display energy asset metadata with a geospatial visualisation.

Create reproducible energy modelling experiments with enflow

enflow is an open-source energy sequential modelling framework that uses EnergyDataModel to produce more readable and reproducible experiments.

Advantages

Advantages

Advantages

Supercharge your energy modelling workflow

EnergyDataModel provides an open-source, Python-based data model that enables energy data scientists and modellers to write more modular and readable code.

Modularity

Represent energy assets, energy systems and other relevant concepts as object-oriented building blocks.

Modularity

Represent energy assets, energy systems and other relevant concepts as object-oriented building blocks.

Modularity

Represent energy assets, energy systems and other relevant concepts as object-oriented building blocks.

Relationships

Structure your energy assets in graphs and hierarchies representing energy systems that can be serialized to files (e.g. .csv, .json, and .geojson files).

Relationships

Structure your energy assets in graphs and hierarchies representing energy systems that can be serialized to files (e.g. .csv, .json, and .geojson files).

Relationships

Structure your energy assets in graphs and hierarchies representing energy systems that can be serialized to files (e.g. .csv, .json, and .geojson files).

Visualization

Visualise energy systems maps, graphs, flows and structure using built-in plotting functions.

Visualization

Visualise energy systems maps, graphs, flows and structure using built-in plotting functions.

Visualization

Visualise energy systems maps, graphs, flows and structure using built-in plotting functions.

Readability

Write more explicit Python code through human-readable expressions and built-in convenience methods.

Readability

Write more explicit Python code through human-readable expressions and built-in convenience methods.

Readability

Write more explicit Python code through human-readable expressions and built-in convenience methods.

Interoperability

Convert data format to other energy-relevant data models and ontologies.

Interoperability

Convert data format to other energy-relevant data models and ontologies.

Interoperability

Convert data format to other energy-relevant data models and ontologies.

Communication

Communicate effectively in teams with a common energy system data vocabulary.

Communication

Communicate effectively in teams with a common energy system data vocabulary.

Communication

Communicate effectively in teams with a common energy system data vocabulary.

Interoperability

Interoperability

Interoperability

Integrates with the ecosystem

Join Beta

Join Beta

Join Beta

Become a pioneer

We are looking for a handful of motivated energy data scientists, modellers and researchers who want to work closely together with us to create the future of open-source energy modelling tools. Are you interested in becoming a Pioneer? Let us know!

Join our Beta

Join our Beta

Join our Beta

Developed with

❤️

and

☕

by

© 2025 rebase.energy. All rights reserved.

Developed with

❤️

and

☕

by

© 2025 rebase.energy. All rights reserved.

Developed with

❤️

and

☕

by

© 2025 rebase.energy. All rights reserved.