GitHub

Area

A geographical Area consist of a location and a connection to a local energy system via a specialized Availability node called GeoAvailability. The specialized Availability node is required to modify the energy/mass balance to allow for imports and exports. Constraints related to the area keep track of a resource's export and import to the local system and exchange with other areas. Multiple dispatch is used on the Area type for imposing specific constraints. Hence, other restrictions can be applied on a area level, such as electricity generation reserves, CO₂ emission limits or resource limits (wind power, natural gas etc.).

Area types

The following types are inmplemented:

EnergyModelsGeography.RefArea — Type
RefArea <: Area

A RefArea is an area representation with no additional constraints on energy/mass exchange.

Fields

  • id is the name/identifier of the area.
  • name is the name of the area.
  • lon::Real is the longitudinal position of the area.
  • lat::Real is the latitudinal position of the area.
  • node::Availability is the Availability node routing different resources within an area.
source
EnergyModelsGeography.LimitedExchangeArea — Type
LimitedExchangeArea <: Area

A LimitedExchangeArea is an area in which the export is limited in each individual operational period for the provided resources. This can be necessary when an area is coupled with multiple other areas and the total export capacity should be restricted.

Fields

  • id is the name/identifier of the area.
  • name is the name of the area.
  • lon::Real is the longitudinal position of the area.
  • lat::Real is the latitudinal position of the area.
  • node::Availability is the Availability node routing different resources within an area.
  • limit::Dict{<:EMB.Resource, <:TimeProfile} is the amount of a resource that can be exchanged with other areas.
source
EnergyModelsGeography.GeoAvailability — Type
GeoAvailability <: EMB.Availability

A geography Availability node for substituion of the general GenAvailability node. A GeoAvailability is required if transmission should be included between individual Areas due to a changed mass balance.

Fields

  • id is the name/identifier of the node.
  • inputs::Vector{<:Resource} are the input Resources.
  • output::Vector{<:Resource} are the output Resources.
source

Functions for accessing fields of Area types

The following functions are defined for accessing fields from an Area:

EnergyModelsGeography.exchange_limit — Function
exchange_limit(a::LimitedExchangeArea)
exchange_limit(a::LimitedExchangeArea, p::Resource)
exchange_limit(a::LimitedExchangeArea, p::Resource, t)

Returns the limits of the exchange resources in area a as dictionary, the value of resource p as TimeProfile, or the value of resource p in operational period t.

If the resource p is not included, the function returns either a FixedProfile(0) or a value of 0.

source

Utility functions for Area types

EnergyModelsGeography.getnodesinarea — Function
getnodesinarea(a::Area, links)

Return a vector with all the nodes connected to the central availability node of an area.

Arguments

  • a::Area.

  • links is a vector of all links in the model.

source
EnergyModelsGeography.nodes_in_area — Function
nodes_in_area(a::Area, ℒ::Vector{<:Link}; n_nodes=1000)

Returns a vector of all nodes in area a connected through links ℒ. The approach is based on a breadth-first-search and provides all connected nodes, contrary to the function getnodesinarea.

Arguments

  • a::Area is area that should be evaluated
  • ℒ::Vector{<:Link} is a vector of links that should be evaluated.

Keyword arguments

  • n_nodes=1000 the number of nodes added after which the loop is broken. It must be at least equal to the number of nodes in the area a.
source