Model Documentation

| Version 2.1.0

created with goxygen 0.29.0

05_initialCap

Initial Capacities (05_initialCap)

Description

This modules initialises the vintage stocks of all energy convertion technologies.

Interfaces

Interfaces to other modules
Interfaces to other modules

Input

module inputs (A: on)
  Description Unit A
fm_dataglob
(char, all_te)
energy technology characteristics: investment costs, O&M costs, efficiency, learning rates … x
pm_cesdata
(tall, all_regi, all_in, cesParameter)
parameters of the CES function x
pm_cf
(tall, all_regi, all_te)
Installed capacity availability - capacity factor (fraction of the year that a plant is running) 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_dataeta
(tall, all_regi, all_te)
regional eta data x
pm_dataren
(all_regi, char, rlf, all_te)
Array including both regional renewable potential and capacity factor x
pm_dt
(tall)
difference to last timestep x
pm_emifac
(tall, all_regi, all_enty, all_enty, all_te, all_enty)
emission factor by technology for all types of emissions in emiTe x
pm_EN_demand_from_initialcap2
(all_regi, all_enty)
PE demand resulting from the initialcap routine. \(EJ, Uranium: MT U3O8\) x
pm_eta_conv
(tall, all_regi, all_te)
Time-dependent eta for technologies that do not have explicit time-dependant etas, still eta converges until 2050 to dataglob_values. \(efficiency (0..1)\) x
pm_fe2es
(tall, all_regi, all_teEs)
Conversion factor from final energies to energy services. Default is 1. x
pm_gdp
(tall, all_regi)
GDP data \(trn US\$ 2005\) x
pm_inco0_t
(ttot, all_regi, all_te)
New inco0 that is time-dependent for some technologies. \(T\$/TW\) 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_pedem_res
(ttot, all_regi, all_te)
Demand for pebiolc residues, needed for enhancement of residue potential \(TWa\) x
pm_pop
(tall, all_regi)
population data \(bn people\) x
pm_prodCouple
(all_regi, all_enty, all_enty, all_te, all_enty)
own consumption x
pm_shFeCes
(ttot, all_regi, all_enty, all_in, all_teEs)
Final energy shares for CES nodes x
pm_ts
(tall)
(t_n+1 - t_n-1)/2 for a timestep t_n x
pm_tsu2opTimeYr
(ttot, opTimeYr)
parameter that counts opTimeYr regarding tsu2opTimeYr apping x
pm_vintage_in
(all_regi, opTimeYr, all_te)
historical vintage structure. \(arbitrary\) x
sm_tmp temporary scalar that can be used locally x
vm_deltaCap
(tall, all_regi, all_te, rlf)
capacity additions x
vm_prodSe
(tall, all_regi, all_enty, all_enty, all_te)
se production. \(TWa\) x

Output

module outputs
  Description Unit
pm_aux_capLowerLimit
(all_te, all_regi, tall)
auxiliary calculation parameter for the calculation of the lowest possible capacities in the first time steps
pm_cap0
(all_regi, all_te)
standing capacity in 2005 as calculated by the initialization routine generisinical. Unit: TWa

Realizations

(A) on

This realisation computes the initial capital stocks using a constrained non-linear model that ensures the production from capacities satisfies external and internal (energy system own-consumption) demand for all energy carriers (primary, secondary, and final) in the first time step \(t_0\).

Capacity additions up to \(t_0\) are assigned according to the historic vintage structure such that discounted vintages equal the calculated capcaity in \(t_0\).

Conversion technology efficiencies (\(\eta\)) are adjusted to fit the calibration of initial capacities. This is equired since time-variant \(\eta\) values follow the same trajectory for all regions, but the base-year calibration results in regionally different values.

Upper bounds for emissions are calculated based on the Kyoto targets and \(t_0\) emissions (fossil fuel consumption times emission factors).

This realisation computes the initial capital stocks using a constrained non-linear model that ensures the production from capacities satisfies external and internal (energy system own-consumption) demand for all energy carriers (primary, secondary, and final) in the first time step \(t_0\).

Capacity additions up to \(t_0\) are assigned according to the historic vintage structure such that discounted vintages equal the calculated capcaity in \(t_0\).

