Documentation For The TIMES Model-Part-IV
Documentation For The TIMES Model-Part-IV
http://iea-etsap.org/index.php/documentation
Authors: G. Goldstein
M. Gargiulo
A. Kanudia
i
General Introduction
This documentation is composed of four Parts.
Part I provides a general description of the TIMES paradigm, with emphasis on the model’s
general structure and its economic significance. Part I also includes a simplified mathematical
formulation of TIMES, a chapter comparing it to the MARKAL model, pointing to
similarities and differences, and chapters describing new model options.
Part II constitutes a comprehensive reference manual intended for the technically minded
modeler or programmer looking for an in-depth understanding of the complete model details,
in particular the relationship between the input data and the model mathematics, or
contemplating making changes to the model’s equations. Part II includes a full description of
the sets, attributes, variables, and equations of the TIMES model.
Part III describes the organization of the TIMES modeling environment and the GAMS
control statements required to run the TIMES model. GAMS is a modeling language that
translates a TIMES database into the Linear Programming matrix, and then submits this LP to
an optimizer and generates the result files. Part III describes how the routines comprising the
TIMES source code guide the model through compilation, execution, solve, and reporting; the
files produced by the run process and their use; and the various switches that control the
execution of the TIMES code according to the model instance, formulation options, and run
options selected by the user. It also includes a section on identifying and resolving errors that
may occur during the run process.
ii
PART IV: VEDA2.01 Model
Management System - Getting Started
with the VEDA-TIMES Demo Models
1
Veda [Sanskrit,=knowledge, cognate with English wit, from a root meaning know], oldest scriptures of Hinduism and the most
ancient religious texts in an Indo-European language. The authority of the Veda as stating the essential truths of Hinduism is still
accepted to some extent by all Hindus. The Veda is the literature of the Aryans who invaded NW India c.1500 B.C. and pertains to
the fire sacrifice that constituted their religion. The Vedic hymns were probably first compiled after a period of about 500 years during
which the invaders assimilated various native religious ideas. The end of the Vedic period is about 500 B.C. Tradition ascribes the
authorship of the hymns to inspired seer-poets (rishis). [The Columbia Encyclopedia, 6th ed. New York: Columbia University Press,
2000. ]
iii
TABLE OF CONTENTS FOR PART IV
1 OVERVIEW .......................................................................................................... 1
1.1 Downloading and Registering VEDA2.0 ................................................................................................ 1
1.2 Obtaining and Setting Up GAMS for TIMES ........................................................................................2
1.3 Downloading and Setting Up the DemoS Models ..................................................................................3
iv
3.1.2.5 Defaults sheet ............................................................................................................................. 45
3.1.3 SETS template ................................................................................................................................ 45
3.1.4 B-Y Template.................................................................................................................................. 45
3.1.4.1 RES&OBJ sheet ......................................................................................................................... 46
3.1.4.2 EnergyBalance sheet .................................................................................................................. 46
3.1.4.3 Pri_COA ..................................................................................................................................... 47
3.1.4.4 DemTechs_TPS.......................................................................................................................... 48
3.1.4.5 Demands..................................................................................................................................... 49
3.1.5 Solving the Model ........................................................................................................................... 49
3.1.6 Analysis via Results Module ........................................................................................................... 50
3.2 DemoS_002 - More Demand Options and Multiple Supply Curves................................................... 55
3.2.1 B-Y Templates ................................................................................................................................ 56
3.2.1.1 EnergyBalance sheet .................................................................................................................. 56
3.2.1.2 Pri_COA/GAS/OIL sheets ......................................................................................................... 57
3.2.1.3 Sector_Fuels sheet ...................................................................................................................... 57
3.2.1.4 DemTechs_RSD and DemTechs_TRA sheets ........................................................................... 57
3.2.1.5 Demands sheet ........................................................................................................................... 58
3.2.2 Results ............................................................................................................................................. 58
3.3 DemoS_003 - Power Sector: Basics ....................................................................................................... 62
3.3.1 SysSettings file ................................................................................................................................ 63
3.3.1.1 TimePeriods sheet ...................................................................................................................... 63
3.3.1.2 Constants sheet ........................................................................................................................... 63
3.3.2 B-Y Templates ................................................................................................................................ 63
3.3.2.1 EnergyBalance sheet .................................................................................................................. 63
3.3.2.2 Pri_COA/GAS/OIL sheets ......................................................................................................... 64
3.3.2.3 Pri_RNW and Pri_NUC sheets .................................................................................................. 65
3.3.2.4 Sector_Fuels sheet ...................................................................................................................... 66
3.3.2.5 Con_ELC sheet .......................................................................................................................... 66
3.3.2.6 DemTechs_ELC sheet ................................................................................................................ 67
3.3.2.7 Demands..................................................................................................................................... 67
3.3.3 Results ............................................................................................................................................. 68
3.4 DemoS_004 - Power sector: sophistication ........................................................................................... 70
3.4.1 SysSettings file ................................................................................................................................ 71
3.4.1.1 Region-Time Slices .................................................................................................................... 71
3.4.1.2 Interpol_Extrapol_Defaults ........................................................................................................ 72
3.4.1.3 Constants .................................................................................................................................... 72
3.4.2 B-Y Templates ................................................................................................................................ 72
3.4.2.1 Con_ELC.................................................................................................................................... 72
3.4.2.2 Pri_COA/GAS/OIL .................................................................................................................... 74
3.4.2.3 Demands..................................................................................................................................... 74
3.4.3 Scenario files ................................................................................................................................... 75
3.4.3.1 Scen_Peak_RSV and Scen_Peak_RSV-FLX ............................................................................. 75
3.4.4 Results ............................................................................................................................................. 76
3.5 DemoS_005 - 2-region Model with Endogenous Trade (compact approach) .................................... 78
3.5.1 SysSettings file ................................................................................................................................ 79
3.5.1.1 Region-Time Slices .................................................................................................................... 79
3.5.2 B-Y Templates ................................................................................................................................ 80
3.5.2.1 EnergyBalance, EB1, EB2 ......................................................................................................... 80
3.5.2.2 Pri_COA/GAS/OIL .................................................................................................................... 81
3.5.2.3 Con_ELC.................................................................................................................................... 81
3.5.3 Trade files ....................................................................................................................................... 82
3.5.3.1 Scen_Trade_Links ...................................................................................................................... 82
3.5.3.2 Scen_Trade_Param..................................................................................................................... 82
3.5.4 Scenario files ................................................................................................................................... 83
v
3.5.4.1 Scen_ELC_CO2_Bound ............................................................................................................ 83
3.5.4.2 Scen_UCCO2_BND – user constraint ....................................................................................... 83
3.5.5 Results ............................................................................................................................................. 84
3.6 DemoS_006 - Multi-region with Separate Regional Templates .......................................................... 88
3.6.1 SysSettings file ................................................................................................................................ 89
3.6.1.1 Region-Time Slices .................................................................................................................... 89
3.6.2 B-Y Templates ................................................................................................................................ 89
3.6.3 SubRES_NewTechs ........................................................................................................................ 89
3.6.3.1 SubRES_NewTechs_Trans ........................................................................................................ 90
3.6.4 Results ............................................................................................................................................. 90
3.7 DemoS_007 – Making DemoS More Robust ........................................................................................ 91
3.7.1 SysSettings file ................................................................................................................................ 93
3.7.1.1 Interpol_Extrapol_Defaults ........................................................................................................ 93
3.7.2 B-Y Templates ................................................................................................................................ 93
3.7.2.1 EnergyBalance ........................................................................................................................... 93
3.7.2.2 Con_REF – primary commodity group definition ..................................................................... 94
3.7.2.3 Pri_PP......................................................................................................................................... 95
3.7.2.4 Sector_Fuels ............................................................................................................................... 96
3.7.2.5 DemTechs_TRA......................................................................................................................... 96
3.7.2.6 Demands..................................................................................................................................... 97
3.7.2.7 Emi ............................................................................................................................................. 98
3.7.3 SubRES_NewTechs ........................................................................................................................ 98
3.7.3.1 PRI_TRA.................................................................................................................................... 98
3.7.4 Scenario files ................................................................................................................................... 98
3.7.4.1 Scen_DemProj_DTCAR ............................................................................................................ 98
3.7.4.2 Scen_Refinery ............................................................................................................................ 99
3.7.4.3 Scen_TRA_CO2_BOUND ........................................................................................................ 99
3.7.4.4 Scen_UC Growth ..................................................................................................................... 100
3.7.4.5 Scen_ElasticDem ..................................................................................................................... 100
3.7.5 Results ........................................................................................................................................... 102
3.8 DemoS_008 - Split Base-Year (B-Y) templates by sector: demands by sector ................................ 106
3.8.1 SysSettings file .............................................................................................................................. 107
3.8.1.1 TimePeriods ............................................................................................................................. 107
3.8.1.2 Defaults .................................................................................................................................... 108
3.8.2 B-Y Template VT_REG*_PRI_V08 ............................................................................................ 108
3.8.2.1 EnergyBalance ......................................................................................................................... 108
3.8.2.2 Pri_COA, Pri_GAS, Pri_OIL, Pri_PP, Con_REF .................................................................... 109
3.8.2.3 Pri_RNW and Pri_NUC ........................................................................................................... 109
3.8.2.4 Pri_ELC.................................................................................................................................... 109
3.8.3 B-Y Template VT_REG*_ELC_V08 ........................................................................................... 109
3.8.3.1 Con_ELC.................................................................................................................................. 109
3.8.3.2 Emi ........................................................................................................................................... 110
3.8.4 BY Template VT_REG*_IND_V08 ............................................................................................. 110
3.8.4.1 DemTechs_IND ....................................................................................................................... 110
3.8.4.2 Emi ........................................................................................................................................... 110
3.8.5 BY Template VT_REG*_RCA_V08 ............................................................................................ 111
3.8.5.1 DemTechs_AGR ...................................................................................................................... 111
3.8.5.2 DemTechs_RSD and DemTechs_COM ................................................................................... 111
3.8.5.3 Demands................................................................................................................................... 111
3.8.5.4 Emi ........................................................................................................................................... 112
3.8.6 BY Template VT_REG*_TRA_V08 ............................................................................................ 112
3.8.6.1 DemTechs_TRA....................................................................................................................... 112
3.8.6.2 Demands................................................................................................................................... 113
3.8.6.3 Emi ........................................................................................................................................... 113
vi
3.8.7 SubRES_NewTechs ...................................................................................................................... 113
3.8.7.1 IEA-ETSAP_ETechDS ............................................................................................................ 113
3.8.8 Scenario files ................................................................................................................................. 114
3.8.8.1 Scen_UC_CO2BND................................................................................................................. 114
3.8.8.2 Scen_UC_NUC_MaxCAP ....................................................................................................... 114
3.8.9 Results ........................................................................................................................................... 115
3.9 DemoS_009 - SubRES sophistication (CHP, district heating) and Trans files ................................ 116
3.9.1 B-Y Template VT_REG*_ELC_V09 ........................................................................................... 118
3.9.1.1 Con_ELC.................................................................................................................................. 118
3.9.1.2 BY_Trans ................................................................................................................................. 119
3.9.2 SubRES_NewTechs_Trans ........................................................................................................... 119
3.9.3 SubRES_New-IND ....................................................................................................................... 120
3.9.4 SubRES_New-CHP-DH ............................................................................................................... 121
3.9.5 Scenario files ................................................................................................................................. 123
3.9.5.1 Scen_IND_NewRES ................................................................................................................ 123
3.9.5.2 Scen_UC_DH_MinProd........................................................................................................... 123
3.9.6 Results ........................................................................................................................................... 123
3.10 DemoS_010 - Demand projections and elastic demand ..................................................................... 125
3.10.1 Demand files ................................................................................................................................. 126
3.10.1.1 ScenDem_DEM_Ref ............................................................................................................... 126
3.10.1.2 Dem_Alloc+Series ................................................................................................................... 126
3.10.2 Results ........................................................................................................................................... 127
3.11 DemoS_011 – Sets Template ................................................................................................................ 128
3.11.1 Updating the Sets-DemoModels ................................................................................................... 129
3.11.2 Scen_Bounds-UC-wSets ............................................................................................................... 129
3.11.3 Results ........................................................................................................................................... 130
3.12 DemoS_012 – More modelling techniques .......................................................................................... 130
3.12.1 B-Y Template VT_REG*_Pri_V12 .............................................................................................. 131
3.12.1.1 TOTCO2 .................................................................................................................................. 131
3.12.2 SubRES_NewTechs (ELC sheet) .................................................................................................. 131
3.12.3 Scenario files ................................................................................................................................. 132
3.12.3.1 Scen_NUC_DiscInv – lumpy investments ............................................................................... 132
3.12.3.2 Scen_TRADSL_Tax ................................................................................................................ 133
3.12.3.3 Scen_CO2_Tax ........................................................................................................................ 133
3.12.3.4 Scen_Solar_Subsidies .............................................................................................................. 133
3.12.3.5 Scen_UC_CO2_Regions .......................................................................................................... 134
3.12.4 Results ........................................................................................................................................... 134
Table of Figures
Figure 1. StartPage Model Selection & News........................................................................... 3
Figure 2. Sub-folders Structure for each VEDA2.0 Model (showing the DemoS_012 files)... 5
vii
Figure 3. Model StartPage ......................................................................................................... 6
Figure 4. VEDA2.0 Navigator Layout ...................................................................................... 7
Figure 5. VEDA2.0 Navigator – Tailored View ....................................................................... 7
Figure 6. VEDA Tags Overview ............................................................................................. 10
Figure 7. How to Use ~FI_COMM ......................................................................................... 11
Figure 8. How to use ~FI_PROCESS ..................................................................................... 12
Figure 9. How to Use the ~FI_T Table ................................................................................... 14
Figure 10. Example of ~TFM_INS Insert Table ..................................................................... 15
Figure 11. Example of ~TFM_UPD Update Table ................................................................. 16
Figure 12. Defining a User Constraint in VEDA2.0 ............................................................... 18
Figure 13. Browser for the model database............................................................................. 21
Figure 14. Process Items List .................................................................................................. 22
Figure 15. Master Schematic Representation of the RES – Process View ............................. 23
Figure 16. Master Schematic Representation of the RES – Commodity View ...................... 24
Figure 17. Master Schematic Representation of User Constraints.......................................... 25
Figure 18. Run Manager.......................................................................................................... 26
Figure 19. Case Designation Form .......................................................................................... 27
Figure 20. Model Run ............................................................................................................. 28
Figure 21. Components of the VEDA2.0 Result Facility ....................................................... 30
Figure 22. Results Electric Power Plant Capacity Table ........................................................ 32
Figure 23. Results Data and Chart .......................................................................................... 33
Figure 24. Results ExRES Facility Component Detail ........................................................... 33
Figure 25. Attribute Master Table ........................................................................................... 34
Figure 26. Sets-<model> Rules Workbook ............................................................................. 35
Figure 27. Set Brower ............................................................................................................. 36
Figure 28. Templates Included in DemoS_001 ....................................................................... 39
Figure 29. Commodity RES (COA) and Item Details ............................................................ 39
Figure 30. Key SysSettings Options (DemoS_001) ................................................................ 40
Figure 31. Regions and Time-slices Definition in SysSettings............................................... 40
Figure 32. Start Year and Time Period Definition in SysSettings .......................................... 41
Figure 33. Dummy Import Prices in SysSettings .................................................................... 41
Figure 34. Global Constants Declarations in SysSettings ....................................................... 42
Figure 35. Default Currency and Units Declarations in SysSettings ...................................... 42
Figure 36. Key SysSettings Options (DemoS_012) ................................................................ 43
Figure 37. Regions and Time-slices Definition in SysSettings............................................... 43
Figure 38. Start Year and Time Period Definition in SysSettings .......................................... 44
Figure 39. Dummy Import Prices in SysSettings .................................................................... 44
Figure 40. Global Constants Declarations in SysSettings ....................................................... 45
Figure 41. Default Currency and Units Declarations in SysSettings ...................................... 45
Figure 42. Initial Energy Balance at Start Year (2005) for REG1 in DemoS_001 ................. 47
Figure 43. A Typical Commodity Declaration Table ............................................................. 47
Figure 44. A Typical Process Declaration Table .................................................................... 47
Figure 45. Description of Supply Options in a Flexible Table ............................................... 48
Figure 46. Declaration of Demand Commodity and Process .................................................. 48
Figure 47. Description of a simple demand processes ............................................................ 49
Figure 48. Definition of Base Year Demand Values .............................................................. 49
viii
Figure 49. VEDA2.0 Run Manager to Submit Model Runs ................................................... 50
Figure 50. List of DemoS_001 Results Tables ....................................................................... 51
Figure 51. __Check Dummy Imports ...................................................................................... 51
Figure 52. _SysCost Results Table Definition ........................................................................ 51
Figure 53. Total System Cost in DemoS_001 ......................................................................... 52
Figure 54. All Costs Results Table Definition ........................................................................ 52
Figure 55. All System Costs Results by Component .............................................................. 53
Figure 56. Demands Table Definition ..................................................................................... 53
Figure 57. TPSCOA Demand Results Table ........................................................................... 53
Figure 58. Fuel Supply Results Table ..................................................................................... 54
Figure 59. Fuel Supply results by process and period ............................................................ 55
Figure 60. Marginal prices Results Table ............................................................................... 55
Figure 61. Marginal Prices for DemoS_001 Commodities ..................................................... 55
Figure 62. Energy balance at start year 2005 for REG1 – Covered in DemoS_002 ............... 57
Figure 63. Introduction of Sector Fuel Processes ................................................................... 57
Figure 64. End-use Demand Processes ................................................................................... 58
Figure 65. Results - Demands Results Table for DemoS_002 ................................................ 59
Figure 66. Results – Fuel Supply Results Table for DemoS_002 ........................................... 60
Figure 67. Results – Emissions by Sector Results Table for DemoS_002 ............................. 61
Figure 68. Results – Prices_Energy Results Table for DemoS_002 ....................................... 61
Figure 69. Marginal Price of Process Activity Table in DemoS_002 ..................................... 62
Figure 70. New time periods definition in the SysSettings file .............................................. 63
Figure 71. New constant declarations in the SysSettings file ................................................. 63
Figure 72. Energy Balance at Start Year (2005) for REG1 – Covered in DemoS_003 .......... 64
Figure 73. PRI_COA Sheet with Interpolation/Extrapolation Rules ...................................... 65
Figure 74. Description of New Supply Options ...................................................................... 66
Figure 75. Existing and New Power Plants ............................................................................. 67
Figure 76. Declaration of Electricity Commodities and Processes ......................................... 67
Figure 77. Description of a simple electricity demand processes ........................................... 67
Figure 78. Definition of base year and future years demand values ....................................... 68
Figure 79. Demand Results Table in DemoS_003 .................................................................. 69
Figure 80. Fuel Supply Results Table in DemoS_003 ............................................................ 69
Figure 81. Electricity Plants Capacity Results Table in DemoS_003 ..................................... 70
Figure 82. Electricity Plants Activity Results Table in DemoS_003 ...................................... 70
Figure 83. Templates In DemoS_004 ..................................................................................... 71
Figure 84. New Time Slices Definition in SysSettings ........................................................... 72
Figure 85. Default Table for Interpolation/Extrapolation Rules in SysSettings ..................... 72
Figure 86. New Time Slice Declarations in SysSettings ........................................................ 72
Figure 87. Peak Contribution for Different Types of Power Plants ........................................ 73
Figure 88. Declaration of Time Slice Level for Electricity Commodity ................................ 74
Figure 89. Declaration of Time Slice Operational Level for Processes .................................. 74
Figure 90. Definition of Load Curve for Electricity Demand ................................................. 74
Figure 91. Demand Technology Producing TPSELC ............................................................. 75
Figure 92. Declaration of the Peak Reserve in a Scenario File ............................................... 75
Figure 93. Solving Multiple Cases .......................................................................................... 76
Figure 94. Electricity Plant Capacity Results Table in DemoS_004 ...................................... 77
ix
Figure 95. Electricity Price by Time Slice in DemoS_004 ..................................................... 77
Figure 96. Slack and Dual Values of the Peak Equations in DemoS_004 .............................. 78
Figure 97. Templates In DemoS_005 ..................................................................................... 79
Figure 98. New Region Definition in SysSettings for DemoS_005 ....................................... 79
Figure 99. Energy balance at start year 2005 for REG1 & REG 2–Covered in DemoS_005. 80
Figure 100. Regionalization of Process Attributes using Additional Rows ............................ 81
Figure 101. Region Specification in the Default Process Table ............................................. 81
Figure 102. Regionalization of process attributes using additional columns .......................... 82
Figure 103. Examples of trade matrix for bilateral and unilateral links ................................. 82
Figure 104. Declaration of attributes for IRE processes ......................................................... 82
Figure 105. Declaration of emission bounds for the power sector.......................................... 83
Figure 106. Declaration of emission bounds using a user constraint ...................................... 83
Figure 107. Fuel Supply (by Region) in DemoS_005 ............................................................. 84
Figure 108. Emissions by Sector (and Region) in DemoS_005 .............................................. 85
Figure 109. Endogenous Trades in DemoS_005 ..................................................................... 86
Figure 110. Emissions Price by Sector and Region in DemoS_005 ....................................... 86
Figure 111. Costs by Sector and Region in DemoS_005 ........................................................ 87
Figure 112. Templates Included in DemoS_006 ..................................................................... 89
Figure 113. New workbook name definitions in the SysSettings file ..................................... 89
Figure 114. Example of new processes in the SubRES file .................................................... 90
Figure 115. Example of a new process with vintage tracking in the SubRES file.................. 90
Figure 116. Fuel Supply by Region in DemoS_005 ............................................................... 91
Figure 117. Templates Included in DemoS_007 ..................................................................... 93
Figure 118. Updated Interpolation/Extrapolation Rules ......................................................... 93
Figure 119. Disaggregated Initial Energy Balance (2005) for REG2 in DemoS_007 ............ 94
Figure 120. Refinery ............................................................................................................... 95
Figure 121. Set PCG for the Refinery ..................................................................................... 95
Figure 122. Imports and Exports of Refined Petroleum Products .......................................... 96
Figure 123. Additional Sector Fuel Processes with Multiple Input Commodities ................. 96
Figure 124. More Complex Transportation Processes ............................................................ 97
Figure 125. Declaration of More Processes in the Transportation Sector .............................. 97
Figure 126. Demand for Transportation by Car (physical units) ............................................ 98
Figure 127. Combustion Emissions from the Transportation Sector ...................................... 98
Figure 128. Grab Base Year Demand Values from B-Y Templates - Transportation ............ 99
Figure 129. Using Base Year Values to Project End-use Demands - Transportation ............. 99
Figure 130. Grab Base Year Activity Level from B-Y Templates - Refinery ........................ 99
Figure 131. Using Base Year Values to Update Refinery Attributes ...................................... 99
Figure 132. Set Emission Bounds for Transportation Sector ................................................ 100
Figure 133. Specifying Growth Rates with a User Constraint .............................................. 100
Figure 134. Declare Price-elasticities for End-use Demands ................................................ 101
Figure 135. Write Base Prices for Elastic Demands ............................................................. 101
Figure 136. Include the B Elastic Demand and Emission Constraint ................................... 102
Figure 137. Results - Effect of Price Elasticities on Car Transportation Demand in
DemoS_007................................................................................................................................. 103
Figure 138. Results – Car Transport Vehicle Type Mix in DemoS_007 .............................. 104
Figure 139. Flexible Refinery Operation in DemoS_007 ..................................................... 105
x
Figure 140. Templates Included in DemoS_008 ................................................................... 107
Figure 141. New Time Periods Definition in SysSettings .................................................... 108
Figure 142. Default Declarations in SysSettings .................................................................. 108
Figure 143. Disaggregated Initial Energy Balance (2005) for REG1 in DemoS_008 .......... 108
Figure 144. New Renewables Supply Options...................................................................... 109
Figure 145. Electricity Imports and Exports Options ........................................................... 109
Figure 146. New Renewable Electric Generation Power Plants ........................................... 110
Figure 147. Combustion Emissions from the Electricity Sector ........................................... 110
Figure 148. Flexible Multiple Input Process in the Industrial Sector ................................... 110
Figure 149. New Environmental Commodity for Industrial Emissions................................ 111
Figure 150. Existing Residential Sector Processes ............................................................... 111
Figure 151. Demand for Energy Services in the RCA Sectors ............................................. 112
Figure 152. Fractional Shares for RCA Energy Service Demands ....................................... 112
Figure 153. Existing Transportation Sector Vehicle Types .................................................. 113
Figure 154. New Residential and Commercial Devices ....................................................... 114
Figure 155. Grab Base Information on Nuclear Plant Capacity ........................................... 114
Figure 156. User Constraint to Impose a Maximum Capacity for Nuclear Power Plants .... 115
Figure 157. Results - Power Plant Capacity by Fuel Type in DemoS_008 .......................... 115
Figure 158. Emissions by Sector in DemoS_008 .................................................................. 116
Figure 159. Templates Included in DemoS_009 ................................................................... 118
Figure 160. Past Investments That Occurred Before 2005 ................................................... 119
Figure 161. Transformation File to Insert New Attributes for Existing Processes ............... 119
Figure 162. Transformation File to Insert a New Interpolation Rule.................................... 119
Figure 163. SubRES Transformation File to Set Process Availability ................................. 120
Figure 164. Iron & Steel Sector Processes ............................................................................ 120
Figure 165. Energy and Material Input Commodities for the Iron & Steel Sector ............... 121
Figure 166. Combined Heat and Power Processes ................................................................ 122
Figure 167. Demand for Heat and District Heating Options ................................................ 122
Figure 168. Update Existing Information and Insert New Information in the Industrial Sector
..................................................................................................................................................... 123
Figure 169. Minimum District Heating Penetration Using a User Constraint ...................... 123
Figure 170. Results – Finished steel production in DemoS_009 .......................................... 124
Figure 171. Residential Space Heating Fuel Use in DemoS_009 ......................................... 124
Figure 172. Templates Included in DemoS_010 ................................................................... 126
Figure 173. Drivers for End-use Demand Projections .......................................................... 126
Figure 174. Sensitivity and Calibration Series for End-use Demand Projections ................ 127
Figure 175. Allocation of Demand Drivers and Series for End-use Demand Projections .... 127
Figure 176. Demand Projection Results in DemoS_010 ...................................................... 128
Figure 177. SETS Template in DemoS_010 ......................................................................... 129
Figure 178. User constraint on renewable power using a VEDA-BE set ............................. 130
Figure 179. Generation in DemoS_010/011 ......................................................................... 130
Figure 180. Aggregation of Emission Commodities............................................................. 131
Figure 181. Discrete Investment Option for Nuclear Power Plants ...................................... 132
Figure 182. Discrete Capacity at Specific Years for Nuclear PowerPplants ........................ 132
Figure 183. Enable the Variant Discrete Investment in VEDA2.0 ....................................... 133
Figure 184. Flow Tax on Diesel ............................................................................................ 133
xi
Figure 185. Tax on Net CO2 Emissions ............................................................................... 133
Figure 186. Subsidy on Electricity ........................................................................................ 134
Figure 187. Cap Total CO2 Emission via User Constraint ................................................... 134
Figure 188. Final Energy Fuel Consumption in Transport ................................................... 135
Figure 189. Electricity Power Plant Capacity in DemoS_012 .............................................. 136
Figure 190. New Electric Plant Capacity Investments - DemoS_011/012 Comparison....... 137
Table of Tables
Table 1. Valid Column Headers for a Commodity Table ~FI_COMM .................................. 11
Table 2. Valid Column Headers for a Process Table ~FI_Process ......................................... 12
Table 3. Valid Row ID Column Headers for Flexible Import ~FI_T Table ........................... 14
Table 4. Valid Column Headers for Transformation Tables ................................................... 16
Table 5. UC sets available in VEDA2.0.................................................................................. 18
Table 6. UC_INDEXES for user constraint tables .................................................................. 19
Table 7. Basic DemoS Models ................................................................................................ 37
Table 8. Interpolation/Extrapolation Codes in TIMES ........................................................... 65
Table 9. TIMES Results Attributes ....................................................................................... 137
xii
1 Overview
This Part of the TIMES documentation provides an introduction to VEDA2.0 (Version
1.190.1.1), a flexible, user-friendly tool that oversees all aspects of the management and use
TIMES energy system models, incorporating modules for handling the model input templates
(data) and run results. The manual does so by presenting a step-by-step introduction to building a
TIMES model using a series of twelve DemoS models (available for download from the ETSAP
website - https://iea-etsap.org/index.php/documentation) to progressively demonstrate VEDA-
TIMES principles and modeling techniques. The remainder of Section 1 describes how to access
and set up the TIMES DemoS models. Section 2 provides an orientation to the basic features of
VEDA2.0, including software layout, commonly used data files and tables, and model
management features. Section 3 then walks through the twelve DemoS models, providing for
each a summary of the VEDA-TIMES features and model attributes introduced, a detailed guide
to the templates and tables used, and a look at the model results.
1.1 Downloading and Registering VEDA2.0
To download and install VEDA2.0 it is recommend that the new user first takes a look at the
YouTube video on this topic noted in Section 2. Once downloaded, unzipped and starting
VEDA2.0 the user is presented with an Activation screen where one proceeds by:
• Hitting Get Trail Key
• Completing the Registration Form
• Grabbing the Trail Key from your email,
• Paste it into the Activation form, and request Activation – as seen below.
1
This will then bring you to the VEDA2.0 Start Page discussed in Section 2.
1.2 Obtaining and Setting Up GAMS for TIMES
As part of registering VEDA2.0 a request is sent to the ETSAP Liaison Officer who will
arrange for an evaluation GAMS license file to be created, sending it to the new user along with
the download and install procedures here:
1. Copy the GAMSLICE someplace on your computer.
2. Head to http://www.gams.com/download/ and select the Windows download option for
either Win-64/32, as appropriate
3. Run Setup by clicking on it in Windows Explore
a) Check “Use advanced installation mode” at the bottom of the GAMS Setup
form.
b) Let GAMS get installed into the default folder (\GAMS\<Win#>\<ver>.
c) Check the Add GAMS directory to PATH environment variable.
d) Have the GAMSLICE.TXT copied from wherever it currently resides.
2
You may need to restart your computer to have the GAMS Path activated.
Once you have VEDA installed you can try a TIMES model run.
1.3 Downloading and Setting Up the DemoS Models
The complete set of VEDA-TIMES DemoS models is available, along with all five Parts of
the TIMES documentation, on the ETSAP Documentation web page (http://www.iea-
etsap.org/index.php/documentation) under ‘VEDA-TIMES Demo Models,’ and is downloaded
as part of the VEDA2.0 installation procedure. Thus you will also need VEDA2.0 installed in
order to follow along with this manual. In addition, you’ll need GAMS (General Algebraic
Modeling System, www.GAMS.com) system in with the TIMES model generator is written.
VEDA and GAMS evaluation licenses are available at https://www.kanors-
emr.org/AcquiringTools.php.
To open the first DemoS from VEDA2.0 launch VEDA2.0. and from the StartPage select
DemoS_001 from the list of available models, see Figure 1. The current model and version of
VEDA2.0 is shown on the top row for the form.
Note that once a model has been selected the StartPage will have the Module buttons displayed
at the top of the form, see Figure 3.
2 Introduction to VEDA2.0
This section provides a brief introduction to the VEDA Excel template workbooks for
specifying and building a model, and using VEDA2.0 to access and manage the templates,
browsing the data, viewing the underlying Reference Energy System (RES) network depicting
the energy system, and running a TIMES model.
To assist with getting setup with and oriented to VEDA2.0 you may want to start by
engaging with the short YouTube tutorials:
3
1. Installation & Quick Tour
2. VEDA2.0 Menu
3. Navigator
4. Browse
5. Item Details
6. Run Manager
7. Results {now video yet}
8. ETSAP VEDA2.0 Tutorial Webinar (1.5hrs)
The main modules available in VEDA2.0, available from the StartPage, Modules menu, or
[Function Keys] are:
• Navigator [F6]: to oversee the management of the Excel workbooks;
• Browse [F7]: to view all model data (based on filter and search facilities) in a dynamic
data cube;
• Items List indicating all the process/commodities appearing in the model, as well as user
constraints;
• Items Details [F8]: to view and cascade thru the RES (indicating any UCs the
component is involved in), with process/commodity declaration information and cube
data views;
• Run Manager [F9]: for composing and submitting model runs, and
• Results [F10]: for model results analysis.
These are described in Section 2.5, after a description of the VEDA2.0 template folder
structure, file types, tables used to create model input and results module VEDA2.0 for analysis
of model runs.
2.1 Model Folder Organization
All VEDA-TIMES model input data is organized in Excel workbooks (or files). VEDA2.0
then integrates information from all of these workbooks into internal databases to facilitate
management of the model data and to prepare and submit a TIMES model, generated and solved
with the GAMS sub-system. The user templates underlying models managed by VEDA2.0 are
normally stored in a specific folder (by default \VEDA\VEDA_Models). Within this folder, there
is a sub-folder for each individual model a user is working with, including all of the VEDA-
TIMES Demo Models ((\VEDA\VEDA_Models\DemoS_001, _002, etc.). The sub-folder
structure is identical for each individual model (Figure 2, left side) and includes the kind of
templates shown in the table below, as found with the DemoS_012 model.
4
* The ‘AppData’ sub-folders is maintained by VEDA-FE
(users are not concerned with these internal databases)
Figure 2. Sub-folders Structure for each VEDA2.0 Model (showing the DemoS_012 files)
➢ The B-Y Templates, the SysSettings files, the BY_Trans file and Sets.
➢ A sub-folder (SubRES_TMPL) to store all SubRES files and associated transformation
files.
➢ A sub-folder (SuppXLS) to store all scenario files, as well sub-folders for trade files
(Trades) and demand files (Demands) (Figure 2, right side).
➢ Users are not concerned with the other sub-folders.
2.2 VEDA2.0 StartPage
VEDA2.0 opens displaying the StartPage (Figure 4), which enables the launch of any of the
individual components of VEDA by double-clicking on the associate box. The components may
also be launch from the Modules pulldown menu, as well as via function keys as noted above.
The main components most often used are readily accessible via the StartPage:
➢ Navigator: oversee the management of the Excel workbooks;
➢ Browse: access model data via dynamic cube tables;
➢ Items List: list of all process, commodity, commodity groups and user constraint in a
model;
➢ Items Detail: basic Reference Energy System network diagram view of
commodity/process connectivity and associated data;
➢ Run Manager: to compose and submit model runs, and
➢ RESULTS: examination of model run results via tables and graphs.
The current model (DemoS_001) and version of VEDA2.0 are shown on the top line of the
form.
5
Figure 3. Model StartPage
6
NAVIGATOR
You may also switch the panes around, as done in Figure 5, where the Regular Scenario [RS]
pane has been moved to the left of the Demand Scenario [DS] and Trade Scenario [TS] panes.
This is accomplished by grabbing the pane at the top then using the positioning tool to place
the pane where you wish in the form. Note that when closing and reopening the Navigator (or
VEDA2.0) the panes will appear as organized the last time.
7
The specific folder associated with the active model can be opened by clicking on the model
name at the both of the VEDA2.0 form (in Figure 4, MODEL: C:\VEDA\VEDA_Models\
DemoS_012) or the icon in the Base Scenario quadrants. Said icon can be found in each of
the panes of the Navigator and will similarly open Explore to the associated sub-folder of the
current model. One may also make a new instance of any folder by hitting the New button next
to the folder in each pane.
The VEDA-Navigator is the main vehicle for accessing, importing, and coordinating the
various files that make up a model. Any template may be opened from the Navigator by double-
clicking on its name, or in the case of SysSettings/BaseTrans using the icon alongside the
file name. The Navigator form is divided into sub-windows/panes/quadrants according to the
various types of files managed by VEDA2.0:
• Base Scenario [BS]: templates used to set up the base-year (B-Y) structure of the model
(existing commodities and current processes stock, and the base-year end-use demand
levels), according to the energy flows reflect the overall energy balance. Thus the start
year of the model can be calibrated to the energy balance according the B-Y Templates.
The B-Y templates are named as VT_<workbook name>_<sector>_<Version> (e.g.
VT_REG_PRI_V1, as seen in Figure 2). The number of B-Y templates and their names
depend on both the model structure (e.g., the number of regions and sectors) and the
organisation of the input data (e.g., how many regions and sectors in each file). The B-Y
templates are introduced in DemoS_001 (Section 3.1) and are modified throughout the
evolution of the 12 DemoS steps.
o BY_Trans: are transformation files used to update the information included in the
B-Y templates (update existing values for existing attributes) and/or to insert new
information (insert new attributes for existing processes) in the B-Y templates.
They work like a scenario file (described below), but the rule-based filters and the
update/insert changes apply only to those processes and commodities already
existing in the B-Y templates. The BY_Trans file is introduced in DemoS_009
(Section 3.9.1.2).
• SysSettings: is used to declare the very basic structure of the model including regions,
time slices, start year, etc. It also contains some settings for the synchronization process
and can include some additional information. There is only one such file; it has a fixed
name that stands for System Settings. The SysSettings file is described in Section 3.1.1.
• SubRES [SR]: SubRES files are used to introduce new commodities and processes in the
RES that are not part of the B-Y templates. However, while the B-Y templates are
region-specific, the SubRES are region independent. For each SubRES file there is a
corresponding transformation (Trans) file allowing the introduction of region-specific
process attributes, including the availability (or not) of processes in each region. To make
changes to the SubRES_Trans-_<sector> files use the Navigator to open the associated
model subfolder and access the file via Window Explorer. The naming conventions are:
SubRES_<name> and SubRES_<name>_Trans. SubRES files are introduced in
DemoS_006 (Section 3.6.3).
• Regular Scenario [RS}: Scenario files are used to update existing information and/or to
insert new information in any part of the RES, including B-Y templates, SubRES files,
and Trade files (see below). They are also used to include any additional user constraints
8
in the model. The naming convention is: Scen_<scenario name>. These files can only
manipulate (insert or update) information associated with previously declared RES
components. New commodities and processes may not be added via Scenario files, only
new attributes. Scenario files are introduced in DemoS_004 (Section 3.4.3). Several
different applications of scenario files are illustrated through the remainder of the
DemoS.
• Demand Scenario [DS]: Demand Templates Include all the information necessary to
project end-use demands for energy services in each region, such as macroeconomic
drivers and sensitivity series. Multiple demand files may be used, to model different
demand growth scenarios for instance. The naming convention is: ScenDem_<scenario
name>. This section of the Navigator also contains a single file permitting assignment of
a demand driver as well as a sensitivity (or elasticity) series each end-use demand to its
driver in each region: Dem_Alloc+Series. Demand files and tables are described in
DemoS_010 (Section 3.10.1).
• Trade Scenario [TS]. This section of the Navigator contains a file in which all unilateral
and/or bilateral trade links between regions are declared: ScenTrade__Trade_Links, and
associate data provided when appropriate. The latter contains all of the attribute
specifications for the trade processes. Multiple trade files may be used, to model
different trade scenarios or for different commodities. The naming convention is:
ScenTrade_<scenario name>. Trade files are introduced in DemoS_005 (Section 3.5.3).
For more advanced modelling there are also control panels for the Parametrisation facilities
of VEDA2.0, and well as for more complex model input setups a couple of ways to look at inter-
decencies between templates – though these are beyond the scope of the basic DemoS models,
As shown in Figure 4, the Navigator provides feedback as to the status of the various files
and the integrated database managed by VEDA2.0. The consistency of the files and database is
immediately evident based upon whether any of the template files are highlighted in orange (to
ToImport) or red (Inconsistent). The status of individual templates is indicated by their colors in
the template lists, according to the legend at the bottom of the form. A file is shown as
Inconsistent when it has a newer date/time stamp than in the database. Note: you may need to do
a refresh via to update the current status of the files after a recent change(s).
9
The most common types of tables are briefly described in this section. More information on
how to use them for specific cases is shown in the sections associated with each step of the
DemoS. The initial examples in this section come out of the DemoS_001 model, unless
otherwise noted. The VEDA2.0 Information/VEDA Tags feature, shown in Figure 6, provides a
summary of what is required for each “~”tag VEDA handles.
10
2.4.1 Basic tables needed for any model
The following tables are needed in any VEDA-TIMES model.
➢ Tables that exist only in the SysSetting file (Section 3.1.1 describes how to use these
tables):
~BookRegions_Map: declare the workbook name and the list of region names;
~TimeSlices: declare the time-slice resolution for the model;
~DefaultYear: used to control the default year of the first period. It defaults to the start year;
~StartYear: declare the start year of the model;
~ActivePDef: declare the set of active periods;
~TimePeriods: declare the time horizon of the model for the ActivePdef;
~Currencies: define a default currency for the whole model, and
~DefUnits: define default units by activity, capacity, and commodity for each sector in the
model.
➢ Commodity Definition Tables (~FI_COMM): commodity declaration and definition;
may only appear in B-Y, SubRES and SysSetting files (described further in Section
2.4.2).
➢ Process Definition Tables (~FI_PROCESS): process declaration and definition; may
only appear in B-Y, SubRES and SysSetting files (described further in Section 2.4.3).
➢ Flexible Input Tables (~FI_T) for topology and parameter definition; used in BY and
SubRES files (described further in Section 2.4.4).
2.4.2 Commodity definition tables ~FI_COMM
Commodity definition tables (~FI_Comm) are used to declare the non-numerical
characteristics of commodities. The columns headers are described in the table below and their
order can be changed. Each commodity needs to be declared (only) once in such a table as shown
in Figure 7. They are supported in B-Y Templates, SubRES files, and the SysSettings template..
Care must be taken that commodities are declared only once, as problems can arise if the same
commodity is declared twice with conflicting attributes, such as different time slice levels. In
large complex models, therefore, a best practice would be to declare them in a single template
location only, such as the SysSettings template.
The valid column headers for a commodity table ~FI_COMM are described in Table 1 (with
reference to Figure 7).
11
Header Description
declarations are inherited until the next one is encountered. In this example, COA
(Solid Fuels) is an energy commodity (NRG).
Region* The region name. By default, it is applied to all regions of the model when not
specified. The region designation is used only in the B-Y templates and not
allowed in SubRES.
CommName The commodity name (COA).
CommDesc The commodity description (Solid Fuels).
Unit The commodity unit throughout the model (PJ). It is responsibility of the user to
be consistent with units.
LimType The sense of the balance equation for the commodity. Valid entries are LO
(Production>=Consumption, FX (Production=Consumption), UP
(Production<=Consumption). When not specified, the default is LO for all but
MAT commodities with a default of FX.
CTSLvl The commodity time-slice tracking level. Valid entries are ANNUAL, SEASON,
WEEKLY and DAYNITE. When not specified, the default is ANNUAL.
PeakTS* Peak time slice monitoring. Valid entries are: ANNUAL to generate the peaking
equation for all time slices or any specific time slices already defined in the
SysSettings file (comma-separated entries allowed). If not specified the default is
ANNUAL.
CType Electricity and heat commodities indicator (ELC, HTHEAT and LTHEAT)
* Note: Comma separated elements are allowed.
The valid column headers for a process table ~FI_PROCESS are described in Table 2 (with
reference to Figure 8.
Table 2. Valid Column Headers for a Process Table ~FI_Process
Header Description
Sets* Sets to which processes belong, indicating the nature of a process. Valid entries
are: ELE (thermal or other power plant), CHP (combined heat and power), PRE
(generic process), DMD (demand device), IMP (import process), EXP (export
process), MIN (mining process), HPL (heating plant), IPS for inter-period
storage, NST for night storage device, STG for general timeslice storage, STS
for simultaneous DayNite/Weekly/Seasonal, STK for simultaneous
DayNite/Weekly/Seasonal and inter-period storage process. These declarations
12
Header Description
are inherited until the next one is encountered. In this example, there are three
mining processes (MINCOA*), one import process (IMPCOA1) and one export
process (EXPCOA1), all related to the supply of solid fuels (COA).
Region The region name where the process exists (comma-separated entries allowed).
By default, it is applied to all regions of the model when not specified.
The region designation is used only in the B-Y templates and not allowed in
SubRES. [Note that regional data for SubRES processes can be provided in
the SubREs_<sector>_Trans file.]
TechName The process name (e.g. MINCOA1), up to 32 characters. (However, it is
recommended to limit process names to 27 characters as VEDA2.0 may
internally add digits for vintaging issues or dummy imports.)
ProcessDesc The process description (e.g., Domestic supply of Solid Fuels Step 1), up to 255
characters.
Tact The activity unit of the process (in Figure 8, for example, it is in PJ). It is the
user’s responsibility to be consistent with units.
Tcap The capacity unit of the process. It is the user’s responsibility to be consistent
with units.
Tslvl The process time-slice operational level. Valid entries are ANNUAL, SEASON,
WEEKLY and DAYNITE. When not specified, the default is based on the Sets
declaration: DAYNITE (for ELE, STGTSS, and STGIPS), SEASON (for CHP
and HPL), ANNUAL (for all others).
PrimaryCG The Primary Commodity Group (PCG) of the process. Normally none specified
as VEDA allocates the PCG by default. A declaration is needed only when the
user wants to create a new PCG and/or override the default PCG.
Vintage Vintage tracking. Valid entries are YES or NO. When not specified, the default
is NO.
* Note: Comma separated elements are allowed.
13
Figure 9. How to Use the ~FI_T Table
Indexes for the data, including attribute, region, year, and timeslice may be specified as either
row identifiers or column headers, so that a table may be laid out to match the configuration of
source data with minimal user intervention.
The ~FI_T table has six distinct regions. Valid entries in each of these are listed below.
➢ Row ID Col Headers. The valid row ID column headers for a ~FI_T flexible import
table are described in Table 3.
Table 3. Valid Row ID Column Headers for Flexible Import ~FI_T Table
Header Description
Region* Region declaration
TechName Technology Name
Comm-IN* Input Commodity
Comm-IN-A* Auxiliary Input Commodity
Comm-OUT* Output Commodity
Comm-OUT-A* Auxiliary Output Commodity
Attribute Attribute declaration; single entries permitted
Year Year declaration; comma-separated entries allowed
TimeSlice* Time slices declaration; comma-separated entries allowed
LimType Valid entries are: UP (Upper), LO (Lower), FX (Fixed) and N (Non-
binding)
CommGrp User Defined Commodity Group
Curr Currency declaration
Stage Decision point (for multi-stage Stochastic models)
SOW State of the World (for Stochastic models)
Other_Indexes To enter special dimensions that are required in certain attributes (see an
example at https://github.com/kanors-emr/Model_Demo_Adv_Veda.git)
* Note: Comma separated elements are allowed.
➢ Row Identifiers: elements of the dimension indicated in the row ID column headers.
14
➢ Data Area Column Headers: Elements of the following dimensions (elements of
multiple dimensions can be separated by ~):
• Attribute
• Year
• TimeSlice
• LimType
• Commodity
• CommGrp (only the internal VEDA commodity groups: DEMO/DEMI/NRGO/
NRGI/MATO/MATI/ENVO/ENVI/FINO/FINI can be used as column headers)
• Region
• Currency
➢ Data: numerical entries.
➢ Table level declarations: Declarations like those made in column headers can be
included in the table header (following a colon) and will apply to all data that doesn’t
have a different value for that index specified. For example, ~FI_T: DEMAND would
assign DEMAND as the attribute for all values in the table that don’t have an attribute
specification at the column or row level.
➢ Comments: a comment row is identified by the character " * " or “\I:” as the first
character in any of the cells below the Row ID Col Headers or the first character in any of
the column headers. (However, caution should be exercised in using " * " to indicate a
comment, because it may also be used to indicate a wildcard or an operation in some
cells. “\I:” is the safer choice to indicate a comment row/column.)
2.4.5 Transformation Insert and Update tables
Transformation Insert Tables (~TFM_INS) are used to define absolute values via
additional parameters that were not defined in the base year or SubRES templates in a rule-
based manner. In this example from DemoS_001, it is used to declare three new attributes
(G_DYEAR, Discount, and YRFR) by row as shown in Figure 10.
15
Figure 11. Example of ~TFM_UPD Update Table
Transformation Direct Insert Tables (~TFM_DINS) are also used to insert data, but
unlike in Insert tables, it is forbidden to define subsets of technologies using text/wildcards, and
for each attribute all the required dimensions must be defined (no defaults). These tables can be
useful when working with large, detailed source data tables, because VEDA2.0’s processing of
DINS tables is much faster than that of Insert tables.
Transformation tables may be used only in scenario and transformation files. Valid column
headers for data entry in transformation insert and update tables are presented in the top portion
of Table 4. These tables can identify the items whose data is to updated or inserted using the
criteria in the bottom portion of Table 4.
Table 4. Valid Column Headers for Transformation Tables
Header Description
Insert or update values
Attribute Name of the attribute
Year* Year declaration; default value = start year
TimeSlice* Time slices declaration; default=ANNUAL.
LimType Valid entries are: UP (Upper), LO (Lower), FX (Fixed) and N (Non-binding)
CommGrp User defined Commodity Group
Curr Currency declaration; default=CUR
Stage Decision point (for multi-stage Stochastic models)
SOW State of the World for Stochastic models)
Other_Indexes To enter special dimensions that are required in certain attributes
AllRegions Data value that is applicable to all regions
<Regions> Region-specific data values; these will supersede any declaration in
AllRegions column
Commodity and process filtering
PSet_Set1 Identifies qualifying processes based on TIMES or user-defined set
membership
PSet_PN2 Identifies qualifying processes based on names
PSet_PD2 Identifies qualifying processes based on descriptions
PSet_CI2 Identifies qualifying processes based on commodity inputs
PSet_CO2 Identifies qualifying processes based on commodity outputs
CSet_Set1 Identifies qualifying commodities based on TIMES set membership
CSet_CN2 Identifies qualifying commodities based on names
CSet_CD2 Identifies qualifying commodities based on descriptions
Top_Check To restrict application of attribute data to those process-commodity
combinations where the specified topology already exists in the model, rather
than creating new topology. Valid entries: I/O/A. “I” will retain those
combinations where commodities are input to processes. “O” => Output. No
topology check is performed by default.
Attrib_Cond To filter based upon whether an attribute is present or missing (precede with
“-“) for potentially qualifying processes.
Val_Cond Used in conjunction with Attrib_Cond to filter on the value of the specified
16
attribute. Define using '<', '>', ‘<>’, or '='. The condition will be tested across
all dimensions (for example, years) for the specified process, region, and
attribute.
*
Comma separated entries permitted.
1
Comma separated elements are allowed. Each of these fields can have comma-separated entries that are
joined by OR.
2
Comma separated elements and wild cards characters are allowed. The possible wild cards are:
“*” is used as wild card; for example *GAS* would refer to all elements that have GAS in the name with
any possible characters before and after GAS.
“-“ before the text used for exclusions; for example, *GAS*,-ELCGAS would refer to all elements that
have GAS in the name except for ELCGAS.
“?“ can be used to specify a single character; for example, ???GAS means there are 3 characters before
GAS.
2.4.6 Advanced tables
The following tables are special and/or advanced tables that can be used in different types of
templates to support model building.
➢ Special tags exist for emission commodity tables. With this table identifier the data are
manipulated during the import process to provide for special calculations on emissions
factors.
~COMEMI to link emissions to commodity consumption. An example on how to use this table
is shown in Section 3.7.2.7.
~COMAGG to define an aggregated commodity such as TOTCO2 accumulating the emissions
from each <sector>CO2 commodity.
➢ Fill tables in scenario files (~TFM_FILL) allow extraction of values from the rest of the
model database for use in Update or Insert tables. An example is shown in Section
3.7.4.1.
• TFM_FILL table is also available in SubRES transformation file, though note that
it can only be populated with numbers from the BASE scenario.
• The fill operation will color the Region cells upon processing to indicate the
number of records found, as follow:
o Blue color represents only one record found, and
o Purple color represents that more than one record was found for the
specified parameter and its dimensions while filling the region value in the
relevant row.
The user can specify whether multiple values are to be summed, averaged, or counted.
➢ Tags exist for transformation tables indicating that the import operation is different than
for the standard input tables ~FI_T. With this type of table identifier the data are
manipulated during the import process and not imported as provided. They are supported
in the BY_Trans file, SubRES files, and all scenario files.
~TFM_AVA to declare the availability of processes in different regions.
➢ Special tables that exist only in the Demand module:
~DRVR_Allocation to allocate a driver to each end-use demands;
~Series to define sensitivity and calibration series, and
~DRVR_Table to define demand driver indexes (base-year =1).
17
➢ Special tables that exist only in the Trade module: ~TradeLinks to declare uni- or
bilateral trade links between regions.
➢ User constraints are identified with specific identifiers ~UC_Sets.
2.4.7 User constraints and their tables
User constraints provide the modeller with a flexible framework to add case-study specific
constraints to the standard equation set embodied in TIMES model generator. With the help of
user constraints, virtually any possible linear relationship between core components of the RES
(as represented by variables in TIMES) can be formulated, and some input attributes can also be
brought in as coefficients. User constraints can also be written to link variables across
consecutive time slices or periods. Section 6.4 of Part II of the TIMES documentation contains
an extensive discussion of the user constraint types available and their mathematics.
Defining user constraints in VEDA2.0 templates is a two-step process. They are first declared
with one or more ~UC_SETS: tags, which indicate their type and domain of coverage. Then
their data is specified using a table with similar structure to that of a ~FI_T table, as shown in
Figure 12. This example puts an upper limit on the CO2 arising from the Transportation plus
Power sectors of the model from 2010 on, interpolation between 2010-2020 and the extending
constant for the remainder of the modelling horizon (owing to interpolation rule (5) specified in
the UC_RHSRTS~0 column).
Available UC sets are described in Table 5. Each set definition holds for the entire sheet,
unless redefined. All the existing set definitions are applied to all user constraints in a table.
Table 5. UC sets available in VEDA2.0
~UC_SETS: Signification Application
R_E Region_Each REG1: apply to one particular region
R_S Region_Sum REG1,REG2: apply to more than one region (comma
separated)
AllRegions: will apply to all regions
T_E Time period_Each
T_S Time period_Sum
TS_E Time slice_Each
TS_S Time slice_Sum
T_SUC Time period
successive
A UC table is then structured similarly to a Flexible Import table, with the ~UC_T tag
separating the column headings into row identifiers (UC_INDEXES) and data column headers.
Valid row ID (UC_INDEX) column headers are listed in Table 6.
18
Table 6. UC_INDEXES for user constraint tables
Column
Description
Header
UC_N Short Name of the UC
Region Name of the region(s)
PSet_PN* Process names
PSet_PD* Process description
Pset_CI* Input commodities to define a set of processes
Pset_CO* Output commodities to define a set of processes
Cset_CN* Commodity names
Cset_CD* Commodity description
Side LHS/RHS; RHS is applicable only in the case of dynamic (across periods) constraints.
Any of the UC attributes available in the current TIMES code (refer to Part II of the
Attribute
TIMES system documentation.]
• Allows modifiers to be applied to the variables used in the UC. These include the
GROWTH modifier, to create a constraint that limits the percentage growth in a
variable over periods; modifiers to pull input data, such as COST and EFF, into the
UC's coefficients; and the NEWFLO modifier that applies the UC coefficient to the
flows of the new vintage of a process only. More details are found in Section 6.4.6
of Part II.
UC_ATTR • The contents of this column are comma separated values of UC_Name and
UC_GrpType. Several pairs can be separated by “;”.
• A pair can have UC_Name/GrpType in any order; any element in the list ACT,
CAP, NCAP, FLO, IRE, COMCON, COMPRD, COMNET is taken as GrpType
and the other one is designated as the UC_Name. Valid UC_Names are provided
and described in Section 6.4.6 of Part II.
• UC_ATTR can have a ~ appended to it; the default is LHS.
Year Years, comma separated list allowed
LimType UP/LO/FX/N
To control the process-commodity combinations via topology when both indexes exist
for the attribute in question. Valid entries: I/O/A. “I” will retain those combinations
Top_Check
where commodities are input to processes. “O” => Output; . Default = either input or
output.
* Wild cards allowed, comma separated list permitted
19
2.5 VEDA2.0 Data Management, Model Visualization and Run Submission
Tools
Once the templates have been imported and assembled as a model database within VEDA2.0
by means of the Navigator (Figure 5) and a Synchronize done, one can review the resulting data
by means of powerful visualization tools and dynamic data cubes (pivot tables), as well as to
view the RES by requesting that the network diagram be displayed. As is the case in the earlier
sections screenshot below are taken for the DemoS_012 model.
More information on VEDA2.0 and description of additional features are available at
http://support.kanors-emr.org/ [note: at the time of writing the website described original VEDA-
FE and VEDA-BE.] Each of the remaining main sections of this document describes one
incremental step of the VEDA-TIMES Demo Models.
2.5.1 Navigator
The Navigator was introduced in Section 2.3. Here we expand to further explain the
important role the Navigator plays below.
➢ Enables easy access to any of the Excel templates constituting the currently open model.
➢ Double-clicking directly on any file name (or click the Excel icon next to it, in the case of
the BY_Trans and SysSettings files) will open that file in Excel.
➢ Clicking on the folder button above each section of the Navigator will open the
associated folder in Windows Explorer.
➢ Provides feedback as to the status of the various files and the integrated database
managed by VEDA-FE according to colour legend at the bottom of form:
20
2.5.2 Browse
The database Browser can be accessed from the StartPage, or Modules menu or by pressing
F7. The Browse pane is split with the upper half where the user specifies the criteria to be
applied to the data, and the lower part the resulting qualifying information. The Browser thereby
enables the user to view subsets of the assembled data in a cube by selecting the scenario(s),
region(s), process(es), commodity(ies), and/or the attribute(s) of interest; the new nuclear power
plants (ELCNNNUC01) in REG1 in the example shown in Figure 13. It also facilitates direct
access to the data in the templates by double-clicking on a cell.
First, elements are selected manually, limited to those belonging to a particular Set via the
pulldown menu above the Process/Commodity or via the search box at the top of each column.
For the items then selected the information is displayed in a default layout, or last layout used.
As was mentioned earlier, in Section 2.3, the Browse pane may be rearranged as desired. It is
possible to rearrange the layout of the cube by adding/removing dimensions (columns and rows)
to/from the table by dragging/dropping components from/to the area above the current row
designator columns, where above unwanted indexes are dragged up to (outside of the cube) and
the columns reordered (by putting the cursor on the column header and holding the left mouse
button down) to present a clean look at the process information.
Any dimension not positioned as part of the row/column table layout definition appears at the
top of the page. These dimensions have their values summed in the cube. Note that for any
dimension where only a single value exists, said dimension is automatically moved up top. Using
21
the associated with each header, individual entries may temporarily be removed by
unselecting them from the list of elements.
2.5.3 Item List
The Items List provides a look at all the data assembled from Templates Into the VEDA2.0
database by component type: Process, Commodity, Commodity Group, User Constraint,
indicating the scenario, region, sector, Set membership, Item Name, Description, Units, Primary
Commodity Group (PCG, indicating whether a process is input or output normalized), time-slice
level, and whether a process is vintage or now, as seen in Figure 14 for the Electric Power
Processes in the DemoS_0012 model (by applying the Set Filter = ELE).
22
competing processes throughout the network, as shown in Figure 16 after clicking on ELC. A
Browse window with the data associated with the focus component is presented below the RES,
and may be rearranged by means of drag-and-drop, as was discussed earlier.
Topology
Declaration
Process Data
23
Topology
Declaration
Commodity
Data
The User Constraint (UC) view allows you to see components of the individual user
constraints, as shown in for the cross-region (global) CO2 limit constraint.
There is also a facility for examining the Commodity Groups, not shown here as DemoS only
employs the standard single commodity input/output groups created by VEDA2.0.
24
Declaration
Components
Data
25
Properties
There are 5 basic sections to the Run Manager, along with an additional form to compose a
Case once the specification is complete, as discussed here:
1. Scenario Group Designation: check BASE/SysSettings and the list of scenario to be
included in a “cluster” that is then given a name for inclusion later in a Case Definition
for a model run;
2. Settings: to designate where the GAMS and TIMES files reside, in what folder the model
is to be run, the Maximum number of runs that are to be submitted in parallel, the Solver
to be used and the Solver Options file to be employed;
3. Regions: designation of the regions to be included in the Group definition;
4. Properties: which GAMS switches are to be employed for the run, and
5. Cases: list of Cases prepared identifying the Run name/Description, Scenario Group, list
of regions, the Property specification to be used, period definition and ending year, and
date information.
The key mechanism for defining a Case is shown in Figure 19, which is presented in
response to hitting the New Case button under Manage Saved Cases, or double-click on a case in
the list to bring up that designation to edit or make to copy as a starting point for a new (similar)
Case definition. As can be seen the only new user input on the form is the Case Name and
Description, all other aspects of the run specification embodies in the Case must already be
defined and are thereby available from the associated pulldown menus. Thus one creates a new
case Create a New Case by providing the core information for the case definition (or start from
an existing Case):
➢ Case Name - case run name;
➢ Description - run description;
➢ Scenario Groups - scenarios to be included in this run;
26
➢ Region Groups - regions to be included in this run;
➢ Parametric Groups - driver scenario for a suite of runs;
➢ Properties Groups - what GAMS options/switch are to be employed;
➢ Periods Definition - what periods is the model be run for;
➢ Ending Year - what is the last period for the run;
➢ Source TIMES - where does the TIMES code reside;
➢ Solver - which solver is to be used;
➢ Solver Options - which solver options to use, and
➢ GDX References - gdx to be used, if appropriate
Double-clicking on a existing Case opens its Definition form. It can then be copied or modified
and resaved as desired.
Once a case has been fully specified a model run can be submitted by selecting the Case(s)
desired and hitting the button. This results in VEDA extrating the data from the intermal
database and placing the data dictionary (DD) files that contain the input for the TIMES GAMS
model generator into the designated work/run folder (the Log below). Once extracted a
27
Command Window opens, along the lines below, echoing the GAMS exectution steps and solver
actions, as seen below. [A series of other VEDA work windows may open / close along the way
as well.] As many jobs will be submitted in parallel as set on the RunManager Settings panel.
2.5.6 Results
Upon completion of a run the results are brought into the VEDA2.0 Results component,
opened from the StartPage, Modules menu or by pressing [F10]. The Results component is used
to analyze TIMES model results. Note that Results are all stored in the VEDA2.0 system
database. Therefore it is not possible to share results across users/computers, expect by running
the model or importing vd* files on the other computer.
The core facilities of the Results component of VEDA2.0 are:
➢ Model VD files: model results (VD files) are included automatically in the model
database at the end of a successful run (e.g. \Veda\GAMS_WrkTIMES\DemoS_012);
➢ Importing VD files from other models: to import model results from other models;
➢ Results browsing: to view (and refresh) model results through dynamic pivot tables
(cubes);
➢ Table definition: user defined tables for a specific model
(<model folder>/AppData/ResultsView.json), and
➢ Batch export: to export results in Excel and CSV.
28
An overview of the in Results component is shown in
Figure 21. Note that users of original VEDA can migrate their Sets and Tables (SnT)
definitions by means of the Veda_SnT to Excel migration utility found in the VEDA\VEDA
(new) root folder, and just requires the user identify to original SnT and VEDA2.0 model folder.
See
Note that after new model runs complete (even for existing Cases), the
Tools/Refresh Data needs to be invoked to bring in the new results!
Appendix A and B for the TIMES Results attributes and VD* files .
29
Figure 21. Components of the VEDA2.0 Result Facility
The Results component greatly facilitates digging to model results, across scenarios, by
means of powerful filtering, creation of table views of the data, presentation of the information in
dynamic cube (pivot) tables, enabling quick graphing of results, and exporting the cube to Excel
or CSV files. The layout of the basic Results form can be tailored as desired, and said layout will
be employed, until reset via the Tools/User Options/Layout Settings facility is invoked to reset
the layout. But the real power of the Results module stems for repopulating predefined tables that
organize the model results into logical tables for analyzing aspects of the solution results.
There are three main filtering mechanisms available to the user, shown in the initial layout of the
Resutls form in Figure 22. The columns identify the indexes corresponding to the dimensions of
the various TIMES results attributes.
30
Figure 22. Results Form Components
Data can be retrieved by checking individual Items in their lists, perhaps limited by a filter
criteria (with wild cards) typed into your yellow fields, and via the list of predefined tables. What
is then retrieved is then further controlled by where a Global Filter is active. Note that the table
definition is displayed in the upper right quadrant once the table is retrieved, as seen in Figure 23
for power plant capacity. Once the table is presented it can be rearranged as desired, for example
moving the scenario to the right of the row definition area to facility comparing scenarios. Note
that may be used to refresh the information presented and to save the current layout,
giving it a name. The list of previously saved layouts and data tables may be retrieved by means
of . Note that the Global Filter, most often used for Scenarios and/or periods, is activated by
Ctrl double-clicking in the checkbox for the elements constituting the filter.
31
Figure 23. Results Electric Power Plant Capacity Table
Another powerful facility in VEDA2.0 is the quick charting facility available in the Results
module. The user simply highlights the desired tables rows to be graphed and press the
button. Then by using the layout tool in VEDA2.0 one can position the cart alongside the
data, as seen in
Figure 24, and the chart then tailored by means of the Settings form.
32
Figure 24. Results Data and Chart
A very handy facility in the Results module is the ability to cascade thru the RES by means
of the ExRES feature. By placing the cursor on a Process or Commodity appearing in the data
table and using the right mouse Select Data/ExRES option that component of the RES will be
presented in a new window, along the lines shown in
33
Figure 26. Attribute Master Table
34
2.5.8 Managing Sets Specification XLS
Sets, both TIMES and user-defined, are a central part of TIMES and VEDA2.0 in that they
facilitate the grouping of RES components (commodities and processes) and thereby the
preparation of input data filtering and Results tables definition essential for effectively working
with TIMES. for analysis of results. The user establishes and maintains their Sets in the Sets-
<model> Excel workbook in the model root folder, the TIMES Sets membership is determined
by VEDA2.0 based upon how a component is defined to TIMES. There are separate sheets for
Commodities and Processes, the latter shown in Figure 27.
The Sets rule workbook is accessible via Navigator or better yet the
Tools/SetBrowser which presents the Set definition information via a VEDA2.0 cube (Figure 28,
TIMES Commodity on the left / User-defined Process on the right) for viewing using all the
filtering/tailoring of the information available throughout VEDA2.0.
35
Figure 28. Set Brower
For user-defned Sets double-clicking on a cell associated with a RES component / Region opens
the Sets-<model> workbook where said Set is defined. [Note, a more interactive tool for
managing Sets is under development.]
36
•Update TIMES Code – will check the web for the current version of the TIMES
GAMS model generator source code. Note that to use this code for new model
runs the Case definitions in the RunManager will need to be changed to the new
Source TIMES folder for each one to use said code.
• Delete Log / Flat File – get rid of Log files;
• Convert XLS to XLSX/M – to convert all templates to XLS/M files, which
VEDA2.0 prefers, creating a backup of the XLS instances;
• Jacobian Analysis – an Advanced feature to examine the spread of the coefficient
range for each model constraint, to assist with scaling of large models -beyond the
scope of the DemoS models.
• Import GDX/VD File – to bring the GAMS model input or TIMES reporting
results into the Browse viewer to examine.
• View License Information – shows the current status of the VEDA2.0 license and
facilitates to registering/updating of licenses.
➢ Reports – is an Advance facility for the creation of special results reports, beyond the
needs of the DemoS models.
37
007 DemoS_007 Adding complexity
008 DemoS_008 Split Base-Year (B-Y) templates by sector: demands by sector
009 DemoS_009 SubRES sophistication (CHP, district heating) and Trans files
010 DemoS_010 Demand projections and elastic demand
011 DemoS_011 User SETS in scenario templates
012 DemoS_012 More modelling techniques
The first step model is built using only two files: the default SysSettings file and one B-Y
Template (VT_REG_PRI_V01). The base year transformation file (BY_Trans) is created by
default; it is empty at this stage. Figure 29 shows the VEDA2.0 Navigator (see Section 2.3) for
the DemoS_001. This is the first window you will see when you first open it, or switch to it from
another model to the DemoS_001. Note that the 1st time you’ll also need to Synchronize the
model before proceeding to seed the VEDA2.0 database.
2
The meaning of all the attributes, along with their qualifier indexes, as said above can be found in
VEDA2.0, Information / TIMES Attributes.
38
Figure 29. Templates Included in DemoS_001
The RES of this first demo can be viewed in VEDA2.0 (by means of the Item Details see
Section 2.5.4), and it is shown in Figure 30. The RES shows an end-use demand device called
DTPSCOA, which uses as its input the commodity called COA. The COA commodity can be
also exogenously exported outside the model boundary with the export technology called
EXPCOA1. The production of the COA commodity is based on one import technology
(IMPCOA1) and on a three step local supply curve with the technologies MINCOA1,
MINCOA2 and MINCOA3. By double-clicking on any process the RES will cascade to it, then
that procedure can be continued by double-clicking on the input/output commodities associated
with the process.
The next two sections explain VEDA2.0 sheet-by-sheet for the two templates of this first
simple DemoS model how this TIMES model for delivering the commodity TPSCOA at the
39
minimum cost is built in VEDA2.0. Note that in the minimal model there is only one region and
two files.
3.1.1 SysSetting template
This file is used to declare the very basic structure of any VEDA-TIMES model, including its
regions, time slices, start year, etc. It also contains some settings for the synchronization process
and can include some additional information. In this example, this file contains the following
sheets:
➢ Region-Time slices;
➢ TimePeriods;
➢ Interpol_Extrapol_Defaults;
➢ Constants
➢ Defaults
The key SysSettings Options are shown in Figure 31, and discussed in the sections that
follow according to the sheet in the template they are found.
~BookRegions_Map
BookName Region ~DefaultYear ~StartYear ~ActivePDef ~TimePeriods
REG REG1 2005 2005 Pdef-1 Pdef-1
1
2
~TimeSlices ~Currencies ~DefUnits ~UnitConversion
Season Weekly DayNite Currency Option PRI from_unit to_unit multiplier
ANNUAL MEuro05 Process_ActUnit PJ Twh PJ 3.60
Process_CapUnit Pja Mt Kt 1000.00
Commodity_Unit PJ B Euro M Euro 1000.00
40
➢ ~StartYear is used to define the start year of the model (2005 for this example and all the
other steps).
➢ ~ActivePDef is used to select the set of active periods (Pdef-1, by default) from all those
defined in the following table.
➢ ~TimePeriods is used to specify period definitions by specifying the number of years for
each period. In this step, only a single period definition has been created (Pdef-1), which
contains 1 year for the first period (start year) and 2 years for the second period.
➢ ~DefaultYear is used to define the default year of the first period. It default to the
StartYear.
~StartYear ~ActivePDef
2005 Pdef-1
~DefaultYear ~TimePeriods
2005 Pdef-1
1
2
Figure 33. Start Year and Time Period Definition in SysSettings
41
• DISCOUNT - overall discount rate for the energy system, including for
depreciation of investments; this is a user input and in this example is 5% and is
constant for the entire modelling horizon, and
• YRFR - fraction of year for each time slice; this is a user input and in this
example is 100% for the single ANNUAL time slice.
42
➢ Defaults
➢ Commodity Group. (This sheet is not used in the basic DemoS. In general it can be used
to build user commodity groups.)
The key SysSettings Options are shown in Figure 37, and discussed in the sections that
follow according to the sheet in the template they are found.
~Currencies ~DefUnits ~DefaultYear ~StartYear ~ActivePDef
Currency Option PRI ELC IND RCA TRA 2005 2005 Pdef-11
MEuro05 Process_ActUnit PJ PJ PJ PJ kPk
Process_CapUnit Pja GW GW Pja 000_Units
Commodity_Unit PJ PJ PJ PJ kPk ~TimePeriods
Pdef-1 Pdef-5
~TimeSlices 1 1
2 2
Season Weekly DayNite
5
S D 5
F N 5
W P
R
43
Figure 39. Start Year and Time Period Definition in SysSettings
44
Figure 41. Global Constants Declarations in SysSettings
~TFM_Csets
CSET_SET CSET_CN CSET_CD SetName SetDesc
*SOLID* NRG_SOLID Solid Fuels
3.1.4 B-Y Template
The B-Y templates are used to set up the BASE scenario structure of the model, and in
principle it is possible to build a full model using just B-Y templates. This is the approach used
for this first example. Later when the model grows to include more commodities, technologies,
sectors, regions, and additional information to run different scenarios, we will demonstrate the
flexibility and modularity of VEDA2.0 using different types of workbooks to input information.
Each B-Y template in the DemoS examples contain worksheets that identify the RES
depicted and energy balance used. In this first example the B-Y Template (VT_REG_PRI_V01)
45
is used to set up the base-year process stock and the base-year end-use demand levels, such that
the overall energy flows reflect the energy balance.
3.1.4.1 RES&OBJ sheet
This sheet shows the RES covered and the normal completion of a run VEDA2.0with the
value of the objective function as reported at the end of the run in VEDA2.0 and the same value
in the Results table.
3.1.4.2 EnergyBalance sheet
This sheet contains the energy balance for the model start year (2005) for REG1 (Figure 43).
The energy balance in itself is not imported into the model; the table is not identified with any
VEDA table header (cell starting with the character “~”). However, it allows the user to calibrate
the model start year with appropriate historical energy flows. A typical energy balance comprises
two dimensions:
➢ Different types of energy commodities in columns. In this simple example, the different
types of energies are partially aggregated in categories (e.g. solid fuels, renewable
energies, etc.). The first row of the table includes codes defined by the modeller that are
used to name the energy commodities in the model.
➢ Components of the entire supply-demand chain is reflected in rows. This simple example
shows three main sections: primary energy supply, energy conversion and final energy
consumption. For each energy commodity, the primary energy supply minus the energy
used for conversion yield the remainder for final energy consumption. The first column
of the table includes codes specified by the modeller that are used to designate the
various sectors and then used as part of naming energy processes in a uniform manner in
the model.
46
Figure 43. Initial Energy Balance at Start Year (2005) for REG1 in DemoS_001
The portion of the energy balance that is developed in each step model is identified using the
color orange: here is this first step primary supply of solid fuels (COA).
Shares are provided below the energy balance table to split the total domestic production of
solid fuels (COA) into more than one step. This way, it is possible to set up in the model a supply
curve defined by the maximum production and cost of each step. A greater level of
disaggregation can be added along both commodity and sector dimensions using additional data
sources and user assumptions.
3.1.4.3 Pri_COA
This sheet shows how to declare commodities and processes (in their respective declaration
tables) and to describe specific supply processes (in a flexible import table): primary supply of
solid fuels (COA) in this example.
In any TIMES model, all commodities and processes in the model need to be declared once
in commodity tables (identified with ~FI_Comm) and process tables (identified with ~FI_
Process) with a structure as explained in Sections 2.4.2 and 2.4.3 and shown in Figure 44 and
Figure 45.
47
horizon (CUM), the annual cost per unit of energy (COST) and a bound on the annual
production (ACT_BND) for the start year 2005 and the following period 2006. Bounds
need to be combined with the LimType (UP), which is indicated in a specific column in
this example. When not specified, it is UP by default (see Attribute Master Table, Section
2.5.7).
➢ Import and export options are characterized with the COST and ACT_BND attributes.
48
Figure 48. Description of a simple demand processes
3.1.4.5 Demands
This sheet is used to specify the demand (DEMAND) value for the TPSCOA for the base
year 2005 (Figure 49). This value comes from the energy balance and represents the total final
COA consumption and the total consumed for energy conversion. This demand is constant over
the time horizon of the analysis due to the default interpolation/extrapolation applied to the
attribute Demand. The future values can be changed by specifying new inputs for the future
years/periods.
*Blue cells are linked to the energy balance. Here, the demand value is
equivalent to the sum of Total Conversion plus Total Final consumption.
Figure 49. Definition of Base Year Demand Values
49
Figure 50. VEDA2.0 Run Manager to Submit Model Runs
50
Figure 51. List of DemoS_001 Results Tables
51
Figure 54. Total System Cost in DemoS_001
• The Scenario label shows the scenario name (DemoS_001) for the run we are
viewing, while under the column Region we see the region name (REG1) and the
value of the objective function. The column Total is shows the total by row (over
regions). In this case, we only have the single region REG1, so the value is the
same.
• The _SysCost table provides a key model run indicator. In TIMES models, the
Objective-Function is to minimize the total discounted cost of the system,
properly augmented by the ‘cost’ of lost demand (when using the elastic demand
features). See Parts I and II of the TIMES documentation for more on the model
objective function.
➢ All costs
• This table can be used to show the undiscounted cost elements of the model
solution (Figure 55).
52
Figure 56. All System Costs Results by Component
•The attribute column in this case shows both the attribute name and description,
while the Period columns show the value of each attribute in each model period,
except the salvage value (Cost_Salv), which does not take a period index.
➢ Demands
• The Demands able (Figure 57) is used to show the energy service demand(s). In
this case there is only the single demand called TPSCOA, which is in PJ (Figure
58).
53
➢ Fuel Supply
• The Fuel Supply table (Figure 59) is built selecting the attribute VAR_FOut (flow
out) and the process set IRE (that includes all the process defined in
~FI_PROCESS tables as MIN, IMP and EXP). In other words, this table can be
used to check the output from all the processes that belong to import and mining
sets. The export process is characterised with an input and not an output, so it not
possible to check the behavior of the export process by selecting only VAR_FOut.
• The COA demand is met in a significant proportion with imports (6,462.67 PJ)
and the rest with domestic resources through the first two steps of the supply
curve. (The third step is not used, because it has higher COST than the imports,
see Figure 60.) The demand and supply balance of COA is constant between 2005
and 2006, as described above in Section 3.1.4.5.
54
Figure 60. Fuel Supply results by process and period
➢ Prices
• The Prices_All table (Figure 61), built selecting the attribute EQ_CombalM, can
be used for showing commodities’ marginal prices in the run.
55
devices in each sector. Emission commodities (e.g. CO2) and emission tracking are also
introduced at the end-use device level in both the residential and transport sectors.
Attributes Introduced Files Updated
STOCK VT_REG_PRI_v02
ENV_ACT
START
Files. The second step model is built by modifying the B-Y Template (VT_REG_PRI_V02)
to add processes as well as energy and emission commodities. The SysSettings file is the same as
in the DemoS_001.
3.2.1 B-Y Templates
3.2.1.1 EnergyBalance sheet
The energy balance is the same as in the first step although a larger portion is covered in this
second step model (Figure 63). In addition to the primary supply of solid fuels (COA), the model
covers the primary supply of natural gas (GAS) and crude oil (OIL) as well as the demand for
GAS and OIL in the residential and transportation sectors (rather than for the aggregated primary
supply as for COA).
A higher degree of disaggregation is also provided. On the supply side, the same level of
disaggregation as for COA is provided for GAS and OIL, with shares to split the total domestic
production in more than one step. On the demand side, fuel consumption is split by sector and by
end use in the residential sector (space heating, appliances, and other). GAS is allocated at 100%
to the Other end use in the residential sector and OIL at 100% to the single end use D1 in the
transportation sector.
56
Figure 63. Energy balance at start year 2005 for REG1 – Covered in DemoS_002
3.2.1.2 Pri_COA/GAS/OIL sheets
These new Pri_GAS and the Pri_OIL sheets have exactly the same structure as the Pri_COA
sheet (which has not been modified from the first step) including:
➢ A commodity table to declare additional energy commodities (NRG): GAS - Natural gas
(PJ) and OIL - Crude oil (PJ).
➢ A process table to declare additional supply options for GAS and OIL: mining processes
(MINGAS* and MINOIL*), import processes (IMPGAS1, IMPOIL1), and export
processes (EXPGAS1, EXPOIL1).
➢ A flexible import table to describe the primary supply options for GAS and OIL: 3-step
domestic supply curves through three mining processes, as well as import and export
options. All are characterized with the same attributes.
57
services in the base year as given by the energy balance and the additional fuel split
assumptions. They also have an efficiency (EFF), an annual availability factor (AFA) and
a life time (LIFE).
➢ Existing processes characterised in VEDA B-Y Templates with a base year STOCK can
not increase their capacity endogenously through new investment because when
synchronizing the templates, by default VEDA2.0 inserts the attribute NCAP_BND with
interpolation/extrapolation rule number 2, setting an upper bound of EPS (epsilon, or
effectively zero) for all years. (For more information on interpolation/extrapolation see
Table 8 in Section 3.3.2.2) New technologies thus are needed to replace the existing
capacity as it retires or increase the amount of capacity available after the base year.
➢ The new processes do not have an existing installed capacity, but they are available in the
database to be invested in to replace the existing ones and meet the demand for energy
services. They are characterized with an investment cost (INVCOST), a fixed operation
and maintenance cost (FIXOM), and the year in which they become available (START).
The model can invest in these new technologies only beginning in that START year.
➢ Finally, emission commodities (ENV) are also introduced along with these processes:
CO2 emissions in the residential (RSDCO2) and the transport (TRACO2) sectors in this
example (in kt). An emission coefficient (ENV_ACT in kt/PJoutput) is provided for each
process based on the technology output. It is also possible to define emissions
coefficients based on fuel input (see Section 3.7.2.7).
58
available at this second step is CO2 emissions by sector (Figure 68), which are computed from
the input coefficients provided for each process and the activity of each process. These three
tables can be viewed in the same way as explained for DemoS_001, and if results for both
DemoS_001 and DemoS_002 have been imported, then it will be possible to see and compare
results for the two scenarios. [Note that in order to get the DemoS_001 results into the
DemoS_002 database the Tools/Import VD files option must be used to grad them from the
GAMS_WrkTIMES subfolder for the model.
The main findings from the results analysis are:
➢ The domestic demand for transportation (DTC1) represents the major proportion (44%)
of total domestic demand for energy. This sector relies on oil and also accounts for the
largest part of the CO2 emissions (TRACO2), although no coefficient was provided for
solid fuels combustion emissions.
59
Figure 67. Results – Fuel Supply Results Table for DemoS_002
➢ The demand for residential–other (DROT) and transportation (DTC1) is first fully
satisfied with the existing demand processes (ROTEGAS and TOTEOIL) in the base year
2005, but the new demand processes (ROTNGAS and TOTNOIL) start penetrating in
2006. The new processes are more efficient and require less energy to satisfy the demand.
The existing processes satisfy less demand in 2006 because their STOCK in 2006 is
lower than in 2005. The STOCK decreases between the base year value and zero linearly
over the technical LIFE. For example, for ROTEGAS the base (2005) stock is 5486 PJ
and will be zero in 2015 (because the residual technical life is 10 years). The stock value
between 2005 and 2015 is linearly interpolated between 5486 PJ and 0 PJ.
➢ A large proportion of the oil imported in 2005 is destined to export markets (exports
reach their upper limit because the export price is no higher than that of the marginal oil
supply, the import price), while in 2006 the demand from export markets decreases to
zero and more oil is produced domestically to meet the domestic demand for
transportation oil.
60
Figure 68. Results – Emissions by Sector Results Table for DemoS_002
61
Figure 70. Marginal Price of Process Activity Table in DemoS_002
62
Files. The third step model is built by modifying:
➢ the SysSettings file to add more time periods and declare the transmission efficiency of
the electricity network.
➢ the B-Y Template (VT_REG_PRI_V03) to model the power sector and insert
interpolation/extrapolation rules.
3.3.1 SysSettings file
3.3.1.1 TimePeriods sheet
The ~TimePeriods table is used to extend the time horizon of the model by adding three
active periods of five years each (Figure 71). These specifications are saved as a new time period
definition (Pdef-5). The time horizon is extended to 2020, with the milestones years being 2005,
2006, 2010, 2015 and 2020.
63
Figure 73. Energy Balance at Start Year (2005) for REG1 – Covered in DemoS_003
3.3.2.2 Pri_COA/GAS/OIL sheets
These sheets were all modified in a similar way to show the use of interpolation/extrapolation
rules in VEDA-TIMES (Figure 74). With the introduction of the interpolation/extrapolation
rules, it is possible to run the model for a longer time horizon without having to declare data
values for all periods up to 2020.
To activate an interpolation/extrapolation (I/E) rule for a specific process, insert a data row
and write a "0" as the Year. In this example, an interpolation/extrapolation rule will be enabled
for the processes MINCOA1, MONCOA2 and EXPCOA1. Then, an interpolation/extrapolation
code is indicated under the attribute. In this example, option 5 will be applied to the activity
bound (ACT_BND) of these processes. The option codes for the interpolation/extrapolation rules
are presented in Table 8. The code 5 means full interpolation and forward extrapolation of the
attribute.
In this example, MINCOA1 has an activity bound of 6074 PJ in the year 2005, and due to the
I/E rule, the 2005 value is kept constant over the time horizon. Just remember that the
ACT_BND is not I/E by default, so when no I/E rule is explicitly specified in the template, the
bound will be applied only to the periods defined in the year column.
Default interpolation/extrapolation mechanisms are embedded in the TIMES code itself (for
more information see Section 3.1.1 of Part II of the TIMES documentation). It is also useful to
check the Attribute Master table in VEDA2.0 (see Section 2.5.7) for more information about
which attributes are interpolated/extrapolated by default and which are not.
64
Figure 74. PRI_COA Sheet with Interpolation/Extrapolation Rules
65
Figure 75. Description of New Supply Options
3.3.2.4 Sector_Fuels sheet
Additional sector fuel processes (FTE-*) are defined and characterized in this sheet, namely
to produce the electricity sector fuels from primary fuels, including fossil fuels (e.g. COA to
ELCCOA) and other sources (e.g. NUC to ELCNUC). The same approach is used to declare the
new commodities and processes in their respective tables.
3.3.2.5 Con_ELC sheet
A series of processes are created to represent different types of power plants (Figure 76).
These are conversion processes that consume electricity sector fuels (ELCGAS, ELCNUC, etc.)
to produce electricity (ELC).
➢ The existing processes are characterized with their existing installed capacity (STOCK)
in GW (calculated from the information given in the energy balance in terms of energy
consumption for electricity production and technical attribute values). They also have an
efficiency (EFF), an annual availability factor (AFA), fixed and variable O&M costs
(FIXOM, VAROM), a life time (LIFE), and a CO2 emission coefficient (ENV_ACT).
➢ By default, all attribute values apply to the base year 2005 when not specified. It is
possible to declare any attribute values for future years using the command "~" followed
by the year, as for the installed capacity attribute in this case (STOCK~2030). By default,
an existing installed capacity (STOCK) decreases to zero at the end of its lifetime (e.g.,
after 30 years for ELCTECOA00). By specifying an installed capacity value for 2030, as
for ELCTENUC00, a new retirement profile is defined (constant in this example), and it
is not necessary to specify a life duration.
➢ The new processes do not have an existing installed capacity, but they are available in the
database to be invested in to replace the existing ones and meet the demand for
electricity. They are characterized in addition with an investment cost (INVCOST) as
well as the year where they become available (START).
➢ A new attribute is introduced (CAP2ACT) allowing the conversion between the process
capacity and activity units. In this example a coefficient of 31.536 PJ/GW is needed
(1GW * 365 days * 24 hours = 8760 GWh = 31.536 PJ). When not specified and when
both capacity and activity are tracked in the same unit, the CAP2ACT is equal to 1.
The same approach is used to declare the new commodities and processes in their respective
tables (Figure 77) including the declaration of existing and new power plants as ELE processes.
The process names follow a convention where T=thermal, C=CHP, R=Renewable, N=Nuclear.
66
Figure 76. Existing and New Power Plants
3.3.2.7 Demands
The end-use demand table is expanded to include the demand for electricity (TPSELC) in the
base year as well as for future years (Figure 79). While the demand for other fuels or for energy
67
services will be kept constant over time (extrapolated at a constant level by default), the demand
for electricity is set up to increase by an annual growth rate of 1% through 2020.
Figure 79. Definition of base year and future years demand values
3.3.3 Results
The demands for energy and energy services are extended to the 2020 horizon (Figure 80),
increasing by 1% per year (TPSELC) or remaining constant (all others). The effects of the
interpolation/extrapolation rules applied on the activity bound of certain supply processes can be
seen below (Figure 63). The activity of the first two mining processes (first two steps of the
domestic supply curves) for fossil fuels (COA, GAS, OIL) is controlled by the annual activity
bound (set constant for each period by the interpolation rule) and the cumulative bound (CUM).
The combination of these two conditions leads to a significant increase in imports to meet the
growing demand for energy. Exports are also kept constant using the same
interpolation/extrapolation rules. More primary supply options exist now with the addition of the
electric fuels such as nuclear and renewables.
Results from the new electricity sector are introduced (Figure 82 and Figure 83). The total
generating installed capacity increases from 466.3 GW in 2005 to 541.6 GW in 2020. Most of
this increase is coming from new coal-fired power plants (ELCTNCOA00), the most expensive
process but the least expensive fuel. The installed capacity of nuclear and renewable power
plants remain constant as specified in the B-Y Template. Electricity production is coming mainly
from fossil fuels (64%), with a smaller contribution from nuclear (26%) and renewables (9%).
The oil plants are working only in the base year, as calibrated to the energy balance, because the
fuel is too expensive compared to the other available options.
68
Figure 80. Demand Results Table in DemoS_003
69
Figure 82. Electricity Plants Capacity Results Table in DemoS_003
70
interpolation/extrapolation specifications can be moved to the SysSettings file and applied to all
instances of an attribute in the model using a single declaration.
Attributes Introduced Files Updated
PEAK SysSettings
COM_FR VT_REG_PRI_v04
Discount Files Created
COM_PEAK Scen_Peak_RSV
COM_PKRSV Scen_Peak_RSV-FLX
COM_PKFLX
71
Figure 85. New Time Slices Definition in SysSettings
3.4.1.2 Interpol_Extrapol_Defaults
A table is added for setting the default interpolation/extrapolation rules (
Figure 86). A transformation table used to update pre-existing data (~TFM_MIG) in a rule-
based manner, it sets the default interpolation/extrapolation rule, indicated by the 0 in the Year2
column, for the attribute defined in the Attribute column and all the processes defined in the
model. In this case, this is the same interpolation/extrapolation rule used for each of the supply
processes (see Figure 30) in the B-Y Template. It is now moved into the SysSettings file and
applied to the activity bound (ACT_BND) of all processes at once.
~TFM_MIG
LimType Attribute Year2 AllRegions Pset_PN
UP ACT_BND 0 5
3.4.1.3 Constants
The existing transformation table is also used to insert new constants in the model: fractions
of year for the new time slices (YRFR) replace the single ANNUAL time slice (100%) as
declared in the previous steps (Figure 87). The timeslice name is identified in the first column
(TimeSlice), while their fractions (for the attribute called YRFR) over one year are declared for
AllRegions as for the other constants of the model. The fraction values, as with any other input
in the model, are the user’s responsibility. In this case, it is important that they sum to 100%.
72
➢ Their contribution to peak (Peak), i.e., the fraction of a process’s capacity that is
considered to be secure and thus will most likely be available to contribute to the peak
(and reserve capacity) load in the highest demand time-slice of a year for a commodity
(electricity or heat only). In this case, the capacity contribution of all thermal and nuclear
power plants is 100%, while the capacity contribution of the renewable power plant is
50%. Indeed, many types of supply processes can be regarded as predictably available
with their entire capacity contributing during the peak and thus have a peak coefficient
equal to 1 (100%), whereas others (such as wind turbines or solar plants) are attributed a
peak coefficient less than 1 (100%), since they are on average only fractionally available
at peak. (E.g., a wind turbine typically has a peak coefficient of 0.25 or 0.3 maximum).
Another important change to mention is the start year of one new process (ELCTNOIL00)
that can be installed from the 2005 base year to cover the additional capacity needed for the
reserve equation (5%), as defined in the scenario files.
73
Figure 89. Declaration of Time Slice Level for Electricity Commodity
3.4.2.2 Pri_COA/GAS/OIL
These sheets were all modified back to remove the interpolation/extrapolation rules: the flag
to activate an interpolation/extrapolation rule (additional rows with a "0" as the Year) and the
rule code in the attribute column.
3.4.2.3 Demands
A table is added to define the load curve of the demand for electricity (TPSELC) in the base
year, which will also apply for future years (Figure 91). The attribute (COM_FR) is introduced
to declare the fraction of the electricity demand occurring in each time slice.
74
Figure 92. Demand Technology Producing TPSELC
75
3.4.4 Results
Three cases are solved with this step model, with a different selection of scenario files
(Figure 94): the DemoS_004 case is solved using only the two components (BASE, SysSettings),
while the DemoS_004a case is solved adding one scenario file (Peak_RSV), and the
DemoS_004b case is solved adding the other scenario file (Peak_RSV-FLX). The different
Cases in the Run Manager can be selected individually to run a single Case or multiple Cases
selected to be submitted in parallel (i.e., the cases will be launched automatically by VEDA2.0
one after the other) to TIMES.
76
The electricity price varies across years and time slices (Figure 96).
77
(ELC) commodity in any time slice by a certain margin, so the dual value of the peak equation
describes the premium consumers have to pay in addition to the commodity price (dual value of
EQ_COMBAL) during the peak time slice (SD in this case) to ensure adequate system capacity.
The peak marginal is similar, though not identical, when using COM_PKRSV and
COM_PKFLX, owing to the differences in how they are applied in the TIMES equations.
Figure 97. Slack and Dual Values of the Peak Equations in DemoS_004
Objective-Function = 3,187,361 M euros (see the _SysCost table). This cost is only slightly
higher with the peak reserve requirement and the additional investments in generating capacity:
3,211,296 M euros.
3.5 DemoS_005 - 2-region Model with Endogenous Trade (compact
approach)
Description. At the fifth step, the model evolves from being a single region model to become
a compact multi-regional model (2 or more regions in the same set of B-Y Templates). This
approach is relevant when all the model regions are under the control of a single individual.
Objective. The objective is to create the multi-regional model framework typical to larger or
more complex models, namely the trade matrix that allows the modelling of energy trade
movements (uni-directional or bi-directional trade between two regions). Another objective is to
demonstrate how to limit emissions from a sector in a particular region or from the entire energy
system of all regions through emission bounds or user constraints. Scenario variants illustrate the
impact of a cap on CO2 emissions from the electricity sector only and of a cross-region user
constraint on the total CO2 emissions from the transport and electricity sectors.
Attributes Introduced Files Updated
COM_BNDNET SysSettings
UC_RHSRTS VT_REG_PRI_v05
UC_COMNET Files Created
78
Scen_TRADE_PARAM
Scen_ELC_CO2_BOUND
Scen_UC_CO2BND
Files Removed
Scen_Peak_RSV-FLX
79
3.5.2 B-Y Templates
3.5.2.1 EnergyBalance, EB1, EB2
The energy balance is disaggregated between two regions (Figure 100) using shares on
production, conversion, and final consumption of various energy commodities: REG1 becomes
producer and consumer of solid fuels (100%), crude oil (30%) and renewable energies (100%),
while REG2 becomes producer and consumer of natural gas (100%), crude oil (70%), and
nuclear energy (100%). The same portion of the energy balance as in the fourth step is used in
this fifth step model.
Figure 100. Energy balance at start year 2005 for REG1 & REG 2–Covered in DemoS_005
80
3.5.2.2 Pri_COA/GAS/OIL
These sheets are updated to include two regions and to regionalize some process attributes.
There are several ways of accounting for the regionalization of some attributes. For instance, it is
possible to insert a Region column on the left side of any ~FI_T table and to indicate in which
region(s) the process is available (Figure 101). A process can be available in only one region
(e.g. MINGAS* and IMPGAS1) or in several regions (EXPGAS1). In this later case, different
rows can be inserted to declare different values for some of the attributes (ACT_BND of
EXPGAS1); the values that remain on the initial row will apply to all regions (COST of
EXPGAS1). The additional rows approach is mainly used when all attributes of a process vary
across regions.
In the process table (~FI_ Process), the region where each process is available can be
specified (Figure 102): MINGAS* and IMPGAS1 processes exist only in REG2, while the
EXPGAS1 process exists in both regions (by default, when the Region column is empty, it
applies to all regions). Comma-separated entries are also allowed, for instance, when a process
exists in more than one region but not in all regions.
81
3.5.3 Trade files
Two trade files are created to model the energy trade movements between the two regions.
Figure 104. Examples of trade matrix for bilateral and unilateral links
3.5.3.2 Scen_Trade_Param
In this file, a transformation table ~TFM_INS is used to insert new attributes for trade
processes (Figure 105), for example: an investment cost (INVCOST) for all unilateral trade
processes (TU_*). Trade processes are created automatically after the user declares unilateral or
bilateral links between regions in the _Trade_Links file.
82
3.5.4 Scenario files
Two more scenario files are created to insert new information in the RES that can be retained
or not in the configuration of the model at the time of solving the model. Of the previous
scenario files, only the Scen_Peak_RSV file is retained for further analysis.
3.5.4.1 Scen_ELC_CO2_Bound
This file is used to introduce a bound (limit) on the CO2 emissions from the power sector in
REG1. A transformation table ~TFM_INS is used (Figure 106) to declare an upper bound on
annual emissions (Attribute = COM_BNDNET; LimType = UP), on the CO2 emissions from the
electricity sector only (ELCCO2) in REG1. In this example the upper bound is calculated as a
percentage reduction target from the power sector CO2 emissions in a reference scenario for
2010 (10% = 993,548 kt) and 2020 (20% = 1,017,340 kt). It is necessary to run the step model
without any limit on emissions first to get the reference emission trajectory (run DemoS_005)
and to calculate the bounds as a reduction target from the reference emissions. An interpolation
rule is used with the "0" flag in the Year column and the interpolation/extrapolation option in the
region column where the bounds are declared. The code 5 means full interpolation and forward
extrapolation.
83
➢ ~UC_Sets: T_E: The constraints are imposed to each time period individually. There is
no banking or borrowing between periods.
The table level declaration following the table tag (~UC_T:UC_RHSRTS) indicates that any
column without an index will be interpreted as the right hand side of the constraint, in this case,
the indicated bounds in REG1 and REG2 in the given years. This right hand side bounds 1 times
the net production (UC_COMNET) of the sum of TRACO2 and ELCCO2. The
interpolation/extrapolation option 5 indicates full interpolation and forward extrapolation.
3.5.5 Results
Three cases are solved with this step model, with a different selection of scenario files: the
DemoS_005 case is solved without any limit on CO2 emissions and using only the three main
components (BASE, TRADE_PARAM, SysSettings), while the DemoS_005a case is solved
adding one scenario file (ELC_CO2_BOUND) to put a limit on CO2 emissions from the REG1
power sector, and the DemoS_005b case is solved adding the other scenario file
(UC_CO2_BND) to put a limit on both the power and the transportation sectors in both regions.
A first sample of results shows the different configuration of the energy supply systems in the
two regions (Figure 108). As mentioned earlier, the REG1 becomes the main provider of solid
fuels, renewable energies and some crude oil (from both domestic production and imports).
REG1 is also getting electricity from REG2. REG2 becomes the main provider of natural gas,
nuclear energy and some crude oil (from both domestic production and imports).
84
➢ With a limit on the CO2 from both the power and the transportation sector in REG1 and
in REG2 (DemoS_005b), all the emission reductions are coming from the power sector in
both regions. Emissions from the transportation sector are not affected compared with the
reference case (DemoS_005) meaning that the power sector of both regions could provide
enough reduction options at a lower cost to meet the target. Because there is no trading in
emissions between regions, REG2 must cut back on its electricity generation from natural
gas, and it begins importing natural gas-fired electricity from REG1, which in turn
imports natural gas from REG2 (Figure 110).
85
Figure 110. Endogenous Trades in DemoS_005
86
limits for the power sector (3,206,161 M euros) and 1.4% higher with the emission limits for the
power and the transportation sectors (3,250,281 M euros). More details about the impacts of the
emission limits on the different cost components of the system in each region are shown below
(Figure 112).
87
3.6 DemoS_006 - Multi-region with Separate Regional Templates
Description. At the sixth step, the configuration of the multi-regional model developed
previously shifts from a single set of B-Y Templates for all regions to a separate sets of B-Y
Templates for each region. This approach is relevant when the model regions are under the
control of more than one individual.
Objective. The objective is again to create the multi-regional model framework typical to
larger or more complex models, with the trade matrix and limits on emissions of all regions, but
additionally to introduce the concept of technology repositories (i.e., SubRES) that include a
number of new processes (in competition) that are available in the database to replace the
existing ones at the end of their lifetime or to meet an increasing demand.
The motivation behind these repositories is mainly to avoid repeating the new process
specifications for each region; all attributes specifications apply to all regions unless a
transformation file is used to regionalize some values when necessary.
Simultaneously, the role of the vintage feature is illustrated to handle processes for which
characteristics change over time (other than investment cost) when new capacity is built. As in
step 5, the scenario variants illustrate the impact of a cap on CO2 emissions from the electricity
sector only and of a cross-region user constraint on the total CO2 emissions from the transport
and electricity sectors.
Attributes Introduced Files Updated
N.A. SysSettings
Files Created
SubRES_NewTechs
VT_REG1_PRI_v06
VT_REG2_PRI_v06
Files Replaced
VT_REG1_PRI_v05
Files. The sixth step model is built 1) by modifying the SysSettings file to add one B-Y
Template, 2) by replacing the B-Y Template (VT_REG_PRI_V05) by two B-Y Template
(VT_REG1_PRI_v06, VT_REG2_PRI_v06) to disaggregate the energy balance between two
regions in two separate files, and 3) by creating a SubRES file to add new processes to the model
(Figure 113). Note that for the rest of this manual the region templates will be stated as REG1/2,
rather than listing each separately.
88
Figure 113. Templates Included in DemoS_006
3.6.1 SysSettings file
3.6.1.1 Region-Time Slices
The ~BookRegions_Map table is used to create one additional workbook: one for each region
REG1 and REG2 (Figure 114).
89
models with multiple regions because a single set of declarations can be made for all regions.
The SubRES file includes one sheet for each sector: PRI_ELC, PRI_RSD, PRI_TRA,
PRI_FuelSec. (Due to the way SubRES are processed in VEDA2.0, it is required that the name
of each sheet start with a valid name of one of the model sectors, as defined in the names of the
B-Y templates. In this case, PRI is the only such model sector, and so all sheets in the SubRES
template begin with PRI_.)
With this approach, the B-Y Templates now include only processes with existing capacity in
the base year 2005, and all new processes are defined in the SubRES. Duplicate definition should
be avoided. The new power plants are now declared in this file without any regional specification
(Figure 115). Other new processes are created in the other sheets following the same rules: new
processes do not have an existing installed capacity, but they are characterized with an
investment cost (INVCOST) as well as the year where they become available (START).
The role of the vintage feature is illustrated to handle processes for which characteristics
other than investment cost change over time when new capacity is built., In this example, the
new gas-fired power plant (ELCTNGAS00) has its efficiency and emission coefficient evolving
between 2006 and 2020. The process ELCTNGAS00 is vintaged (Vintage=Yes) in the
~FI_Process table (Figure 116).
Figure 116. Example of a new process with vintage tracking in the SubRES file
3.6.3.1 SubRES_NewTechs_Trans
For each SubRES_<user-name> file, there is an associated SubRES_<user-name>_Trans file.
The transformation files contain the mapping and transformation operations that control the
inheritance (or not) of new processes into the various regions of the model, as well as to change
any process characteristics, such as investment costs, by region. In this example, the file is
empty, so all new processes in the SubRES are available in both regions with identical
characteristics.
3.6.4 Results
The results are very similar to those obtained with the previous step model since most of the
changes occurred in the way the information is structured in different files rather than in the
energy system itself. However, the impact of the vintage feature for the new gas-fired power
plants is illustrated (Figure 117).
90
Figure 117. Fuel Supply by Region in DemoS_005
Objective-Function = 3,205,281 M euros (see the _SysCost table) with 1,293,017 M euros
for REG1 and 1,912,264 M euros for REG2. These costs are similar to those computed with the
previous step model DemoS_005.
3.7 DemoS_007 – Making DemoS More Robust
Description. The seventh step model is enhanced to capture more components of the energy
balance, leading to a more comprehensive representation of the RES with more complex
processes.
Objectives. The objective is to show how to model a more comprehensive RES covering
more details of the energy balance with more complex processes along its two dimensions:
number of commodities and the number of transformation steps in the whole supply-demand
chain. In this step refined petroleum products are broken out into different commodities (e.g.,
gasoline, diesel, heavy fuel, etc.) to better describe the transport sector, where different types of
vehicles are introduced. This enhancement of the RES requires the modelling of additional and
more complex processes (e.g., refineries and dual demand cars) and the need to introduce the
primary commodity group (PCG) concept.
Several more techniques are also introduced in this step:
➢ We present an easier way to account for combustion-based emissions, by directly linking
emission coefficients with each unit of fuel burnt.
➢ We illustrate how to build end-use demand projections starting from base year values and
different growth rates. This is done using the fill table feature to grab base year
information from the initial files (e.g. B-Y Templates).
➢ We show how to build a user constraint that specific the minimum (or maximum) annual
growth rate for a set of processes using the CAP, GROWTH attribute.
91
➢ Finally, we demonstrate how to use the elastic demand feature of TIMES, including how
to generate the file containing the demand prices for base scenarios and how to use these
prices for the constrained scenarios.
Attributes Introduced Files Updated
Share SysSettings
ACTFLO VT_REG1/2_PRI_v07
COM_VOC SubRES_NewTechs
COM_STEP Files Created
COM_ELAST Scen_DemProj_DTCAR
UC_CAP Scen_Refinery
Scen_ElasticDem
Scen_TRA_CO2_BOUND
Scen_UC Growth
92
Figure 118. Templates Included in DemoS_007
3.7.1 SysSettings file
3.7.1.1 Interpol_Extrapol_Defaults
More interpolation/extrapolation rules are added to the transformation table (Figure 119). The
same interpolation/extrapolation rule (number 5) is also used for the maximum input shares
(Share-I) and the maximum output shares (Share-O) of all processes at once. These new
attributes are defined in the next section.
~TFM_MIG
LimType Attribute Year2 AllRegions Pset_PN
UP ACT_BND 0 5
UP Share-O 0 5
UP Share-I 0 5
93
of the number of transformation steps in the whole supply-demand chain, with the addition of the
refining step.
Figure 120. Disaggregated Initial Energy Balance (2005) for REG2 in DemoS_007
94
Figure 121. Refinery
In a simple process, one consuming a single commodity and producing a single commodity,
the modeler simply chooses one of these two flows to define the activity, and thereby the process
normalization (input or output). In complex processes, with several commodities (perhaps of
different types) as inputs and/or outputs, the definition of the activity variable requires
designation of the PCG to serve as the activity-defining group. The PCG is defined as a subset of
the commodities of the same nature entering or leaving a process. For instance, the PCG may be
the group of energy carriers, or the group of materials of a given type, on either the input or
output side of the process. More about PCGs and their use can be found in Section 2.2.1 of Part
II of the TIMES documentation.
VEDA2.0 establishes default PCGs for any process involving multiple inputs and/or outputs,
based upon the assumption first that all processes are output normalized and then according to
the commodities’ nature. In case of different commodity types on the output (or input) side, the
default PCG is based on the following order:
➢ DEM – demands;
➢ MAT – materials;
➢ NRG – energy;
➢ ENV – emissions, and
➢ FIN – financial.
However, in some cases it is desirable/necessary to override these defaults, for instance to
normalize a process with energy commodities inputs (NRGI) as for the refinery in this example.
Indeed, the activity of a refinery is usually characterized based on the barrels of crude oil
consumed.
95
3.7.2.4 Sector_Fuels
Additional sector fuel processes (FTE-*) are defined and characterized in this sheet (Figure
124), namely to produce the transportation sector fuels from primary refined products (e.g. GSL
to TRAGSL). It is not always relevant to keep track of all primary fuels in a sector; multiple
primary fuels can be aggregated into a single sector fuel in this case. In this example, several
refined products are aggregated into a single electricity sector fuel (via FTE-ELCOIL). When
more than one primary fuel are used to create one sector fuel, the shares of input fuels (Share-
I~UP) need to be provided. As with Share-O, the maximum input shares may sum to greater than
100%, if desired, to provide some process flexibility.
Figure 124. Additional Sector Fuel Processes with Multiple Input Commodities
3.7.2.5 DemTechs_TRA
The single demand process consuming an energy commodity (TRAOIL) and producing
directly the transport demand commodity (DTD1) is replaced with more sophisticated processes
representing cars and characterized with non-energy units (Figure 125). The declaration of these
processes is shown below (Figure 126): their activity units are in billions passengers-kilometres
96
(BpK) rather than PJ, and their capacity units are in thousands of units (000_units) rather than
PJa.
➢ The existing processes are characterized with their existing installed capacity (STOCK)
in thousands of car units (000_units) as indicated above. The stock values correspond to
the amount of fuel consumption (e.g. TRADSL) required to produce the transportation
demand (DTCAR) as given by the energy balance and taking into account the efficiency
(EFF), the annual availability factor (AFA) and the conversion between capacity unit and
activity unit (CAP2ACT).
➢ The efficiency (EFF) is specified in terms of billions of vehicle-kilometres per petajoule
(BVkm/PJ), and can be interpreted as the number of kilometres a vehicle can travel with
1 PJ of energy.
➢ The annual availability factor (AFA) represents the average thousand kilometres ('000
km) a car is traveling each year.
➢ A new attribute is introduced to capture the relation between the process activity and the
commodity flow (ACTFLO), the commodity being the output demand, in terms of
passengers per car unit (Passenger/Car). This TIMES parameter requires an additional
index that is the specification of the commodity group: DEMO (demand out) in this
example.
➢ The life time (LIFE) is specified in number of years as for the other processes.
➢ The conversion factor between capacity unit and activity unit (CAP2ACT) is not equal to
1 because the units are different: the activity is in billion vehicle-kilometres, the stock is
in thousands of units (000_units or vehicles) and the utilization factor (AFA) is in
thousand kilometres per vehicle. The CAP2ACT is translating mvkm into bvkm.
97
➢ Demand (Bpass*km) = STOCK (000_units) * AFA (000_vehiclekm/unit) *
ACTFLO~DEMO (Passengers/vehicle)* CAP2ACT(0.001bvkm/mvkm)
98
example, the table is collecting the base year values (YEAR=2005) from the B-Y templates
(Scenario = BASE) for the transportation demand (Attribute=Demand) by cars (commodity =
DTCAR). VEDA2.0 fills in the REG1 and REG2 values in the blue highlighted cells each time
the template is SYNCed.
Figure 129. Grab Base Year Demand Values from B-Y Templates - Transportation
The DTCAR demand is then projected to 2020 in the ~TFM_INS table using the base year
values and some multipliers (2% for REG1 and 3% for REG2) defined by the user (Figure 130).
Figure 130. Using Base Year Values to Project End-use Demands - Transportation
3.7.4.2 Scen_Refinery
This scenario file is created to update refinery attributes, again using a fill table to grab
information from B-Y templates (Figure 131). In this example, the table is collecting the base
year values (YEAR=2005) from the B-Y templates (Scenario = BASE) for the activity
production bound (Attribute=ACT_BND) of the refinery (process = REFEOIL00).
Figure 131. Grab Base Year Activity Level from B-Y Templates - Refinery
The activity production is then projected to 2020 in the ~TFM_INS table using the base year
values and some relaxation factors (25% for REG1 and 30% for REG2) defined by the user
(Figure 132). In addition, the maximum (UP) shares of the refinery outputs (Attribute=SHARE-
O) are all updated to 50%, creating flexibility for the model to optimize the mix of refined
products (DSL, KER, LPG, etc.).
99
upper bounds on annual emissions (Attribute = COM_BNDNET; LimType = UP), on the CO2
emissions from the transportation sector only (TRACO2) in REG1 and REG2. These upper
bounds are calculated as percentage reduction targets from the transportation sector CO2
emissions in a reference scenario for 2010 (10%) and 2020 (20%). It is necessary to run the step
model without any limit on emissions first to get the reference emission trajectory (run
DemoS_007) and then calculate the bounds as a reduction targets from the reference emissions.
An interpolation rule is used with the "0" flag in the Year column and the
interpolation/extrapolation option in the region column where the bounds are declared; the code
5 means full interpolation and forward extrapolation.
100
Figure 135. Declare Price-elasticities for End-use Demands
In order to activate the elastic demand feature, there are few steps to follow:
➢ Generate a file with demand prices from a reference case, i.e. without any constraint or
tax on emissions: in the Parameter Group make sure the option “Write B Price for Elast
Dem" is selected (Figure 136). This option is already selected in the DemoS_007.
101
Figure 137. Include the B Elastic Demand and Emission Constraint
3.7.5 Results
The effect of price elasticities on the new projected demand for car transportation in thousand
passengers-kilometres (kpass*km) to the 2020 horizon is visible (Figure 138) in the scenarios
where it was activated (DemoS_007b and DemoS_007c). Demands are decreasing by about 9%
in both regions, less than the maximum decrease of 15%, meaning than more cost-effective
emission reduction options exist elsewhere in the system beyond that level.
The impacts of the emissions constraints and the growth rate constraint on the optimal
process mix selected to meet the car transportation demand (kpass*km) is shown (Figure 139)
for both regions together:
102
Figure 138. Results - Effect of Price Elasticities on Car Transportation Demand in
DemoS_007
103
Figure 139. Results – Car Transport Vehicle Type Mix in DemoS_007
104
➢ In the reference case (DemoS_007), new diesel cars satisfy the entire demand for car
transportation from 2015 and beyond. The output mix of the refinery is shown below
(Figure 140).
➢ The limits on the transportation sector emissions (DemoS_007a) lead to a switch toward
less polluting options such as electric, natural gas and LPG cars.
➢ The activation of elastic demand (DemoS_007b) leads to a reduction in the use of the
most expensive option to meet demand – electric cars .
➢ The addition of a growth rate constraint on diesel cars (DemoS_007c) leads to a switch
toward natural gas cars.
105
3.8 DemoS_008 - Split Base-Year (B-Y) templates by sector: demands by
sector
Description. At the eighth step, the level of detail in the representation of the RES is
expanded further, the base-year information is disaggregated into different B-Y Templates for
each sector, and demands are projected through 2050. Each of these B-Y Templates utilizes only
the relevant portion of the energy balance for its region and is linked to an additional single file
containing the complete regional energy balances. This approach is convenient when different
individuals work in parallel on different sectors. In addition, it encourages grouping of related
commodities and processes, and as the size of a model grows it improves (and speeds up) the
process of managing the model.
Objective. The objective is to give more examples on how to further expand the detail of the
representation of the RES, in terms of the number of end-use demand segments and end-use
devices as well as commodities. On the demand side, the idea is to cover the energy consumption
by end-use in all sectors rather than by type of energy: agriculture (one end-use demand),
commercial (three end-use demands), residential (three end-use demands), industrial (one end-
use demands), and transport (two end-use demands). On the supply side, the idea is to break the
renewables into more detail for wind, solar, hydro and biomass power. This enhancement of the
RES requires the modelling of additional processes as well as the addition of emission
coefficients for all sectors.
Another objective is to show how to impose a limit on power generation capacity: nuclear,
for example. The scenario variants with nuclear maximum capacity, with different types of limits
on emissions, and with and without the elastic demand feature, illustrate the impacts on the
respective contribution of each sector to the target as well as on the electricity generation mix.
Attributes Introduced Files Updated
N.A. SysSettings
Scen_TRA_CO2_Bound
Scen_ELC_CO2_Bound
Scen_UC_CO2BND
SubRES_NewTechs
Files Created
VT_REG1/2_PRI_v08
VT_REG1/2_ELC_v08
VT_REG1/2_RCA_v08
VT_REG1/2_TRA_v08
VT_REG1/2_IND_v08
Scen_UC_NUC_MaxCAP
Files Replaced
VT_REG1/2_PRI_v07
106
VT_REG2_*_v08), and to add more energy commodities, energy processes, and
emissions;
➢ by completing the SubRES file;
➢ by updating scenario files with limits on emissions;
➢ by creating a scenario file with a user constraint on the maximum nuclear power capacity
(Figure 141).
107
Figure 142. New Time Periods Definition in SysSettings
3.8.1.2 Defaults
The ~DefUnits table is used to specify the different default activity, capacity and commodity
units for each sector in the model (Figure 143).
* For purposes of clarity the energy balance is not presented totally and some columns are missing (for refined
products).
Figure 144. Disaggregated Initial Energy Balance (2005) for REG1 in DemoS_008
108
3.8.2.2 Pri_COA, Pri_GAS, Pri_OIL, Pri_PP, Con_REF
The structure of these sheets have not changed, but the data is updated following a different
commodity split between REG1 and REG2 in the energy balance.
3.8.2.3 Pri_RNW and Pri_NUC
Mining processes for the uranium resources and the new renewable potentials are
characterized with a cost (Figure 145).
109
Figure 147. New Renewable Electric Generation Power Plants
3.8.3.2 Emi
A similar sheet is added in all sectors with a ~COMEMI table used to define fuel-based
emission coefficients associated with fuel consumption in each sector (Figure 148).
110
Figure 150. New Environmental Commodity for Industrial Emissions
3.8.5 BY Template VT_REG*_RCA_V08
This B-Y Template includes the information related to three sectors: agriculture, commercial
and residential.
3.8.5.1 DemTechs_AGR
The energy consumed in the agriculture sector is captured through a single generic process
(as for the industrial sector) consuming the mix of agriculture fuels as given in the energy
balance and producing one end-use demand (DAOT). A relaxation factor is also used for the
maximum input shares in 2050 to give more flexibility to the model over time to optimize the
fuel mix. However, the value of the relaxation factor should remain realistic since most fuel
switches involve process switches as well.
3.8.5.2 DemTechs_RSD and DemTechs_COM
The energy consumed in the commercial and the residential sectors is modelled through
specific processes (Figure 151). Multiple processes are in competition to satisfy each end-use
demand (e.g., RSHE* to satisfy the DRSH demand). The existing processes are characterized
with their existing installed capacity (STOCK) corresponding in this case to the energy
consumption required to produce these energy services as given by the energy balance and the
additional fuel split assumptions. The calculation of the existing stocks also takes into account
availability factors (AFA) and are converted into GW using a capacity to activity factor
(PRC_CAPACT equivalent to CAP2ACT). They also have an efficiency (EFF) and a life time
(LIFE).
111
capture the annual variation in the electricity (ELC) consumption levels and prices, the only
commodity tracked at the time slice level. In this example, the annual variations are significant
for those end-use demands affected by seasonal changes (e.g. space heating).
112
to satisfy the demand for the new public transport demand, and they are modelled using the same
approach as for cars (Figure 154).
3
http://www.iea-etsap.org/Energy_Technologies/Energy_Technology.asp
113
Figure 155. New Residential and Commercial Devices
114
Figure 157. User Constraint to Impose a Maximum Capacity for Nuclear Power Plants
3.8.9 Results
The results for the electricity generation capacity (Figure 158) show the respective role of the
new types of renewable power (biomass, hydro, wind and solar), the 2050 horizon, as well as the
effects of the user constraint on nuclear capacity. Nuclear capacity remains constant for REG1
while it grows in REG2 up to the maximum bound in 2030, but not in 2050.
115
sector (replacing coal-fired with gas-fired power plants), as well as from the residential and the
commercial sectors (replacing solid fuels with renewable energies).
116
• To show how to use the BY Trans file to move or add data and reduce the size of tables in
the B-Y Templates. Here we specify the availability factor by time slice for existing wind
and solar processes and add an interpolation rule for new hydro capacity (NCAP_BND).
• To show how to use the transformation file associated with each SubRES to declare the
availability or non-availability of each process in each region: new hydro power plants in
this example.
• To give an example of a scenario used to insert/update information in the B-Y Templates
and SubRES: the demands and the retirement profile for the iron and steel processes.
• To illustrate how to build a user constraint to limit the penetration of some processes,
such as the district heating system between 2020 and 2050.
Attributes Introduced Files Updated
PASTI VT_REG1/2_ELC_V09
CEH BY_Trans
CHPR SubRES_NewTechs_Trans
UC_CAP Files Created
UC_COMPRD SubRES_New-IND
UC_FLO SubRES_New-CHP-DH
Scen_IND_NewRes
Scen_UC_DH_MinProd
117
Figure 160. Templates Included in DemoS_009
3.9.1 B-Y Template VT_REG*_ELC_V09
The only B-Y Templates that are modified are the electricity ones (VT_REG1_ELC_V09 and
VT_REG2_ELC_V09).
3.9.1.1 Con_ELC
The STOCK attribute for existing capacity can be replaced by another attribute (PASTI =
past investments) to describe capacity installations that took place before the beginning of the
model horizon (2005) and still exist during the modelling horizon. For any process, an arbitrary
number of past investments may be specified to reflect the age structure in the existing capacity
stock: the hydro power plants in this example (Figure 161). Each vintage of PASTI capacity will
be constant until the end of its technical life, after which the capacity becomes zero in a single
step. This allows a vintage-based retirement profile for the existing stock to be introduced into
the model without the need to calculate and specify a STOCK in each future year.
118
Figure 161. Past Investments That Occurred Before 2005
3.9.1.2 BY_Trans
The BY_Trans file works like a scenario file, except that the rule-based filters and the
update/insert changes apply only to those process and commodities already existing in the B-Y
templates. In this example (Figure 162), the file is used to insert new information: the availability
factor (AF) by time slice (SD, SN, etc.) for existing wind and solar plants (ELCREWIN00 and
ELCRESOL00).
Figure 162. Transformation File to Insert New Attributes for Existing Processes
The transformation file is also used to insert a new interpolation rule (2 = interpolation, but
extrapolation with EPS (epsilon, or effectively zero), which inserts EPS in every year if no
bound value is declared in any year) to avoid the installation of new capacity (NCAP_BND)
after the base year for the existing hydro power plants (ELCREHYD00). VEDA2.0 creates this
entry by default for all technologies for which STOCK is declared. Since we have switched to
using PASTI we need to declare it manually (Figure 163).
3.9.2 SubRES_NewTechs_Trans
Similarly to the BY_Trans file, a transformation file exists for each of the SubRES created.
They are used to update/insert information for new processes and commodities declared in the
corresponding SubRES and to declare the availability or non-availability of each process in each
region. In this example, the transformation file of the SubRES_NewTechs is used to insert the
119
availability factor for new wind and solar plants (ELCRNWIN01 and ELCRNSOL01) exactly as
for the existing ones.
To assign the availability of processes to regions, a new ~TFM_AVA table is created (Figure
164). The first line says that all processes (Pset_PN=*) are available in all regions. The second
line modifies this to say that the new hydro power plant is not available in REG1 (1=available;
0=non-available).
120
Figure 166. Energy and Material Input Commodities for the Iron & Steel Sector
3.9.4 SubRES_New-CHP-DH
This file includes two sheets (ELC_CHP and RCA), recalling that SubRES sheet names need
to start with the name of one of the model sectors. The first sheet is used to add the combined
heat and power (CHP) sector to the model (Figure 167). Cogeneration power plants, or combined
heat and power plants (CHP), are plants that consume one or more commodities and produce two
commodities, electricity (ELC) and heat (HET). The new CHP processes are characterized with
additional attributes compared with conventional power plants.
➢ The new processes do not have an existing installed capacity, but they are available in the
database to be invested in. They are characterized with an efficiency (EFF), an annual
availability factor (AFA), fixed and variable O&M costs (FIXOM, VAROM), a life time
(LIFE), a capacity to activity factor (CAP2ACT in PJ/GW), and an investment cost
(INVCOST), as well as the year in which they become available (START). Maximum
input shares (Share-I~UP) are also specified for the dual input process ELCBNGAB01
consuming a maximum of 60% of biomass.
➢ Two new attributes are introduced: the ratio of electricity lost to heat gained (CEH) as
well as the ratio of heat produced to electricity produced (CHPR).
Two main types of cogeneration power plants can be distinguished according to the
flexibility of the outputs: a back pressure process (ELCBNGAB01) and a condensing process
(ELCCNGAS01).
➢ Back pressure turbines are systems in which the ratio of the production of electricity and
heat is fixed, so that the electricity generation is directly proportional to the steam
produced. In a real system, a back pressure turbine is defined using the electrical
efficiency, the thermal efficiency, and the load utilization. The CHPR attribute is then
fixed (FX), so the production of electricity and heat is in a fixed proportion, but one could
also use a (LO) CHPR for defining the back-pressure point, if so desired (to allow by-
passing the turbine to produce more heat). CEH can be either 0 (or missing) or 1:
If it is 0 (or missing) as in this example, the activity represents the electricity generation and the
capacity represents the electrical capacity;
If it is 1, the activity represents the total energy output and the capacity represents the total
capacity (electricity + heat).
➢ The condensing pass-out or extraction turbines do not have to produce heat, permitting
electricity only to be generated, and permitting the amount of heat generated to be
directly adjusted to the heat demand, while the electricity generation is reciprocally
proportional to heat generation (electricity losses because of heat extraction). They are
thus described differently:
121
1. Coefficient of electricity to heat, via attribute CEH such that: a) <= 1: electricity loss
per unit of heat gained (moving from condensing to backpressure mode), indicating
that activity is measured in terms of electricity, or b) >= 1: heat loss per unit of
electricity gained (moving from backpressure to condensing mode), indicating that
activity is measured in terms of total output (electricity plus heat).
2. Efficiencies, according to 1: a) are specified for the condensing point, or b) are
specified for backpressure point.
3. Costs, according to 1 are specified based:
a) according to condensing mode, or
b) on total electricity and heat output at backpressure point.
4. Ratio of heat produced to electricity produced (CHPR): Ratio of heat to power at
backpressure point; at least a maximum value is required, but in addition also a
minimum value may be specified.
See Section 4.1 of Part II of the TIMES documentation for more on CHP processes and their
attributes.
The CHP processes are declared as CHP processes in the process declaration table with a
time slice level of activity (DAYNITE). The heat (HET) is also declared as a new energy
commodity in the commodity declaration table.
122
3.9.5 Scenario files
3.9.5.1 Scen_IND_NewRES
A transformation table is used to update the base year industrial demand (DIDM1): the base
year valued defined in the B-Y Templates are multiplied by 0.9 (Figure 169). This essentially
reduces the DIDM1 demand that was used to model all industrial sector energy consumption by
an amount roughly corresponding to that consumed by the new iron and steel sector. (Although
note that we are not trying to replicate calibration to the energy balance precisely in this simple
example.)
Another transformation table is used to define the demand value for the new iron and steel
demand (DIIS), activating this sector when the SubRES is included in a model run, and to
specify the retirement profile for the iron and steel processes (STOCK in 2050). (In this case the
STOCK has been introduced in a SubRES template so VEDA2.0 will not create any
interpolation rule to prohibit new investments.)
Figure 169. Update Existing Information and Insert New Information in the Industrial
Sector
3.9.5.2 Scen_UC_DH_MinProd
A user constraint is built to specify the minimum district heating penetration requirement in
specific years (2020 and 2050) with an interpolation/extrapolation rules between those years
(rule 15=interpolation migrated at start, forward extrapolation) (Figure 170). The constraint says
that the production of DRSH by processes that consume RSDHET (Pset_CI) must be the
minimum (LimType=LO) percentage specified in each region/year combination of all
production (table level declaration UC_COMPRD) of DRSH.
123
Figure 171. Results – Finished steel production in DemoS_009
124
3.10 DemoS_010 - Demand projections and elastic demand
Description. At the tenth step, the model structure and database remain the same but energy
service demands are projected using an internal VEDA2.0 routine.
Objective. The objective is to show how to prepare the files required to automatically project
end-use demands for energy services using demand drivers along with sensitivity and calibration
series.
Attributes Introduced Files Updated
N.A. Scen_ElasticDem
Files Created
Dem_Alloc+Series
ScenDem_DEM_Ref
125
Figure 173. Templates Included in DemoS_010
3.10.1 Demand files
The Demand templates provide a means of preparing useful energy demand (or demand
services) projections by means of using drivers and factors as discussed below.
3.10.1.1 ScenDem_DEM_Ref
The ~DRVR_Table table is used to declare a coherent set of driver growth rates (or indexes,
with 2005=1) to drive all end-use demands in all regions (Figure 174). These drivers can be more
general, such as macroeconomic indicators, as in this example (Gross Domestic Product (GDP),
population (POP), industrial output demand (INDD)), or more specific, like vehicle-kilometres
for energy service demands in the transportation sector, for instance. It is possible to build
multiple files called ScenDem_<file name> with different drivers to generate, for example, a
reference case along with low and high growth cases.
The ~DRVR_Allocation table is used to allocate a particular driver to each end-use demand
in each region (Figure 176). Only one such allocation file, always named Dem_Alloc+Series,
may be built. That is, it is envisioned that in different scenarios, the projection of the driver for
each demand may change (higher or lower population growth, for example), but the association
of each demand with a particular driver will not change. (For example, DRSH is always driven
by population growth with the same sensitivity.) Only one driver series may be associated with
each demand. However, one may easily create a composite series if combining two drivers is
desired. In this example, the demand DAOT will be projected using the driver GDP, adjusted
with calibration and sensitivity series (Constant; =1 over the whole model horizon).
126
Figure 175. Sensitivity and Calibration Series for End-use Demand Projections
Figure 176. Allocation of Demand Drivers and Series for End-use Demand Projections
All the demands projected with the internal VEDA2.0 module can also be managed from the
menu: Advanced Functions/Demand Master. Changes made within the Demand Master will be
reflected in the templates. For more information on the Demand Master function, see
http://support.kanors-emr.org/.
3.10.2 Results
The resulting demand projections in the reference case (DemoS_010) using the driver and
series allocation presented above are shown in Figure 177.
127
Figure 177. Demand Projection Results in DemoS_010
Objective-Function = 24,831,217 M euros (see the _SysCost table) with 10,869,234 M
euros for REG1 and 13,961,983 M euros for REG2. The total cost is 7% higher with all model
variants (26,475,198 M euros).
3.11 DemoS_011 – Sets Template
Description. At the eleventh step, the model structure and database remain the same, the
main changes are in the SETS template and how to use it in scenario templates..
Objective. The objective is to show how to use user defined SETS (Sets-DemoModels) in a
scenario file for model building and scenario analysis. As said above, it is possible to create sets
of commodities and processes using the template Sets-<name>, that for the demo models is
called Sets-DemoModels. These sets are generally used to build tables to view results in the
Results module, but it is also possible to use these sets in VEDA templates. In this step there is
an example of a user constraint on the minimum penetration of renewable power plants built
using a user defined set of renewable processes.
Attributes Introduced Files Created
N.A. Scen_BOUNDS-UC_WSETS
128
Files. The eleventh step model is built:
➢ by creating one scenario file that explains VEDA Sets specification and includes a user
constraint..
3.11.1 Updating the Sets-DemoModels
The Sets-DemoModels template used in DemoS_011, includes the two sheets VEDA_Sets-
Comm for commodities sets definition and VEDA_Sets-Proc for processes sets definition.
The commodity set rules are included in the model using the ~TFM_Csets, while the process
sets throught ~TFM_Psets.
~TFM_Csets
CSET_SET CSET_CN CSET_CD SetName SetDesc
*SOLID* NRG_SOLID Solid Fuels
*GAS* NRG_GAS Natural Gas
*NUC* NRG_NUK Nuclear
*ELC* ,-*PLANTS* NRG_ELC Electricity
*OIL*,*DSL*,*LPG*,*GSL*,*KER*,*OPP*,*HFO*,*NAP* NRG_PP Petroleoum & Products
*BIO*,*SOL*,*WIN*,*RNW*,*HYD*,-*SOLID*,-ELCRNW,-RNW NRG_RNW Renewables
NRG,-NRG_ELC,-NRG_GAS,-NRG_NUK,-NRG_PP,-NRG_RNW,-NRG_SOLID * NRG_MISS *** Missing Set Assignment ***
~TFM_Psets
PSET_SET PSET_PN PSET_PD PSET_CI PSET_CO SetName SetDesc
IMP*Z DUMIMP Dummy Import
IMP* IMP Imports
IRE MIN* MIN Domestic Production
EXP* EXP Exports
ELE ELCBIO ELEBIO Biomass Power Plants
ELE *COA* ELECOA Coal Power Plants
ELE *GAS* ELEGAS Gas Power Plants
ELE *NUC* ELENUC Nuclear Power Plants
ELE *OIL* ELEOIL Oil Power Plants
ELE *RNW* ELERNW Renewable Power Plants
PRE RSD* FUEL_RSD Fuel Consumption Residential Sector
PRE TRA* FUEL_TRA Fuel Consumption Transport Sector
FT* FUELTECH Fuel Technologies
IRE T* TRD_ENDO Endogenous Trade
ELE *COA*,*GAS*,*NGA*,*OIL* PP_FOSSIL Fossil Power Plants
ELE *NUC PP_NUCLEAR Nuclear Power Plants
ELE,-PP_FOSSIL,-PP_NUCLEAR,-PP_RENEW * PP_OTHER Other Power Plants
ELE *RNW,*WIN,*SOL,*BIO,*HYD PP_RENEW Renewable Power Plants
ELE ELCTEGAS00,ELCTEOIL00,ELCTECOA00 PPFOSSIL Fossil Power Plants (coa,gas,oil)
ELE ELCHYD ELEHYD Hydro Power Plants
ELE ELCSOL ELESOL Solar PV Power Plants
ELE ELCWIN ELEWIN Wind Power Plants
PRE AGR* FUEL_AGR Fuel Consumption Agriculture Sector
PRE COM* FUEL_COM Fuel Consumption Commercial Sector
PRE IND* FUEL_IND Fuel Consumption Industry Sector
3.11.2 Scen_Bounds-UC-wSets
As an example, a user constraint is built using the process set PP_RENEW (column
PSet_SET) that includes all renewable power plants: it specifies a minimum renewable
129
penetration share of 10% in 2020 and 15%-20% in 2050, depending on the region, along with an
interpolation/extrapolation rule (Figure 179).
130
SubRES_NewTechs
Files Created
Scen_TRADSL_Tax
Scen_CO2_Tax
Scen_Solar_Subsidies
Scen_UC_CO2_Regions
Scen_NUC_DiscInv
131
Figure 182. Discrete Investment Option for Nuclear Power Plants
3.12.3 Scenario files
3.12.3.1 Scen_NUC_DiscInv – lumpy investments
The second step necessary to enable lumpy investments is to specify allowable discrete
capacity investments (NCAP_DISC) in specific years for new nuclear power plants
(ELCNNUC01). In this example (Figure 183) the capacity installed for this process can be a
module of 1 GW in 2015, while in 2033 the model can install 2 GW or 3 or 4 or 5 GW.
132
Figure 184. Enable the Variant Discrete Investment in VEDA2.0
3.12.3.2 Scen_TRADSL_Tax
This file is used to introduce a flow tax (FLO_TAX) on processes and commodities
(input/output) (Figure 185). This is a new attribute that allows imposing an incremental cost of
using/producing a commodity by a process (cost in Currency per unit of commodity produced or
consumed). Here it is used to impose a flow tax on all the transportation processes (T*)
consuming the diesel commodity (TRADSL) at specific years in each region.
133
(cost in Currency per unit of commodity produced or consumed). Here a flow subsidy on the
electricity (ELC) commodity produced by all processes consuming the solar energy commodity
(ELCSOL) is created with various values at specific years in each region.
134
Figure 189. Final Energy Fuel Consumption in Transport
The impact on fuel consumption in the Transport section in Figure 189 are discussed below.
➢ The tax on diesel consumption in the transportation sector (DemoS_012a) leads to a rapid
decrease in refined products, reaching zero by 2025, to the benefit of renewable energies,
which meet most of the demand by 2050.
➢ The tax on total CO2 emissions (DemoS_012b) leads to an even more drastic decrease of
refined products, reaching zero by 2010, to the benefit of renewable energies.
➢ The limit on total CO2 emissions (DemoS_012d) does not have an impact on the
transportation fuel mix but affects other parts of the whole energy system. The tax puts
much higher pressure on the energy system than the limit.
135
Figure 190. Electricity Power Plant Capacity in DemoS_012
The impact on the power sector in the various scenarios, as seen in Figure 190 shows are
describing beow.
136
• The tax on total CO2 emissions (DemoS_012b) has important impacts on the electricity
sector as well, where most of the thermal generation capacity is replaced with wind
power.
• The subsidy on solar power (DemoS_012c) leads to a more diversified mix, as part of the
wind power is replaced with solar power.
The declaration of discrete capacity for nuclear power plants (DemoS_012e) limits the nuclear
growth, with only 1 GW of new capacity addition in 2020, 2025, 2030 and 10 GW in 2035
compared with 121 GW in the reference case (
• Figure 191). Note that to facilitate the comparing of the differences between the two
scenarios the scenario was moved to the right of the power plant types.
137
New capacity and lumpsum investment costs. (UC tags
Cap_New p
INSTCAP and LUMPINV, respectively.)
Cost_Act p Annual variable activity costs of processes. Undiscounted.
Cost_Com c Annual commodity costs. Undiscounted.
Cost_Comx c Annual commodity taxes/subsidies. Undiscounted.
Annual undiscounted commodity related damage costs,
Cost_Dam c
generated by DAM_COST.
Annualized decommissioning costs for a process.
Cost_Dec p
Undiscounted.
Annual elastic demand costs (losses) due to elastic
Cost_Els c
demand changes. Undiscounted.
Annual fixed taxes/subsidies associated with process
Cost_Fixx p
installed capacity. Undiscounted.
Annual flow costs (including exogenous import/export
Cost_Flo p,c
prices). Undiscounted.
Annual undiscounted flow-related tax/subsidy costs
(caused by FLO_TAX, FLO_SUB) in period (t) associated
Cost_Flox p,c with a commodity (c) flow in/out of a process (p) with
vintage period (v) as well as capacity related commodity
flows.
Annual fixed operating and maintenance costs.
Cost_Fom p
Undiscounted.
Cost_Inv p Annualized investment costs. Undiscounted.
Annual undiscounted investment taxes/subsidies,
Cost_Invx p
spread over the economic process lifetime.
Annual implied costs of endogenous trade, valued
Cost_ire p according to the marginal(s) of the trade equation of
process p. Undiscounted
Total discounted costs by component. See Table XX
Cost_NPV p,c below for components, and Part III, Section 3.10 for
reporting options.
Salvage value of investment cost, taxes and subsidies of
process (p) with vintage period (v), for which the technical
COST_Salv p
lifetime exceeds the end of the model horizon, value at
year EOH+1.
Climate module results for the duals of constraint related
Dual_Clic c
to climate variable (c) in period (t).
Commodity Slack/Levels: commodity production minus
EQ_Combal c
consumption.
EQ_CombalM c Commodity shadow price
Level of cumulative constraint for flow of commodity (c)
EQ_Cumflo p,c
of process (p) between the year range (v–t).
Shadow price of cumulative constraint for flow of
EQ_CumfloM p,c commodity (c) of process (p) between the year range (v–
t). Not undiscounted.
Inter-regional trade equation marginal. The undiscounted
EQ_IreM p,c shadow price can be interpreted as the import/export price
of the traded commodity.
EQ_Peak c Peaking constraint slack
EQ_PeakM c Peaking Constraint shadow price (price premium for
138
consumption during peak timeslice paid by the consumer
in addition to COMBAL price).
ObjZ none Total discounted present value of system cost
PAR_CapLO p Capacity lower limit
PAR_CapUP p Capacity upper limit
Regional total annualized costs by period and cost
Reg_ACost r
category. (See Table XX below for categories.)
Regional total discounted implied trade cost, derived by
multiplying the shadow prices of the trade equations by
Reg_irec r
the trade volumes. The sum of REG_IREC over regions is
zero.
Reg_obj r Regional total discounted system cost
Regional total discounted system cost by cost type (uc_n).
Reg_wobj r
(See Table XX below for cost types.)
Present value of the time in each model period (t) by
region (r), with s='ANNUAL' and
Time_NPV
uc_n='COST'/'LEVCOST' depending on whether the
$SET ANNCOST LEV reporting option has been used.
Level of user constraint (or its slack). Only reported when
User_Con
the VAR_UC variables are used.
User constraint shadow price. Undiscounted only if the
User_ConFXM
constraint is defined by region and period.
Undiscounted shadow price of dynamic process-wise
User_DynbM bound constraint, identified with name uc_n, for variable c
(CAP / NCAP / ACT), in period t and timeslice s.
Annual commodity flow values:
Flows of process (p) multiplied by the commodity balance
Val_Flo p,c marginals of those commodities (c), which can be
interpreted as the market values of the process inputs and
outputs.
VAR_Act p Process activity level
Process activity marginal. Annual undiscounted reduced
VAR_ActM p
cost of process activity variable.
Process capacity. The vintage tags 0, -, and ¤ are used to
VAR_Cap p indicate residual capacity, new capacity, and retired
capacity, respectively.
Process capacity marginal. Undiscounted reduced cost of
VAR_CapM p
process capacity variable, when generated.
Climate module results for the levels of climate variable
VAR_Climate
(c) in period (t).
Commodity net quantity (consumption minus production);
VAR_Comnet c only generated when bound is specified by the user
(COM_BNDNET).
Dual variable of bound put on the net production of a
VAR_ComnetM c
commodity.
Commodity total production; only generated when bound
VAR_Comprd c
is specified by the user (COM_BNDPRD).
Dual variable of constraint related to the bound on the
VAR_ComprdM c
production of a commodity.
VAR_CumCst Cumulative costs by type (if constrained).
139
Electricity output of electricity supply processes by energy
VAR_Eout source. (Opted out by default – set RPT_OPT('FLO','5')=1
to activate; see Part III, Section 3.10).
VAR_Fin p,c Commodity consumption by process
VAR_Fout p,c Commodity production by process
VAR_Ncap p Technology investment
Technology investment marginal. Undiscounted reduced
VAR_NcapM p
cost of process investment variable.
Technology Investment – BenCost + ObjRange (see Part
II, Section 3.3.3 and Part III, Section 3.10 for more
details):
Cost-benefit and ranging indicators for process (p) in
period (t), where uc_n is the name of the indicator:
• COST - the total unit costs of VAR_NCAP (in terms of
an equivalent investment cost)
• CGAP - competitiveness gap (in terms of investment
costs), obtained directly from the VAR_NCAP
marginals (and optional ranging information)
VAR_NcapR p
• GGAP - competitiveness gap (in terms of investment
costs), obtained by checking also the VAR_ACT,
VAR_FLO and VAR_CAP marginals, in case
VAR_NCAP is basic at zero
• RATIO - benefit / cost ratio, based on CGAP
• GRATIO - benefit / cost ratio, based on GGAP
• RNGLO - ranging information (LO) for VAR_NCAP
(if ranging is activated; in terms of investment costs)
• RNGUP - ranging information (UP) for VAR_NCAP
(if ranging is activated; in terms of investment costs)
* p = process, c= commodity, r = region, t = period, s = timeslice, and v = vintage
In addition, the r,t,s,v dimensions are involved for attributes involving processes, and the r,t,s dimensions
for attributes involving commodities only.
140
Appendix B TIMES Results files
There are three files produced for the Results module by the GDX2VEDA utility: the
<scenarioname>.VD data dump with the attributes, <scenarioname>.VDE (set elements), and
<scenarioname>.VDS (sets definition). In addition, VEDA2.0 produces a <scenarioname>.VDT
(topology) file with the RES connectivity information. These files are dumped in comma
delimited format. They never require user intervention, though they may be processed by other
software if desired. Snippets of each file are shown below, after a brief description of the layout
of each.
B.1 <scenarioname>.VD
The <scenarioname>.VD file contains the application Results module header directives
(controlling the appearance of the main Results table specification form) followed by the actual
model data.
Layout, after the header: Attribute, Commodity, Process, Period, Region, Vintage, Timeslice,
UserConstraint, Value;
Excerpt:
* GDX2VEDAversion- 2005-10-07
* ImportID- Scenario:DemoS_012b
* VEDAFlavor- TIMES
* Dimensions-
Attribute;Commodity;Process;Period;Region;Vintage;TimeSlice;UserConstraint
;PV
* ParentDimensions- Commodity: Region; Process: Region
* SetsAllowed- Commodity;Process
* FieldSize-
Attribute:31;Commodity:31;Process:31;Period:31;Region:31;Vintage:31;TimeSl
ice:31;UserConstraint:31;PV:20
* NotIndexed- PV
* ValueDim- PV
* DefaultValueDim- PV
* FieldSeparator- ,
* TextDelim- "
"VAR_Act","-","AOTETOT","2005","REG1","2005","ANNUAL","-",564.8409
"VAR_Act","-","CAPEELC","2005","REG1","2005","ANNUAL","-",1148.6992095
"VAR_Act","-","COTEBIO","2005","REG1","2005","ANNUAL","-",3.939
"VAR_Act","-","COTECOA","2005","REG1","2005","ANNUAL","-",37.3712625
"VAR_Act","-","COTEELC","2005","REG1","2005","ANNUAL","-",63.8166227499999
"VAR_Act","-","COTEGAS","2005","REG1","2005","ANNUAL","-",212.309676
"VAR_Act","-","COTEOIL","2005","REG1","2005","ANNUAL","-",129.503715
"VAR_Act","-","CSHEBIO","2005","REG1","2005","ANNUAL","-",35.451
"VAR_Act","-","CSHEELC","2005","REG1","2005","ANNUAL","-",63.81662275
"VAR_Act","-","CSHEGAS","2005","REG1","2005","ANNUAL","-",495.389244
"VAR_Act","-","CSHEOIL","2005","REG1","2005","ANNUAL","-",302.175335
"VAR_Act","-","CSHESOL","2005","REG1","2005","ANNUAL","-",7.575
"VAR_Act","-","ELCNENUC00","2005","REG1","2005","S","-",746.220483540681
"VAR_Act","-","ELCNENUC00","2005","REG1","2005","W","-",723.929516459321
141
"VAR_Act","-","ELCREHYD00","2005","REG1","2005","SD","-",244.125
"VAR_Act","-","ELCREHYD00","2005","REG1","2005","SN","-",0.837000000000359
"VAR_Act","-","ELCREHYD00","2005","REG1","2005","WD","-",243.846
"VAR_Act","-","ELCRESOL00","2005","REG1","2005","SD","-",16.9805936073059
"VAR_Act","-","ELCRESOL00","2005","REG1","2005","SN","-",10.4147640791476
"VAR_Act","-","ELCRESOL00","2005","REG1","2005","WD","-",16.9611872146119
"VAR_Act","-","ELCRESOL00","2005","REG1","2005","WN","-",12.2907153729072
"VAR_Act","-","ELCREWIN00","2005","REG1","2005","SD","-",71.5472816780823
"VAR_Act","-","ELCREWIN00","2005","REG1","2005","SN","-",43.3049336472603
"VAR_Act","-","ELCREWIN00","2005","REG1","2005","WD","-",75.2268561643836
"VAR_Act","-","ELCREWIN00","2005","REG1","2005","WN","-",71.5472816780823
"VAR_Act","-","ELCTECOA00","2005","REG1","2005","S","-",1351.31629846897
"VAR_Act","-","ELCTECOA00","2005","REG1","2005","W","-",1044.37445353102
"VAR_Act","-","ELCTEGAS00","2005","REG1","2005","SD","-",226.711979456911
"VAR_Act","-","ELCTEGAS00","2005","REG1","2005","SN","-",300.30842173892
"VAR_Act","-","EXPCOA1","2005","REG1","2005","ANNUAL","-",745.59485
"VAR_Act","-","EXPHFO1","2005","REG1","2005","ANNUAL","-",804.770973903333
"VAR_Act","-","EXPKER1","2005","REG1","2005","ANNUAL","-",295.3885
"VAR_Act","-","EXPLPG1","2005","REG1","2005","ANNUAL","-",32.1237949472747
"VAR_Act","-","EXPNAP1","2005","REG1","2005","ANNUAL","-",400.84
"VAR_Act","-","EXPOIL1","2005","REG1","2005","ANNUAL","-",1648.4855
"VAR_Act","-","EXPOPP1","2005","REG1","2005","ANNUAL","-",453.036
"VAR_Act","-","FTE-AGRBIO","2005","REG1","2005","ANNUAL","-
",8.9265138547333
"VAR_Act","-","FTE-AGRCOA","2005","REG1","2005","ANNUAL","-
",8.46903001967851
"VAR_Act","-","FTE-AGRELC","2005","REG1","2005","SD","-",72.2276809309521
"VAR_Act","-","FTE-AGRELC","2005","REG1","2005","SN","-",66.4494664564759
"VAR_Act","-","FTE-AGRELC","2005","REG1","2005","WD","-",72.1451350098882
"VAR_Act","-","FTE-AGRELC","2005","REG1","2005","WN","-",78.418625010748
"VAR_Act","-","FTE-AGRGAS","2005","REG1","2005","ANNUAL","-
",160.377867843615
"VAR_Act","-","FTE-AGROIL","2005","REG1","2005","ANNUAL","-
",97.8265808739081
"VAR_Act","-","FTE-COMBIO","2005","REG1","2005","ANNUAL","-",48.25275
"VAR_Act","-","FTE-COMCOA","2005","REG1","2005","ANNUAL","-",37.3712625
"VAR_Act","-","FTE-COMELC","2005","REG1","2005","SD","-",309.846497299342
"VAR_Act","-","FTE-COMELC","2005","REG1","2005","SN","-",309.846497299342
"VAR_Act","-","FTE-COMELC","2005","REG1","2005","WD","-",329.999115009868
"VAR_Act","-","FTE-COMELC","2005","REG1","2005","WN","-",329.999115009868
"VAR_Act","-","FTE-COMGAS","2005","REG1","2005","ANNUAL","-
",762.742169333334
"VAR_Act","-","FTE-COMOIL","2005","REG1","2005","ANNUAL","-",507.22288375
B.2 <scenarioname>.VDE
The <scenarioname>.VDE file contains the list of individual set member elements for each index
managed by Results module along with their descriptions.
Excerpt:
"Attribute","-","VAR_act","Process Activity"
142
"Attribute","-","VAR_actM","Process Activity - Marginals"
"Attribute","-","VAR_cap","Technology Capacity"
"Attribute","-","VAR_capM","Technology Capacity - Marginals"
"Attribute","-","VAR_ncap","Technology Investment - New capacity"
"Attribute","-","VAR_ncapM","Technology Investment - Marginals"
"Attribute","-","VAR_ncapR","Technology Investment - BenCost + ObjRange"
"Attribute","-","VAR_fin","Commodity Consumption by Process"
"Attribute","-","VAR_fout","Commodity Production by Process"
"Attribute","-","VAR_comprd","Commodity Total Production"
"Attribute","-","VAR_comprdM","Commodity Total Production - Marginal"
"Attribute","-","VAR_comnet","Commodity Net"
"Attribute","-","VAR_comnetM","Commodity Net - Marginal"
"Attribute","-","VAR_eout","Electricity supply by technology and energy
source"
"Attribute","-","EQ_combal","Commodity Slack/Levels"
"Attribute","-","EQ_combalM","Commodity Slack/Levels - Marginals"
"Attribute","-","EQ_peak","Peaking Constraint Slack"
"Attribute","-","EQ_peakM","Peaking Constraint Slack - Marginals"
"Attribute","-","EQ_Cumflo","Cumulative flow constraint - Levels"
"Attribute","-","EQ_CumfloM","Cumulative flow constraint - Marginals"
"Attribute","-","PAR_capLO","Capacity Lower Limit"
"Attribute","-","PAR_capUP","Capacity Upper Limit"
"Attribute","-","PAR_Top","Process topology (Opted out - SET RPT_TOP YES
to activate)"
"Attribute","-","Cap_New","Newly installed capacity and lumpsum investment
by vintage and commissioning period"
"Attribute","-","COST_inv","Annual investment costs"
"Attribute","-","COST_dec","Annual decommissioning costs"
"Attribute","-","COST_salv","Salvage values of capacities at EOH+1"
"Attribute","-","COST_late","Annual late costs"
"Attribute","-","COST_fom","Annual fixed operating and maintenance costs"
"Attribute","-","COST_act","Annual activity costs"
"Attribute","-","COST_flo","Annual flow costs (including import/export
prices)"
"Attribute","-","COST_com","Annual commodity costs"
"Attribute","-","COST_els","Annual elastic demand cost term"
"Attribute","-","COST_dam","Annual damage cost term"
"Attribute","-","COST_invx","Annual investment taxes/subsidies"
"Attribute","-","COST_fixx","Annual fixed taxes/subsidies"
"Attribute","-","COST_flox","Annual flow taxes/subsidies"
"Attribute","-","COST_comx","Annual commodity taxes/subsidies"
"Attribute","-","COST_ire","Annual implied costs of endogenous trade"
"Attribute","-","COST_NPV","Total discounted costs by process/commodity
(optional)"
"Attribute","-","Time_NPV","Discounted value of time by period"
"Attribute","-","VAL_Flo","Annual commodity flow values"
"Attribute","-","ObjZ","Total discounted system cost"
"Attribute","-","Reg_wobj","Regional total expected discounted system
cost"
"Attribute","-","Reg_obj","Regional total discounted system cost"
"Attribute","-","Reg_irec","Regional total discounted implied trade cost"
"Attribute","-","Reg_ACost","Regional total annualized costs by period"
"Attribute","-","User_Con","Level of user constraint"
143
"Attribute","-","User_ConFXM","Marginal cost of fixed bound user
constraint"
"Attribute","-","User_ConLOM","Marginal cost of lower bound user
constraint"
"Attribute","-","User_ConUPM","Marginal cost of upper bound user
constraint"
"Attribute","-","User_DynbM","Marginal cost of dynamic process bound
constraint"
"Attribute","-","User_Maxbet","Level of MaxBet constraint"
"Attribute","-","VAR_climate","Climate result variables"
"Attribute","-","Dual_Clic","Shadow price of climate constraint"
"Attribute","-","VAR_Macro","MACRO result variables"
"Commodity","REG2","GAS","Natural Gas"
"Commodity","REG1","GAS","Natural Gas"
"Commodity","REG2","ELC","Electricity"
"Commodity","REG1","ELC","Electricity"
"Commodity","REG2","AGRBIO","Agriculture Biomass"
"Commodity","REG1","AGRBIO","Agriculture Biomass"
"Commodity","REG2","AGRCO2","Agriculture Carbon dioxide"
"Commodity","REG1","AGRCO2","Agriculture Carbon dioxide"
"Commodity","REG2","AGRCOA","Agriculture Solid Fuels"
"Commodity","REG1","AGRCOA","Agriculture Solid Fuels"
"Commodity","REG2","AGRELC","Agriculture Electricity"
"Commodity","REG1","AGRELC","Agriculture Electricity"
"Commodity","REG2","AGRGAS","Agriculture Natural Gas"
"Commodity","REG1","AGRGAS","Agriculture Natural Gas"
"Commodity","REG2","AGROIL","Agriculture oil"
"Commodity","REG1","AGROIL","Agriculture Oil"
"Commodity","REG2","BIO","Biomass"
"Commodity","REG1","BIO","Biomass"
"Commodity","REG2","COA","Solid Fuels"
"Commodity","REG1","COA","Solid Fuels"
"Commodity","REG2","COMBIO","Commercial Biomass"
"Commodity","REG1","COMBIO","Commercial Biomass"
"Commodity","REG2","COMCO2","Commercial Carbon dioxide"
"Commodity","REG1","COMCO2","Commercial Carbon dioxide"
"Commodity","REG2","COMCOA","Commercial Solid Fuels"
"Commodity","REG1","COMCOA","Commercial Solid Fuels"
"Commodity","REG2","COMELC","Commercial Electricity"
"Commodity","REG1","COMELC","Commercial Electricity"
"Commodity","REG2","COMGAS","Commercial Natural Gas"
"Commodity","REG1","COMGAS","Commercial Natural Gas"
"Commodity","REG2","COMOIL","Commercial oil"
"Commodity","REG1","COMOIL","Commercial Oil"
"Commodity","REG2","COMSOL","Commercial Solar energy"
"Commodity","REG1","COMSOL","Commercial Solar energy"
B.3 <scenarioname>.VDS
The <scenarioname>.VDS file provides the set membership information for the dimensions
where sets are allowed. Note that these are different from the user-defined sets (rule-based) that
are managed in the Results module. But these sets can be used as a part of those rules.
144
Layout: Type of set (tab), region, set name, item name;
Excerpt:
"Commodity","REG1","ELC+","ELC"
"Commodity","REG2","ELC+","ELC"
"Commodity","REG1","ELC+","AGRELC"
"Commodity","REG2","ELC+","AGRELC"
"Commodity","REG1","ELC+","COMELC"
"Commodity","REG2","ELC+","COMELC"
"Commodity","REG1","ELC+","RSDELC"
"Commodity","REG2","ELC+","RSDELC"
"Commodity","REG1","ELC+","TRAELC"
"Commodity","REG2","ELC+","TRAELC"
"Commodity","REG1","ENV","AGRCO2"
"Commodity","REG2","ENV","AGRCO2"
"Commodity","REG1","ENV","COMCO2"
"Commodity","REG2","ENV","COMCO2"
"Commodity","REG1","ENV","ELCCO2"
"Commodity","REG2","ENV","ELCCO2"
"Commodity","REG1","ENV","INDCO2"
"Commodity","REG2","ENV","INDCO2"
"Commodity","REG1","ENV","RSDCO2"
"Commodity","REG2","ENV","RSDCO2"
"Commodity","REG1","ENV","TOTCO2"
"Commodity","REG2","ENV","TOTCO2"
"Commodity","REG1","ENV","TRACO2"
"Commodity","REG2","ENV","TRACO2"
"Commodity","REG1","DEM","DAOT"
"Commodity","REG2","DEM","DAOT"
"Commodity","REG1","DEM","DCAP"
"Commodity","REG2","DEM","DCAP"
"Commodity","REG1","DEM","DCOT"
"Commodity","REG2","DEM","DCOT"
"Commodity","REG1","DEM","DCSH"
"Commodity","REG2","DEM","DCSH"
"Commodity","REG1","DEM","DIDM1"
"Commodity","REG2","DEM","DIDM1"
"Commodity","REG1","DEM","DRAP"
"Commodity","REG2","DEM","DRAP"
"Commodity","REG1","DEM","DROT"
"Commodity","REG2","DEM","DROT"
"Commodity","REG1","DEM","DRSH"
"Commodity","REG2","DEM","DRSH"
"Commodity","REG1","DEM","DTCAR"
"Commodity","REG2","DEM","DTCAR"
"Commodity","REG1","DEM","DTPUB"
"Commodity","REG2","DEM","DTPUB"
"Commodity","REG1","NRG","GAS"
B.3.4 <scenarioname>.VDT
The <scenarioname>.VDT file contains all the Reference Energy System (RES) topology
information.
145
Layout: Region, Process, Commodity, IN/OUT topology indicator. VEDA BE also enables one
to look at UCs that are related to a process or commodity. <UC Name>, Process, Commodity,
“UC” entries are needed for that.
Excerpt:
*VFEPATH=C:\Veda\VEDA_Models\DemoS_012
*ScenDesc=Demo Step 012 CO2 Tax
*ScenEDesc=Demo Step 012 CO2 Tax
"AU_NUC_MaxCAP","ELCNENUC00","-","UC"
"AU_NUC_MaxCAP","ELCNNNUC01","-","UC"
"REG1","AOTETOT","AGRBIO","IN"
"REG1","AOTETOT","AGRCO2","OUT"
"REG1","AOTETOT","AGRCOA","IN"
"REG1","AOTETOT","AGRELC","IN"
"REG1","AOTETOT","AGRGAS","IN"
"REG1","AOTETOT","AGROIL","IN"
"REG1","AOTETOT","DAOT","OUT"
"REG1","AOTETOT","DEMO","OUT"
"REG1","AOTETOT","NRGI","IN"
"REG1","CAPEELC","COMELC","IN"
"REG1","CAPEELC","DCAP","OUT"
"REG1","CAPEELC","DEMO","OUT"
"REG1","CAPEELC","NRGI","IN"
"REG1","CAPNELC1","COMELC","IN"
"REG1","CAPNELC1","DCAP","OUT"
"REG1","CAPNELC1","DEMO","OUT"
"REG1","CAPNELC1","NRGI","IN"
"REG1","COTEBIO","COMBIO","IN"
"REG1","COTEBIO","DCOT","OUT"
"REG1","COTEBIO","DEMO","OUT"
"REG1","COTEBIO","NRGI","IN"
"REG1","COTECOA","COMCO2","OUT"
"REG1","COTECOA","COMCOA","IN"
"REG1","COTECOA","DCOT","OUT"
"REG1","COTECOA","DEMO","OUT"
"REG1","COTECOA","NRGI","IN"
"REG1","COTEELC","COMELC","IN"
"REG1","COTEELC","DCOT","OUT"
"REG1","COTEELC","DEMO","OUT"
"REG1","COTEELC","NRGI","IN"
"REG1","COTEGAS","COMCO2","OUT"
"REG1","COTEGAS","COMGAS","IN"
"REG1","COTEGAS","DCOT","OUT"
"REG1","COTEGAS","DEMO","OUT"
"REG1","COTEGAS","NRGI","IN"
"REG1","COTEOIL","COMCO2","OUT"
"REG1","COTEOIL","COMOIL","IN"
"REG1","COTEOIL","DCOT","OUT"
"REG1","COTEOIL","DEMO","OUT"
146