JRC-EU-TIMES model Setup and Scenario Run  
=====================================================
Contact: Evangelos Panos, evangelos.panos@psi.ch

# Minimum requirements to solve the model
- A valid GAMS/CPLEX License 
- 64 GB RAM
- CPU threads >10
- HDD space 10 GB
- Basic Knowledge of the TIMES modelling Framework (see also https://iea-etsap.org/index.php/documentation)

# Installation
Download all two directories into the same folder at a local computer. The structure the three directories is as follows:  

- Gams_WrkJRCTIMES  	: contains the model input data 
- Results   		    : contains the model result generation routines and template files

# Contents of the model input data directory
The model code and input data are in flat text files with the extension .dmp . The folder also contains additional files like solver options and the scripts to run the POLIZERO scenarios. In addition, the post-model solution files, with the results of each scenario in raw output format, are also located in this folder. All the above are explained in the subsections below

## Model input data files 
--------------------------------------------

- BAU.dmp 	: JRC-EU-TIMES input data and code for the BAU scenario of POLIZERO
- CLI.dmp 	: JRC-EU-TIMES input data and code for the CLI scenario of POLIZERO
- CLI90.dmp	: JRC-EU-TIMES input data and code for the CLI90 scenario of POLIZERO 

## Other files required for solving the model
--------------------------------------------
Besides the data input and model code files, there are also additional files controlling the solution of the model.  

- cplex.opt	    : CPLEX solver option files 
- BAU.CMD		: script to run the BAU scenario of POLIZERO
- CLI.CMD		: script to run the CLI scenario of POLIZERO
- CLI90.CMD	    : script to run the CLI90 scenario of POLIZERO

## Post-solution files
--------------------------------------------
When the solution of a scenario with the JRC-EU-TIMES finishes, the corresponding GDX file is generated at the subfolder GAMSSAVE.
There are three GDX files alreaydy there:  

- BAU.gdx		: BAU scenario GDX file 
- CLI.gdx		: CLI scenario GDX file 
- CLI90.gdx	: CLI90 scenario GDX file 

These GDX files are translated into flat text files with extensions .vds, .vde and .vd. These files contain the output of the model in a format suitable for the TIMES licensed user interface VEDA (please see https://iea-etsap.org/index.php/documentation) 

# Contents of the model results directory
The subfolder Results contain the following files: 

- collect_results_single_scenario.gms	: is a routine to process the .vd files of TIMES to a format suitable for EXCEL 
- Fuel_Prices_JRC.gms			        : provides a proxy calculation of levelised costs of different energy carriers 
- Fuel_Prices_JRC_primary_commodity.gms	: auxiliary file for the Fuel_Prices_JRC.gms
- results_template.xlsb			        : results template file in EXCEL format for the EU-27 member states, CH, NO and UK
- bau.xlsb				                : results from the BAU scenario of POLIZERO in EXCEL
- cli.xlsb				                : results from the CLI scenario of POLIZERO in EXCEL
- cli90.xlsb				            : results from the CLI90 scenario of POLIZERO in EXCEL

The subfolder also contains the scripts to produce the results from a TIMES run:
- collect_all_scenarios.bat		: batch main script to generate the EXCEL files with the results from BAU, CLI and CLI90
- collect_single.bat			: auxiliary file to the main file of the script generating the results

# Example of the workflow with the JRC-EU-TIMES

1. execute the scripts BAU.CMD, CLI.CMD and CLI90.CMD to run the BAU, CLI and CLI90 POLIEZRO scenarios 
2. execute the script collect_all_scenarios.bat to create the results EXCEL file