Conversion technology efficiencies (\(\eta\)) are adjusted to fit the calibration of initial capacities. This is equired since time-variant \(\eta\) values follow the same trajectory for all regions, but the base-year calibration results in regionally different values.

Upper bounds for emissions are calculated based on the Kyoto targets and \(t_0\) emissions (fossil fuel consumption times emission factors).

\[\begin{multline*} v05\_INIdemEn0(regi,enty) = \sum_{fe2ppfEn(enty,in)}\left( pm\_cesdata("2005",regi,in,"quantity") +pm\_cesdata("2005",regi,in,"offset\_quantity")\right) \cdot s05\_inic\_switch + \sum_{ue2ppfen(enty,in)}\left( pm\_cesdata("2005",regi,in,"quantity") +pm\_cesdata("2005",regi,in,"offset\_quantity")\right) \cdot s05\_inic\_switch + \sum_{feViaEs2ppfen(enty,in,teEs)}\left( pm\_shFeCes("2005",regi,enty,in,teEs) \cdot \frac{ \left(pm\_cesdata("2005",regi,in,"quantity") + pm\_cesdata("2005",regi,in,"offset\_quantity")\right) }{ \left(\sum_{fe2es(enty2,esty,teEs2)\$es2ppfen(esty,in)}\left( pm\_fe2es\left("2005", regi, teEs2\right) \cdot pm\_shFeCes("2005",regi,enty2,in,teEs2)\right)\right) }\right) \cdot s05\_inic\_switch + \sum_{en2en(enty,enty2,te)}\left(\frac{ 1}{pm\_data(regi,"eta",te) } \cdot pm\_cf("2005",regi,te) \cdot v05\_INIcap0(regi,te) \right) - \sum_{pc2te(enty3,enty4,te2,enty)}\left( pm\_prodCouple(regi,enty3,enty4,te2,enty) \cdot pm\_cf("2005",regi,te2) \cdot v05\_INIcap0(regi,te2) \right) \end{multline*}\]

\[\begin{multline*} pm\_cf("2005",regi,te) \cdot pm\_dataren(regi,"nur","1",te) \cdot v05\_INIcap0(regi,te) = pm\_data(regi,"mix0",te) \cdot v05\_INIdemEn0(regi,enty2) \end{multline*}\]

This realisation computes the initial capital stocks using a constrained non-linear model that ensures the production from capacities satisfies external and internal (energy system own-consumption) demand for all energy carriers (primary, secondary, and final) in the first time step \(t_0\).

Capacity additions up to \(t_0\) are assigned according to the historic vintage structure such that discounted vintages equal the calculated capcaity in \(t_0\).

Conversion technology efficiencies (\(\eta\)) are adjusted to fit the calibration of initial capacities. This is equired since time-variant \(\eta\) values follow the same trajectory for all regions, but the base-year calibration results in regionally different values.

Upper bounds for emissions are calculated based on the Kyoto targets and \(t_0\) emissions (fossil fuel consumption times emission factors).

Limitations There are no known limitations.

Definitions

Objects

module-internal objects (A: on)
  Description Unit A
