GTAP4inGAMS: Installation Instructions


System Requirements
Download Instructions
GTAPinGAMS Dataset
GTAP-EG Dataset
Aggregated Datasets
Aggregation Routine
Back to GTAPinGAMS Homepage


This document describes an installation procedure of the GTAP4inGAMS package. There are two versions of the GTAP datasets in the package: the full versions (the file for the GTAPinGAMS and the file for the GTAP-EG) and the aggregated versions (the file for the GTAPinGAMS and the file for the GTAP-EG). The full versions of the datasets have a restricted distribution. In order to use the full versions, a modeller needs to obtain the standard GTAP4 data file gsddat.har. The instructions for obtaining the GTAP data can be found at the GTAP Homepage . For testing purposes, aggregated versions of the GTAPinGAMS and GTAP-EG datasets are provided with the GTAP4inGAMS package. The GTAP4inGAMS package with the aggregated datasets can be downloaded here (free of charge). A modeller can test the aggregated datasets by running illustrative models. The modeller can change the models to suit his specific purpose because he has a full access to the code of the build routines and the models.

System Requirements

In order to use the GTAP4inGAMS package, you need to have the following GAMS system components:

Download Instructions

The GTAP4inGAMS package is distributed in a zip archive (a file You can download it from ../gtap/ The archive has the directory structure presented below.

Table 1: Structure of the archive GTAPGAMS.ZIP

Directory Purpose File Purpose
BUILD build aspen.bat Batch file to build the GTAP-EG dataset
dataset build.bat Batch file to build the GTAPinGAMS dataset
chkdata.bat Check benchmark data
chkdata.gms Check benchmark data
chkeq.gms Check equilibrium
filter.gms Filter data
gtapaggr.bat Aggregation
gtapaggr.gms Aggregation GAMS file
gtapsets.gms Make sets for aggregation
iea_vail.gms Calibration
ieo.dat IEO Projections Data
ieodata.gms IEO Projections
impose.bat New dataset creation
impose.gms New dataset creation
recalib.gms Recalibration
regbal.gms Regional Balance
relabel.gms Relabel to GAMS format
seehar.exe Read HAR-file utility
DATA initial and vail.dat Aggregated Energy Data
resulting 13x8 GTAP-EG dataset
data 10x10 GTAPinGAMS dataset
(gsddat.har) GTAP Data (not included)
( Created after running ASPEN.BAT
( Created after running BUILD.BAT
DEFINES stores Full GTAP-EG mapping
.set, .map, and .def aspen.set Full GTAP-EG sets
files 13x8 GTAP-EG mapping
aspen_small.set 13x8 GTAP-EG sets 10x10 GTAPinGAMS sets
gtap_small.set 10x10 GTAPinGAMS sets
gtap.set GTAP4 sets IEA-GTAP mapping
iea.set IEA-GTAP sets
notax.def New tax rates definitions
INCLIB standard aggr.gms Aggregation
GAMS checkset.gms Check set
utilities chktarget.gms Check target
gams2har.gms Move to HAR format
gams2prm.gms Move to GAMS parameter
gams2tbl.gms Move to table
gams2txt.gms Move to text file
gdpreport.gms Report GDP
har2gams.gms Move from HAR format
mrtdata.gms GTAP parameters calculation
unzip.gms Call unzip
zip.gms Call zip
MODELS Illustrative gtap-eg.gms The GTAP-EG Model
models runall.bat Run all GTAPinGAMS Models
mrttest.gms Test all GTAPinGAMS Models
cnstest.gms Test CNS GTAPinGAMS Model
mcptest.gms Test MCP GTAPinGAMS Model
mgetest.gms Test MPSGE GTAPinGAMS Model
nlptest.gms Test NLP GTAPinGAMS Model
mrtcns.gms CNS GTAPinGAMS Model
mrtmcp.gms MCP GTAPinGAMS Model
mrtmge.gms MPSGE GTAPinGAMS Model
mrtnlp.gms NLP GTAPinGAMS Model
readme.txt Installation Directions


To install the GTAP4inGAMS package:

To create the full version of the GTAPinGAMS dataset:

To create the full version of the GTAP-EG dataset:

The GTAPinGAMS dataset (build routine BUILD.BAT)

The GTAP4inGAMS dataset is built on the standard GTAP4 database, which is not distributed freely. In order to construct the full GTAP datasets, a user needs to contact GTAP to obtain the GTAP4 dataset (the file gsddat.har).

The file gsddat.har should be placed into the DATA subdirectory of the GTAPinGAMS package. To create the full version of the GTAPinGAMS, a user needs to run build.bat file. For this, in MS-DOS prompt (make sure that you are connected to a proper directory) type build and press Enter. Run time on Pentium 500 is about 8 minutes (Make sure that GAMS is included in the PATH variable of your computer's MS-DOS. To check it, in MS-DOS prompt type path and press Enter).

The file build.bat is intended to:

Once you successfully run the BUILD routine, you can use the full GTAPinGAMS dataset which is placed in the DATA subdirectory. Your computer may not have enough memory to run your models on the full dataset. Therefore, the aggregation routine GTAPAGGR.BAT (described below) can aggregate the original GTAP data into the smaller datasets. You can choose what aggregation is appropriate for studying your particular application.

The GTAP-EG dataset (build routine ASPEN.BAT)

The GTAP-EG dataset is built on the standard GTAP4 database and calibrated to energy quantity and price data. In order to construct the full GTAP-EG dataset, a user needs to run aspen.bat file. For this, In MS-DOS prompt, type aspen and press Enter. Run time on Pentium 500 is about 4 minutes. If the full version of the GTAPinGAMS dataset has not been created yet, then the BUILD routine (described above) will be automatically called.

The file aspen.bat is intended to:

Users can edit aspen.bat to suit their specific applications. In particular, a pause option can be uncommented for every step to see all the stages of the dataset creation (To uncomment a pause command, delete a :(column) sign, i.e. change a line from :pause to pause.). The original build routine has a pause in one place only - before the aggregation and running the illustrative model. At this point, in MS-DOS window you'll see a message:

Aggregate to 13x8, include energy projections and create Will aggregate to Press any key to continue . . .

If you press any key, then in addition to the full dataset an aggregated dataset will be created (a new file will replace an old one) and an illustrative model will run on an aggregated data. If you press ``Ctrl-C'', then the following message appears.

Terminate batch job (y/n)?

If you terminate the batch job at this time (by pressing ``y'' and then ``Enter''), aspen.bat will stop and only the full version of the GTAP-EG dataset will be created and placed into DATA subdirectory under the name

In the process of building the dataset, several echo files are placed in the ASPEN subdirectory:

Aggregated datasets

The GTAP4inGAMS package contains the aggregated versions of the GTAPinGAMS dataset and the GTAP-EG dataset. They are provided for testing purposes.

A user can check the installation by running the models on the aggregated GTAPinGAMS dataset (file, which is located in the DATA subdirectory and ready to use. The archive contains the data file gtap_small.gms, and associated SET and MAP files. The aggregated GTAPinGAMS dataset has 10 sectors, 10 regions, and 5 factors of production. Aggregate regions in the model include the US, Japan, the EU and China, Other OECD, Former Soviet Union, Central European Associates, Other Asia, Mexico plus OPEC and Rest of World. Commodities in the dataset include the investment aggregate, five energy goods, metals-related industry, other energy-intensive industries, other manufactures and services. For more information, read the GTAP4inGAMS description.

The archive also contains an aggregated version of the GTAP-EG dataset. It is located in DATA subdirectory and named The archive contains the data file aspen_small.gms, and associated SET and MAP files. The aggregated dataset has 13 regions, 8 goods, and two primary factors. The identifiers for the aggregated GTAP-EG dataset are contained in the SET file. For more information, read the GTAP4inGAMS description.

The Aggregation Routine GTAPAGGR.BAT

Once you have built the initial GTAPinGAMS or GTAP-EG dataset, you can begin to think about a particular application and which aggregations of the original GTAP-EG data would be appropriate for studying those issues. Typically it is useful to create two aggregations for any new model, one with a minimal number of regions and commodities and another with a larger number of dimensions. The small aggregation can then be used for model development.

The gtapaggr.bat program is used to aggregate the GTAPinGAMS and the GTAP-EG datasets. A command line argument defines the name of the target aggregation. You only need to provide the batch file with the target because the target's mapping file defines the source. Before running gtapaggr.bat, you must create two files, one defining the sets of commodities, regions and primary factors in the target dataset, and another defining the name of the source dataset and a correspondence between elements of the source and target. The aggregation routine produces a brief report of GDP and trade shares in the new dataset. The SET and MAP files for a new dataset are GAMS-readable files located in the DEFINES subdirectory. For more information, click here.

Back to GTAPinGAMS Homepage

Back to HomePage

Maintained by Sergey Paltsev
Last Updated 01/23/01