Source code for calliope.backend.pyomo.constraints.policy

"""
Copyright (C) since 2013 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

ORDER = 10  # order in which to invoke constraints relative to other constraint files


def load_constraints(backend_model):
    sets = backend_model.__calliope_model_data["sets"]
    run_config = backend_model.__calliope_run_config

    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 run_config["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 group_share_energy_cap_constraint_rule(backend_model, techlist, what): """ Enforce shares in energy_cap for groups of technologies. Applied to ``supply`` and ``supply_plus`` technologies only. .. container:: scrolling-wrapper .. math:: \\sum_{loc::tech \\in given\\_group} energy_{cap}(loc::tech) = fraction \\times \\sum_{loc::tech \\in loc\\_techs\\_supply \\or loc\\_techs\\_supply\\_plus} energy_{cap}(loc::tech) """ model_data_dict = backend_model.__calliope_model_data["data"] sets = backend_model.__calliope_model_data["sets"] fraction = model_data_dict["group_share_energy_cap_{}".format(what)][techlist] if "loc_techs_supply_plus" in sets: rhs_loc_techs = ( backend_model.loc_techs_supply | backend_model.loc_techs_supply_plus ) lhs_loc_techs = [ i for i in backend_model.loc_techs_supply | backend_model.loc_techs_supply_plus if i.split("::")[1] in techlist.split(",") ] else: rhs_loc_techs = backend_model.loc_techs_supply lhs_loc_techs = [ i for i in backend_model.loc_techs_supply if i.split("::")[1] in techlist.split(",") ] rhs = fraction * sum( backend_model.energy_cap[loc_tech] for loc_tech in rhs_loc_techs ) lhs = sum(backend_model.energy_cap[loc_tech] for loc_tech in lhs_loc_techs) return equalizer(lhs, rhs, what)
[docs]def group_share_carrier_prod_constraint_rule(backend_model, techlist_carrier, what): """ Enforce shares in carrier_prod for groups of technologies. Applied to ``loc_tech_carriers_supply_conversion_all``, which includes supply, supply_plus, conversion, and conversion_plus. .. container:: scrolling-wrapper .. math:: \\sum_{loc::tech::carrier \\in given\\_group, timestep \\in timesteps} carrier_{prod}(loc::tech::carrier, timestep) = fraction \\times \\sum_{loc::tech:carrier \\in loc\\_tech\\_carriers\\_supply\\_all, timestep\\in timesteps} carrier_{prod}(loc::tech::carrier, timestep) """ model_data_dict = backend_model.__calliope_model_data["data"] techlist, carrier = techlist_carrier.split("::") fraction = model_data_dict["group_share_carrier_prod_{}".format(what)][ (carrier, techlist) ] rhs_loc_tech_carriers = [ i for i in backend_model.loc_tech_carriers_supply_conversion_all if i.split("::")[-1] == carrier ] lhs_loc_tech_carriers = [ i for i in backend_model.loc_tech_carriers_supply_conversion_all if i.split("::")[1] in techlist.split(",") and i.split("::")[-1] == carrier ] rhs = fraction * sum( backend_model.carrier_prod[loc_tech_carrier, timestep] for loc_tech_carrier in rhs_loc_tech_carriers for timestep in backend_model.timesteps ) lhs = sum( backend_model.carrier_prod[loc_tech_carrier, timestep] for loc_tech_carrier in lhs_loc_tech_carriers for timestep in backend_model.timesteps ) return equalizer(lhs, rhs, what)
[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_conversion_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 )