Trade between regions#
TIMES states the efficiency of a trade flow as IRE_FLO(REG,V,P,COM,R,C,TS):
an export from region REG and commodity COM arrives in region R as
commodity C. The parameter names the region twice and the commodity twice,
which TIMES writes with a second name for each set, ALIAS(REG,R) in
initsys.mod.
A workaround
mathspec refuses an entry over one dimension twice. This spec declares a
dimension trade_link, whose labels the data invents, one per link, and
the maps of trade_link give each link its two regions and two
commodities. Nothing refuses two labels for the same link. Issue
#969 (gap 1) and
#1019 track the
designs that would state IRE_FLO over the regions and commodities
themselves.
The vintage, the process and the timeslice of IRE_FLO are left out, so the
spec shows only the two ends of each link.
description: >-
Trade between regions from TIMES: IRE_FLO, the efficiency of a flow from one
region and commodity to another, with each link a label of its own.
dimensions:
region: { description: a region of the model }
commodity: { description: an energy carrier or a material }
trade_link: { description: "one link from a region and commodity to another, a label the data invents" }
maps:
trade_link: # the region and commodity at each end of a link
from_commodity: { dim: commodity }
from_region: { dim: region }
to_commodity: { dim: commodity }
to_region: { dim: region }
parameters:
ire_flo: { dims: [trade_link], description: the share of an export that arrives as an import (IRE_FLO) }
demand: { dims: [commodity, region], description: what a region needs of a commodity }
supply_cost: { dims: [commodity, region], description: the cost of a unit produced in a region }
trade_cost: { dims: [trade_link], description: the cost of a unit exported along a link }
variables:
supply: { dims: [commodity, region], bounds: { lower: 0 }, description: what a region produces of a commodity }
export: { dims: [trade_link], bounds: { lower: 0 }, description: what leaves along a link (VAR_IRE) }
constraints:
balance:
description: production and imports less exports meet the demand of each region and commodity
dims: [commodity, region]
expression: >-
supply
+ sum(ire_flo * export, over=trade_link, by=trade_link[to_commodity, to_region])
- sum(export, over=trade_link, by=trade_link[from_commodity, from_region])
>= demand
objective:
sense: minimize
expression: sum(supply_cost * supply) + sum(trade_cost * export)
Trade between regions from TIMES: IRE_FLO, the efficiency of a flow from one region and commodity to another, with each link a label of its own.
Sets#
| Symbol | Meaning |
|---|---|
| \(\mathcal{C}\) | index \(c\) — commodity with \(\mathrm{from\_commodity}: \mathcal{L} \to \mathcal{C},\ \mathrm{to\_commodity}: \mathcal{L} \to \mathcal{C}\) — an energy carrier or a material |
| \(\mathcal{R}\) | index \(r\) — region with \(\mathrm{from\_region}: \mathcal{L} \to \mathcal{R},\ \mathrm{to\_region}: \mathcal{L} \to \mathcal{R}\) — a region of the model |
| \(\mathcal{L}\) | index \(l\) — trade_link with \(\mathrm{from\_commodity}: \mathcal{L} \to \mathcal{C},\ \mathrm{from\_region}: \mathcal{L} \to \mathcal{R},\ \mathrm{to\_commodity}: \mathcal{L} \to \mathcal{C},\ \mathrm{to\_region}: \mathcal{L} \to \mathcal{R}\) — one link from a region and commodity to another, a label the data invents |
Parameters#
| Symbol | Meaning |
|---|---|
| \(\mathrm{demand}\) | demand over \(\mathcal{C} \times \mathcal{R}\) — what a region needs of a commodity |
| \(\mathrm{ire\_flo}\) | ire_flo over \(\mathcal{L}\) — the share of an export that arrives as an import (IRE_FLO) |
| \(\mathrm{supply}^{\mathrm{cost}}\) | supply_cost over \(\mathcal{C} \times \mathcal{R}\) — the cost of a unit produced in a region |
| \(\mathrm{trade\_cost}\) | trade_cost over \(\mathcal{L}\) — the cost of a unit exported along a link |
Variables#
| Symbol | Meaning |
|---|---|
| \(\mathit{export}\) | export over \(\mathcal{L}\) — what leaves along a link (VAR_IRE) |
| \(\mathit{supply}\) | supply over \(\mathcal{C} \times \mathcal{R}\) — what a region produces of a commodity |
Variable domains#
export
supply
Objective#
Subject to#
balance