REMIND - REgional Model of INvestments and Development

3.7.0

created with goxygen 1.5.0

Trade module (24_trade)

Description

This file loads the trade module realization.

Interfaces

Interface plot missing!

Input

module inputs (A: capacity | B: se_trade | C: standard)
  Description Unit A B C
cm_emiscen policy scenario choice x x x
cm_phaseoutBiolc Switch that allows for a full phaseout of all bioenergy technologies globally x x x
cm_startyear first optimized modelling time step \(year\) x x x
cm_tradecostBio choose financial tradecosts multiplier for biomass (purpose grown pebiolc) x x x
pm_EN_demand_from_initialcap2
(all_regi, all_enty)
PE demand resulting from the initialcap routine. \(EJ, Uranium: MT U3O8\) x x x
pm_PEPrice
(ttot, all_regi, all_enty)
parameter to capture all PE prices \(tr\$2017/TWa\) x
pm_SEPrice
(ttot, all_regi, all_enty)
parameter to capture all SE prices \(tr\$2017/TWa\) x
pm_data
(all_regi, char, all_te)
Large array for most technical parameters of technologies, more detail on the individual technical parameters and their units can be found in the declaration of the set ‘char’ x
pm_ffPolyCumEx
(all_regi, all_enty, char)
Minimum / maximum cumulative extraction (condition to activate rent / upper bound on v31_fuExtrCum for oil, gas and coal) x x x
pm_fuelex_cum
(tall, all_regi, all_enty, rlf)
(Output) cumulated extraction. Unit: x x x
pm_gdp
(tall, all_regi)
GDP MER data \(trn US\$ 2005\) x
pm_omeg
(all_regi, opTimeYr, all_te)
technical depreciation parameter, gives the share of a capacity that is still usable after technical life time. \(none/share, value between 0 and 1\) x
pm_prodFEReference
(ttot, all_regi, all_enty, all_enty, all_te)
Final Energy output of a technology in the reference run \(TWa\) x
pm_prodIni
(all_regi, all_enty)
(Preloop) regional amount of primary energy that has to be produced according to 1.1*initial demand. Unit: x x x
pm_specFeDem
(tall, all_regi, all_enty, all_te, opmoPrc)
Actual specific final-energy demand of a tech; blends between IEA data and Target \(TWa/Gt_output\) x
pm_ts
(tall)
(t_n+1 - t_n-1)/2 for a timestep t_n x x
pm_tsu2opTimeYr
(ttot, opTimeYr)
auxiliary parameter to map time steps to past time steps: counts the number of model timesteps between years ttot-opTimeYr and ttot, used for q_transPe2se and q_cap equations \(unitless\) x
pm_ttot_val
(ttot)
value of ttot set element x
sm_EJ_2_TWa convert from Exa Joule to Tera Watt annum x x x
sm_GJ_2_TWa convert from Giga Joule to Tera Watt annum x
sm_TWa_2_TWh convert Tera Watt annum to Tera Wh x
sm_TWa_2_kWh convert Tera Watt annum to kilo Wh x
sm_h2kg_2_h2kWh convert kg of hydrogen to kWh energy value x
sm_trillion_2_non trillion to non x
vm_outflowPrc
(tall, all_regi, all_te, opmoPrc)
Production volume of processes in process-based model \(Gt/a\) x

Output

module outputs
  Description Unit
pm_IO_trade
(tall, all_regi, all_enty, char)
Energy trade bounds based on IEA data.
pm_MPortsPrice
(tall, all_regi, all_enty)
Secondary energy import price for region (only used in se_trade realisation).
pm_XPortsPrice
(tall, all_regi, all_enty)
Export price for region (capacity realisation). Calculated in the postsolve and corresponding to the region secondary energy price \(T\$/TWa\)
pm_Xport0
(tall, all_regi, all_enty)
Reference level value of export.
pm_costsPEtradeMp
(all_regi, all_enty)
PE tradecosts (energy losses on import)
pm_costsTradePeFinancial
(all_regi, char, all_enty)
PE tradecosts (financial costs on import, export and use)
pm_tradecostgood
(all_regi)
Trade costs (final good).
vm_Mport
(tall, all_regi, all_enty)
Import of traded commodity.
vm_Xport
(tall, all_regi, all_enty)
Export of traded commodity.
vm_capacityTradeBalance
(tall, all_regi)
Capacity trade balance term
vm_costTradeCap
(tall, all_regi, all_enty)
Trade technology and transportation cost

Realizations

(A) capacity

Limitations There are no known limitations.

(B) se_trade

Limitations There are no known limitations.

