Dispatching A Single Asset with the Asset API
The asset API allows optimizing a single asset at once. Below we show how to use each asset in isolation with asset.optimize.
Battery
Dispatch an electric battery operating in wholesale price arbitrage using epl.Battery:
import energypylinear as epl
# 2.0 MW, 4.0 MWh battery
asset = epl.battery.Battery(power_mw=2, capacity_mwh=4, efficiency=0.9)
results = asset.optimize(
electricity_prices=[100.0, 50, 200, -100, 0, 200, 100, -100],
freq_mins=60,
initial_charge_mwh=1,
final_charge_mwh=3
)
assert all(
results.simulation.columns == [
'site-import_power_mwh',
'site-export_power_mwh',
'spill-electric_generation_mwh',
'spill-electric_load_mwh',
'spill-high_temperature_generation_mwh',
'spill-low_temperature_generation_mwh',
'spill-high_temperature_load_mwh',
'spill-low_temperature_load_mwh',
'spill-gas_consumption_mwh',
'spill-charge_mwh',
'spill-discharge_mwh',
'battery-charge_mwh',
'battery-charge_binary',
'battery-discharge_mwh',
'battery-discharge_binary',
'battery-losses_mwh',
'battery-initial_charge_mwh',
'battery-final_charge_mwh',
'electricity_prices',
'electricity_carbon_intensities',
'total-electric_generation_mwh',
'total-electric_load_mwh',
'total-high_temperature_generation_mwh',
'total-low_temperature_generation_mwh',
'total-high_temperature_load_mwh',
'total-low_temperature_load_mwh',
'total-gas_consumption_mwh',
'total-charge_mwh',
'total-discharge_mwh',
'total-spills_mwh',
'total-losses_mwh',
'site-electricity_balance_mwh',
'load-high_temperature_load_mwh',
'load-low_temperature_load_mwh'
]
)
The battery will charge with electricity at low prices, and discharge at high prices. An efficiency penalty is applied to the battery charge energy (energy is lost during charging).
Generator
Dispatch a CHP (combined heat & power) generator to generate electricity, high & low temperature heat from natural gas.
The epl.Generator model can be configured with electric, high and low temperature thermal efficiencies.
This allows modelling both gas engines and gas turbines.
When optimizing, we can use interval data for the high and low temperature loads. These thermal loads will be met by gas boilers if the CHP chooses not to generate, or cannot meet thermal demands. High temperature heat can be let-down into low temperature heat.
The epl.Generator is allowed to dump both high temperature and low temperature heat.
The high and low temperature heat demands are supplied alongside the electricity prices when optimizing:
import energypylinear as epl
# 100 MWe gas turbine
asset = epl.chp.Generator(
electric_power_max_mw=100,
electric_power_min_mw=50,
electric_efficiency_pct=0.3,
high_temperature_efficiency_pct=0.5,
)
# 100 MWe gas engine
asset = epl.chp.Generator(
electric_power_max_mw=100,
electric_power_min_mw=10,
electric_efficiency_pct=0.4,
high_temperature_efficiency_pct=0.2,
low_temperature_efficiency_pct=0.2,
)
results = asset.optimize(
electricity_prices=[100, 50, 200, -100, 0, 200, 100, -100],
high_temperature_load_mwh=[100, 50, 200, 40, 0, 200, 100, 100],
low_temperature_load_mwh=20
)
assert all(
results.simulation.columns == [
'site-import_power_mwh',
'site-export_power_mwh',
'spill-electric_generation_mwh',
'spill-electric_load_mwh',
'spill-high_temperature_generation_mwh',
'spill-low_temperature_generation_mwh',
'spill-high_temperature_load_mwh',
'spill-low_temperature_load_mwh',
'spill-gas_consumption_mwh',
'spill-charge_mwh',
'spill-discharge_mwh',
'generator-electric_generation_mwh',
'generator-gas_consumption_mwh',
'generator-high_temperature_generation_mwh',
'generator-low_temperature_generation_mwh',
'boiler-high_temperature_generation_mwh',
'boiler-gas_consumption_mwh',
'valve-high_temperature_load_mwh',
'valve-low_temperature_generation_mwh',
'electricity_prices',
'electricity_carbon_intensities',
'total-electric_generation_mwh',
'total-electric_load_mwh',
'total-high_temperature_generation_mwh',
'total-low_temperature_generation_mwh',
'total-high_temperature_load_mwh',
'total-low_temperature_load_mwh',
'total-gas_consumption_mwh',
'total-charge_mwh',
'total-discharge_mwh',
'total-spills_mwh',
'total-losses_mwh',
'site-electricity_balance_mwh',
'load-high_temperature_load_mwh',
'load-low_temperature_load_mwh'
]
)
Electric Vehicle Charging
Control a number of EV chargers to charge a number of charge events.
Chargers are configured by their size given in charger_mws.
A charge_event is a time interval where an EV can be charged. This is given as a boolean 2D array, with one binary digit for each charge events, interval pairs.
Each charge event has a required amount of electricity charge_event_mwh, that can be delivered when the charge_event is 1. The model is constrained so that each charge event receives all of it's charge_event_mwh.
To optimize two 100 MWe chargers for 4 charge events over 5 intervals:
import energypylinear as epl
# 2 100 MW EV chargers
asset = epl.evs.EVs(charger_mws=[100, 100], charger_turndown=0.1)
electricity_prices = [-100, 50, 30, 50, 40]
charge_events = [
[1, 0, 0, 0, 0],
[0, 1, 1, 1, 0],
[0, 0, 0, 1, 1],
[0, 1, 0, 0, 0],
]
charge_event_mwh = [50, 100, 30, 40]
results = asset.optimize(
electricity_prices=electricity_prices,
charge_events=charge_events,
charge_event_mwh=charge_event_mwh,
)
assert all(
results.simulation.columns == [
'site-import_power_mwh',
'site-export_power_mwh',
'spill-electric_generation_mwh',
'spill-electric_load_mwh',
'spill-high_temperature_generation_mwh',
'spill-low_temperature_generation_mwh',
'spill-high_temperature_load_mwh',
'spill-low_temperature_load_mwh',
'spill-gas_consumption_mwh',
'spill-charge_mwh',
'spill-discharge_mwh',
'charger-0-charge_mwh',
'charger-0-charge_binary',
'charger-1-charge_mwh',
'charger-1-charge_binary',
'charge-event-0-charge_mwh',
'charge-event-1-charge_mwh',
'charge-event-2-charge_mwh',
'charge-event-3-charge_mwh',
'charger-spill-charge_mwh',
'charger-spill-charge_binary',
'spill-charge-event-0-charge_mwh',
'spill-charge-event-1-charge_mwh',
'spill-charge-event-2-charge_mwh',
'spill-charge-event-3-charge_mwh',
'charge-event-0-total-charge_mwh',
'charge-event-1-total-charge_mwh',
'charge-event-2-total-charge_mwh',
'charge-event-3-total-charge_mwh',
'electricity_prices',
'electricity_carbon_intensities',
'total-electric_generation_mwh',
'total-electric_load_mwh',
'total-high_temperature_generation_mwh',
'total-low_temperature_generation_mwh',
'total-high_temperature_load_mwh',
'total-low_temperature_load_mwh',
'total-gas_consumption_mwh',
'total-charge_mwh',
'total-discharge_mwh',
'total-spills_mwh',
'total-losses_mwh',
'site-electricity_balance_mwh',
'load-high_temperature_load_mwh',
'load-low_temperature_load_mwh'
]
)