Annual energy balance

Description

Limit or set the total (e.g. annual) outflow of a technology to a specified absolute value.

New technology-level parameters:

• annual_flow_max
• annual_source_max

New indexed parameters:

• annual_flow_max (if summing over technologies and/or nodes)

New indexed lookups:

• flow_max_group (if summing over technologies and/or nodes)

Helper functions used:

• sum (expression)

YAML definition

Download the YAML example

parameters:
  annual_flow_max:
    description: Annual maximum outflow
    default: .inf
    unit: energy

  annual_source_max:
    description: Annual maximum source use
    default: .inf
    unit: energy

  annual_sink_max:
    description: Annual maximum sink use
    default: .inf
    unit: energy

lookups:
  flow_max_group:
    description: Technology group slice
    dtype: bool
    default: false

constraints:
  annual_energy_balance_per_tech_and_node:
    description: >
      Limit total technology annual energy production at each possible
      deployment site.
    foreach: [nodes, techs]
    where: annual_flow_max
    equations:
      - expression: >
          sum(flow_out, over=[carriers, timesteps]) <= annual_flow_max

  annual_energy_balance_global_per_tech:
    description: >
      Limit total technology annual energy production across all possible
      deployment sites.
    foreach: [techs]
    where: annual_flow_max
    equations:
      - expression: >
         sum(flow_out, over=[nodes, carriers, timesteps]) <= annual_flow_max

  annual_energy_balance_global_multi_tech:
    description: >
      Limit total combined technology annual energy production across all
      possible deployment sites.
    # To slice a model component with a list of values,
    # we need to use referenced `slices`.
    where: annual_flow_max AND flow_max_group
    equations:
      - expression: >
          sum(flow_out[techs=$techs], over=[nodes, techs, carriers, timesteps])
          <= annual_flow_max
    slices:
      techs:
        - expression: flow_max_group

  annual_energy_balance_total_source_availability:
    description: Limit total flow into the system from a particular source.
    foreach: [techs]
    where: source_use AND annual_source_max
    equations:
      - expression: >
          sum(source_use, over=[nodes, timesteps]) <= annual_source_max

  annual_energy_balance_total_sink_availability:
    description: >
      Limit total flow out of the system into a sink that is not pinned
      by `sink_use_equals`.
    foreach: [techs]
    where: base_tech==demand AND annual_sink_max
    equations:
      - expression: >
          sum(flow_in, over=[nodes, carriers, timesteps]) <= annual_sink_max