(C) standard

Imports constrained by demand side of import country

\[\begin{multline*} vm\_Mport(t,regi,enty) \geq p24\_trade\_constraints(regi,enty,tradeConst) \cdot \sum_{secInd37\_tePrc("steel",tePrc), tePrc2opmoPrc(tePrc,opmoPrc)}\left( pm\_specFeDem(t,regi,"fesos",tePrc,opmoPrc) \cdot vm\_outflowPrc(t,regi,tePrc,opmoPrc) \right) \end{multline*}\]

Limitations There are no known limitations.

Definitions

Objects

module-internal objects (A: capacity | B: se_trade | C: standard)
  Description Unit A B C
p24_FEregiShareInRegiGroup
(ttot, ext_regi, all_regi, seAgg)
Region share of total final energy demand per carrier (seAgg) within the region group (ext_regi) \(\%\) x
p24_Mport2005correct
(all_regi, all_enty)
Correction factor to match fossil supply and internal region energy demand in the initial year x x x
p24_Mport_iter
(iteration, ttot, all_regi, all_enty)
Iterative values of vm_Mport for diagnostics. x
p24_MportsRegi
(tall, all_regi, all_regi, all_enty)
Mports to regi from regi2, assuming that trade is distributed uniformetly according existent capacities defined at p24_seTradeCapacity \(TWa\) x
p24_XPortsPrice_iter
(iteration, ttot, all_regi, all_enty)
Iterative values of pm_XPortsPrice for diagnostics. x
p24_Xport
(ttot, all_regi, all_enty)
Export of traded commodity. x
p24_Xport_iter
(iteration, ttot, all_regi, all_enty)
Iterative values of vm_Xport for diagnostics. x
p24_XportsRegi
(tall, all_regi, all_regi, all_enty)
Exports from regi to regi2. Defined in the postsolve as a result of p24_MportsRegi calculation \(TWa\) x
p24_aviationAndChemicalsFE
(ttot, all_regi)
Final energy of aviation and chemicals liquids demand \(TWa\) x
p24_aviationAndChemicalsFEShareInRegion
(ttot, ext_regi, all_regi)
Region share of total final energy aviation and chemicals liquids demand within the region group (ext_regi) \(\%\) x
p24_capTrade_iter
(iteration, ttot, all_regi, all_regi, teTrade)
Iterative values of v24_capTrade for diagnostics. x
p24_cap_absMaxGrowthRate
(teTrade)
Absolute maximum yearly growth rate for trade transportation capacity (TWa) x
p24_cap_relMaxGrowthRate
(teTrade)
Relative maximum yearly growth rate for trade transportation capacity (percent) x
p24_demFeForEsReference
(ttot, all_regi, all_enty, all_esty, all_teEs)
Final energy which will be used in the ES layer in the reference run \(TWa\) x
p24_demFeIndSubReference
(ttot, all_regi, all_enty, all_enty, secInd37, all_emiMkt)
Final energy demand per industry subsector, FE carrier, SE carrier, emissions market in the reference run \(TWa\) x
p24_disallowed
(all_regi, all_regi, tradeModes)
Trade routes that are explicitly disallowed. x
p24_distance
(all_regi, all_regi)
Distance between regions (in units of 1000km) x
p24_seAggReference
(ttot, all_regi, seAgg)
Secondary energy per carrier (seAgg) in the reference run \(TWa\) x
p24_seTradeCapacity
(tall, all_regi, all_regi, all_enty)
Secondary energy international yearly trade capacity potential from regi to regi2 \(TWa\) x
p24_seTrade_Quantity
(all_regi, all_regi, all_enty)
Maximum import quantity in import scenarios with fixed quantities \(TWa\) x
p24_trade_constraints
(all_regi, all_enty, tradeConst)
parameter for the region specific trade constraints, values different to 1 activate constraints and the value is used as effectiveness to varying degress such as percentage numbers x
p24_trade_exog
(ttot, ttot, ext_regi, ext_regi, all_enty)
parameter to define exogenous SE trade trajectories \(EJ/yr\) x
p24_trade_iter
(iteration, ttot, all_regi, all_regi, tradeModes)
Iterative values of v24_trade for diagnostics. x
q24_capTrade
(ttot, all_regi, all_regi, teTrade)
Trade transportation capacities from deltaCap. x
q24_costTradeCap
(ttot, all_regi, tradeCap)
Trade technology and transportation cost x
q24_limitCapTradeBilat
(ttot, all_regi, all_regi, teTrade)
Trade is limited by capacity for pipelines. x
q24_limitCapTradeMport
(ttot, all_regi, teTrade)
Trade is limited by capacity for Mport terminals. x
q24_limitCapTradeXport
(ttot, all_regi, teTrade)
Trade is limited by capacity for Xport terminals. x
q24_limitDeltaCap
(ttot, all_regi, all_regi, teTrade)
Limit deltaCap. x
q24_peimport_demandside
(tall, all_regi, all_enty, tradeConst)
Constraint on imports due to domestic requirements x
q24_tradeBalanceTerms
(ttot, all_regi)
Capacity trade balance term x
q24_tradeFromMports
(ttot, all_regi, tradeCap)
Total imports of each region must equal the demanded imports x
s24_switchTradeModel Switch to activate trade model eqns before trade solve and to deactivate them during main solve x
v24_capEarlyRetiTrade
(tall, all_regi, all_regi, teTrade)
Early retired capacity x
v24_capTrade
(tall, all_regi, all_regi, teTrade)
Net total capacities for transportation x
v24_deltaCapTrade
(tall, all_regi, all_regi, teTrade)
Capacity additions for transportation x
v24_trade
(tall, all_regi, all_regi, tradeModes)
Shipment quantities for different transportation modes x

