REMIND - REgional Model of INvestments and Development

3.4.0

created with goxygen 1.4.4

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_data
(all_regi, char, all_te)
Large array for most technical parameters of technologies; more detail on the individual technical parameters can be found in the declaration of the set ‘char’ 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_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 data \(trn US\$ 2005\) x
pm_omeg (all_regiopTimeYrall_te) technical depreciation parameter, gives the share of a capacity that is still usable after tlt. \(none/share, value between 0 and 1\) x
pm_PEPrice
(ttot, all_regi, all_enty)
parameter to capture all PE prices \(tr\$2005/TWa\) x
pm_prodFEReference
(ttot, all_regi, all_enty, all_enty, all_te)
Final Energy output of a te 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_SEPrice
(ttot, all_regi, all_enty)
parameter to capture all SE prices \(tr\$2005/TWa\) 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)
parameter that counts opTimeYr regarding tsu2opTimeYr apping x
pm_ttot_val
(ttot)
value of ttot set element x
sm_EJ_2_TWa multiplicative factor to convert from EJ to TWa x x x
sm_GJ_2_TWa multiplicative factor to convert from GJ to TWa x
sm_h2kg_2_h2kWh convert kilogramme of hydrogen to kwh energy value. x
sm_trillion_2_non trillion to non x
sm_TWa_2_kWh tera Watt year to kilo Watt hour x
sm_TWa_2_TWh tera Watt year to Tera Watt hour 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_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_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_tradecostgood
(all_regi)
Trade costs (final good).
pm_Xport0
(tall, all_regi, all_enty)
Reference level value of export.
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\)
vm_capacityTradeBalance
(tall, all_regi)
Capacity trade balance term
vm_costTradeCap
(tall, all_regi, all_enty)
Trade technology and transportation cost
vm_Mport
(tall, all_regi, all_enty)
Import of traded commodity.
vm_Xport
(tall, all_regi, all_enty)
Export of traded commodity.

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_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_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_capTrade_iter
(iteration, ttot, all_regi, all_regi, teTrade)
Iterative values of v24_capTrade for diagnostics. 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_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_Mport_iter
(iteration, ttot, all_regi, all_enty)
Iterative values of vm_Mport for diagnostics. 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_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_seAggReference
(ttot, all_regi, seAgg)
Secondary energy per carrier (seAgg) in the reference run \(TWa\) x
p24_seTrade_Quantity
(all_regi, all_regi, all_enty)
Maximum import quantity in import scenarios with fixed quantities \(TWa\) x
p24_seTradeCapacity
(tall, all_regi, all_regi, all_enty)
Secondary energy international yearly trade capacity potential from regi to regi2 \(TWa\) x 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
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_XPortsPrice_iter
(iteration, ttot, all_regi, all_enty)
Iterative values of pm_XPortsPrice 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
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)
in(all_in) All inputs and outputs of the CES function
iteration iterator for main (Negishi/Nash) iterations
modules all the available modules
opmoPrc Operation modes for technologies in process-based model
opTimeYr actual life time of ??? in years
opTimeYr2te(all_te, opTimeYr) mapping for technologies to yearly lifetime - is filled automatically in generisdata.inc from the lifetime values in generisdata_tech.prn
peFos(all_enty) primary energy fossil fuels
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
regi(all_regi) all regions used in the solution process
rlf cost levels of fossil fuels
run iterator for performance test iterations
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) mapping for opTimeYr to the used time ttot - will be filled automatically in generisdata.inc
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, 21_tax, 23_capitalMarket, 30_biomass, 31_fossil, 32_power, 37_industry, 41_emicapregi, 80_optimization, core

References