Source code for calliope.backend.pyomo.constraints.policy
"""
Copyright (C) 2013-2018 Calliope contributors listed in AUTHORS.
Licensed under the Apache 2.0 License (see LICENSE file).
policy.py
~~~~~~~~~
Policy constraints.
"""
import pyomo.core as po # pylint: disable=import-error
def load_constraints(backend_model):
sets = backend_model.__calliope_model_data__['sets']
if 'techlists_group_share_energy_cap_min_constraint' in sets:
backend_model.group_share_energy_cap_min_constraint = po.Constraint(
backend_model.techlists_group_share_energy_cap_min_constraint,
['min'], rule=group_share_energy_cap_constraint_rule
)
if 'techlists_group_share_energy_cap_max_constraint' in sets:
backend_model.group_share_energy_cap_max_constraint = po.Constraint(
backend_model.techlists_group_share_energy_cap_max_constraint,
['max'], rule=group_share_energy_cap_constraint_rule
)
if 'techlists_group_share_energy_cap_equals_constraint' in sets:
backend_model.group_share_energy_cap_equals_constraint = po.Constraint(
backend_model.techlists_group_share_energy_cap_equals_constraint,
['equals'], rule=group_share_energy_cap_constraint_rule
)
if 'techlists_carrier_group_share_carrier_prod_min_constraint' in sets:
backend_model.group_share_carrier_prod_min_constraint = po.Constraint(
backend_model.techlists_carrier_group_share_carrier_prod_min_constraint,
['min'], rule=group_share_carrier_prod_constraint_rule
)
if 'techlists_carrier_group_share_carrier_prod_max_constraint' in sets:
backend_model.group_share_carrier_prod_max_constraint = po.Constraint(
backend_model.techlists_carrier_group_share_carrier_prod_max_constraint,
['max'], rule=group_share_carrier_prod_constraint_rule
)
if 'techlists_carrier_group_share_carrier_prod_equals_constraint' in sets:
backend_model.group_share_carrier_prod_equals_constraint = po.Constraint(
backend_model.techlists_carrier_group_share_carrier_prod_equals_constraint,
['equals'], rule=group_share_carrier_prod_constraint_rule
)
if 'carriers_reserve_margin_constraint' in sets and backend_model.mode != 'operate':
backend_model.reserve_margin_constraint = po.Constraint(
backend_model.carriers_reserve_margin_constraint,
rule=reserve_margin_constraint_rule
)
def equalizer(lhs, rhs, sign):
if sign == 'max':
return lhs <= rhs
elif sign == 'min':
return lhs >= rhs
elif sign == 'equals':
return lhs == rhs
else:
raise ValueError('Invalid sign: {}'.format(sign))
# FIXME: docstring should show all variants: \geq, =, and \leq
[docs]def reserve_margin_constraint_rule(backend_model, carrier):
"""
Enforces a system reserve margin per carrier.
.. container:: scrolling-wrapper
.. math::
\\sum_{loc::tech::carrier \\in loc\\_tech\\_carriers\\_supply\\_all} energy_{cap}(loc::tech::carrier, timestep_{max\\_demand})
\\geq
\\sum_{loc::tech::carrier \\in loc\\_tech\\_carriers\\_demand} carrier_{con}(loc::tech::carrier, timestep_{max\\_demand})
\\times -1 \\times \\frac{1}{time\\_resolution_{max\\_demand}}
\\times (1 + reserve\\_margin)
"""
model_data_dict = backend_model.__calliope_model_data__['data']
reserve_margin = model_data_dict['reserve_margin'][carrier]
max_demand_timestep = model_data_dict['max_demand_timesteps'][carrier]
max_demand_time_res = backend_model.timestep_resolution[max_demand_timestep]
return (
sum( # Sum all supply capacity for this carrier
backend_model.energy_cap[loc_tech_carrier.rsplit('::', 1)[0]]
for loc_tech_carrier in backend_model.loc_tech_carriers_supply_all
if loc_tech_carrier.split('::')[-1] == carrier
)
>=
sum( # Sum all demand for this carrier and timestep
backend_model.carrier_con[loc_tech_carrier, max_demand_timestep]
for loc_tech_carrier in backend_model.loc_tech_carriers_demand
if loc_tech_carrier.split('::')[-1] == carrier
) * -1 * (1 / max_demand_time_res) * (1 + reserve_margin)
)