Sets

sets in use
  description
all_emiMkt emission markets
all_enty all types of quantities
all_esty energy services
all_regi all regions
all_te all energy technologies, including from modules
all_teEs energy service technologies
char characteristics of technologies
enty(all_enty) all types of quantities
entyFe(all_enty) final energy types.
entyFe2Sector(all_enty, emi_sectors) final energy (stationary and transportation) mapping to sectors (industry, buildings, transportation and cdr)
entySe(all_enty) secondary energy types
ext_regi extended regions list (includes subsets of H12 regions)
iteration iterator for main (Negishi/Nash) iterations
opTimeYr actual lifetime of a built technology in years
opTimeYr2te(all_te, opTimeYr) map each technology with its possible age
opmoPrc Operation modes for technologies in process-based model
peFos(all_enty) primary energy fossil fuels
regi(all_regi) all regions used in the solution process
regi_group(ext_regi, all_regi) region groups (regions that together corresponds to a H12 region)
regi_groupExt(ext_regi, all_regi) extended region group mapping. Mapping model regions that belong to region group, including one to one region mapping
rlf cost levels of fossil fuels
se2fe(all_enty, all_enty, all_te) map secondary energy to end-use energy using a technology
seAgg(all_enty) secondary energy aggregations
seAgg2se(all_enty, all_enty) map secondary energy aggregation to SE
secInd37 industry sub-sectors
secInd37_tePrc(secInd37, tePrc) Mapping of technologies onto industry subsectors
sector2emiMkt(emi_sectors, all_emiMkt) mapping sectors to emission markets
sefe(all_enty, all_enty) map secondary energy to final energy
t(ttot) optimisation time, years between cm_startyear and 2150 with 5 to 20 years time steps
t0(tall) start of modelling time, not optimization
tall time index, each year from 1900 to 3000
te(all_te) energy technologies
tePrc(all_te) Technologies used in process-based model (including CCS)
tePrc2opmoPrc(tePrc, opmoPrc) Mapping of technologies onto available operation modes
teTrade(all_te) Technologies used for trading goods.
teTradeBilat(teTrade) Technologies used for trading that are installed bilaterally, i.e. in between two regions (e.g. pipelines).
teTradeMport(teTrade) Technologies used for trading that are installed in the importing region only (e.g. regasification terminals).
teTradeXport(teTrade) Technologies used for trading that are installed in the exporting region only (e.g. liquification terminals).
trade(all_enty) All traded commodities
tradeCap(all_enty) Commodities traded via capacity mode.
tradeConst set to distinguish import constraints
tradeEnty2Mode(all_enty, tradeModes) Mapping of traded commodities onto the possible trade modes.
tradeMacro(all_enty) Traded macro-economic commodities
tradeMode2te(tradeModes, teTrade) Mapping of trade modes onto the required technologies.
tradeModes Modes of trade, i.e. ways in which a commodity can be transported between regions.
tradePe(all_enty) Traded primary energy commodities
tradeSe(all_enty) Traded secondary energy commodities
tsu2opTimeYr(ttot, opTimeYr) map each model timestep with the possible age of technologies
ttot(tall) time index with spin-up, years between 1900 and 2150 with 5 to 20 years time steps

See Also

01_macro, 04_PE_FE_parameters, 05_initialCap, 21_tax, 23_capitalMarket, 30_biomass, 31_fossil, 32_power, 37_industry, 41_emicapregi, 80_optimization, core

References