p05_aux_calccapLowerLimitSwitch
(tall)
auxiliary calculation parameter to allow the calculation of the lowest possible capacities in the first time steps x
p05_aux_cap
(all_regi, all_te)
auxiliary calculation parameter for the calculation of initial capacities x
p05_aux_cap_distr
(all_regi, all_te, rlf)
auxiliary calculation parameter for the calculation of initial capacities, distributed to grades x
p05_aux_prod_thisgrade
(rlf)
auxiliary calculation parameter for the capacities in different grades: production in this grade x
p05_aux_vintage_renormalization
(all_regi, all_te)
needed auxiliary parameter for renormalization x
p05_cap_res
(tall, all_regi, all_te)
caps of technologies that demand pebiolc residues, needed for enhancement of residue potential x
p05_corrected_inital_eta
(all_regi, all_te)
corrected initial eta for technologies with time-variable etas, calculated from past deltacaps, with external IEA calibration x
p05_corrected_inital_input
(all_regi, all_te)
corrected input in 2005, calculated from past deltacaps and corrected time-variable eta x
p05_deltacap_res
(tall, all_regi, all_te)
deltacaps of technologies that demand pebiolc residues, needed for enhancement of residue potential x
p05_emi2005_from_initialcap2
(all_regi, emiTe)
regional energy emissions 2005 resulting from the initialcap routine. Unit: GtC x
p05_eta_correct_factor
(all_regi, all_te)
correction factor for time-variable etas to adapt the generisdataeta to external IEA calibration x
p05_inital_eta
(all_regi, all_te)
initial eta for technologies with time-variable etas, calculated from past deltacaps x
p05_inital_input
(all_regi, all_te)
input in 2005, calculated from past deltacaps and initial time-variable eta x
p05_inital_output
(all_regi, all_te)
initial vm_prodSe production of technolgy te x
p05_initial_capacity
(all_regi, all_te)
capacitiy at t=2005, calculated from past deltacaps x
p05_vintage
(all_regi, opTimeYr, all_te)
historical vintage structure. Unit: arbitrary but renormalized to give a sum eq 1 when multiplied with corresponding pm_omeg x
q05_ccapini
(all_regi, all_enty, all_enty, all_te)
calculation of initial capacity x
q05_eedemini
(all_regi, all_enty)
calculation of initial energy demand x
s05_aux_prod_remaining auxiliary calculation parameter for the capacities in different grades: production that still has to be distributed to a grade x
s05_aux_tot_prod auxiliary calculation parameter for the capacities in different grades: total production as resulting from initialcap2 x
s05_inic_switch switch for turning off ESM calibration routine equations during optimization x
v05_INIcap0
(all_regi, all_te)
initial capacity x
v05_INIdemEn0
(all_regi, all_enty)
initial energy demand - this is NOT total energy demand, but the sum of all transformation pathways that demand energy minus the co-produced amount x

Sets

sets in use
  description
all_enty all types of quantities
all_in all inputs and outputs of the CES function
all_regi all regions
all_te all energy technologies, including from modules
all_teEs energy service technologies
cesParameter parameters of the CES functions and for calibration
char characteristics of technologies
emiTe(all_enty) types of climate-relevant energy emissions for climate coupling and reporting
en2en(all_enty, all_enty, all_te) all energy conversion mappings
enty(all_enty) all types of quantities
entyPe(all_enty) Primary energy types (PE)
entySe(all_enty) secondary energy types
es2ppfen(all_esty, all_in) matching ES in ESM to ppfEn in MACRO
esty(all_esty) energy service types. Have to be added by modules.
fe2es(all_enty, all_esty, all_teEs) map FE carriers to ES via ES technologies
fe2ppfEn(all_enty, all_in) mapping between CES FE variables and ESM FE variables
feViaEs2ppfen(all_enty, all_in, all_teEs) map final energies to the primar production factor - is filled automatically from the content of fe2es and es2ppfen
in(all_in) All inputs and outputs of the CES function
modules all the available modules
opTime5(opTimeYr) actual life time of ??? in years - 5 years time steps for the past to calculate vintages (???)
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
pc2te(all_enty, all_enty, all_te, all_enty) mapping for own consumption of technologies
pe2se(all_enty, all_enty, all_te) map primary energy carriers to secondary
regi(all_regi) all regions used in the solution process
rlf cost levels of fossil fuels
se2fe(all_enty, all_enty, all_te) map secondary energy to end-use energy using a technology
steps iterator for MAC steps
t(ttot) modeling time, usually starting in 2005, but later for fixed delay runs
tall time index
te(all_te) energy technologies
te2rlf(all_te, rlf) all technologies to grades
teBioPebiolc(all_te) biomass technologies using pebiolc
teEs(all_teEs) ES technologies which are actually used (to be filled by module realizations).
teEtaConst(all_te) Technologies with constant eta
teEtaIncr(all_te) Technologies with time variable efficiency parameter eta
teRe2rlfDetail(all_te, rlf) mapping for se techologies to grades
teReNoBio(all_te) renewable technologies except for biomass
teSe2rlf(all_te, rlf) mapping for techologies to grades. Currently, the information was shifted to teRe2rlfDetail. Thus, teSe2rlf now only has ‘1’ for the rlf values
tsu(ttot) spin up-time before 2005
tsu2opTime5(tall, opTimeYr) mapping for spinup time index to lifetime index
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
ue2ppfen(all_enty, all_in) matching UE in ESM to ppfEn in MACRO

Authors

Robert Pietzcker

See Also

04_PE_FE_parameters, 32_power, core

References