Uwe A. Schneider

last update: February 24, 2011

Modifications from Tom Rutherford's Interface  


Syntax and Use

Format Options

Syntax for Loops

Map Examples

Map creation and enhancement


This GAMS - SHADEMAP interface is a modification of the interface developed by Tom Rutherford . SHADEMAP has been developed by Mark Horridge .

Other GAMS interfaces  from/to:  ShadeMap   Gnuplot   Stata    Powerpoint    Html    Awk


Modifications from Tom Rutherford's Interface  

 1) A GAMS system subdirectory .\gislib is needed and used to store the data to produce maps

 2) There are three files for each map being stored in <gams system directory>\gislib :
         a) <map ID>.mif
         b) <map ID>.mid
         c) <map ID>_sm.gms

 3) The file mapsets.exe is no longer used and needed

 4) shademap.gms has been modified

 5) Several maps can be executed once.



1) Extract files for Shademap program to GAMS system directory

2) Place shademap.gms  in .\inclib subdirectory of GAMS system

3) Create .\gislib subdirectory of GAMS system

4) Place three files for each map in the .\gislib subdirectory of GAMS system. You can create these files on your own (see description below) or download the available maps from below:

Map ID













Syntax and Use

A map is invoked through the following statement in your GAMS program.

$libinclude shademap <map ID> <Parameter>

for example:

Set yoursetname /<firstmapelement, ... , lastmapelement>/;
Parameter v(yoursetname ) Shade Values for the Map of Europe;
v(yoursetname) = uniform(0.5,1);

[format options - see below]
v(yoursetname) = uniform(0.5,1);
$libinclude shademap Europe v
v(yoursetname) = uniform(2,3);
$libinclude shademap Europe v


Format Options (the values of the global variables are case sensitive. "False" may not work, but "false" does.)

$setglobal sm_LineWidth 0
$setglobal sm_RegLineWidth 0
$setglobal sm_FontSize 6
$setglobal sm_SpaceAround 10
$setglobal sm_DesiredWidth 700
$setglobal sm_yytrans 120
$setglobal sm_xDistort 0
$setglobal sm_yDistort 0
$setglobal sm_DotCentroids false
$setglobal sm_DotPolyStarts false
$setglobal sm_UseGreys false
$setglobal sm_OrdinalShades false
$setglobal sm_RGBScores false
$setglobal sm_NumberRegions false
$setglobal sm_ShowScores false
$setglobal sm_ShowNames false
$setglobal sm_NumberRegionPatch false
$setglobal sm_ScoreNDec 1
$setglobal sm_LegendPos "10 70"
$setglobal sm_LowColor blue
$setglobal sm_MidColor red
$setglobal sm_HighColor mediumorchid
$setglobal sm_ShowLegend true
$setglobal sm_TitlePos "70 95"
$setglobal sm_Title "My Plot Title"
$setglobal sm_BackgroundColor orangered
$setglobal sm_RegLineColor yellow
$setglobal sm_AutoScale false
$setglobal sm_ScaleBounds "0 50"

Available Color Choices for

Variable name Default color RGB value
sm_LowColor yellow 180 255 255


225 225 90
sm_HighColor red 255 100 100
sm_BackgroundColor some blue 0 128 192
sm_RegLineColor  black 0 0 0







You can loop over shademap statements.

Outside the loop, place the following statement:

$libinclude shademap <map ID> loop

If you want to see the loop element in the title, put the following statement(s) below before the loop:

$setglobal sm_loop1 MyScenarioSet1

$setglobal sm_loop2 MyScenarioSet2

$setglobal sm_loop3 MyScenarioSet3

Inside the loop, as before place

$libinclude shademap <map ID> <Parameter>


for example:

$libinclude shademap <map ID> loop

$setglobal sm_loop1 MyScenarioSet1

$setglobal sm_loop2 MyScenarioSet2

$setglobal sm_loop3 MyScenarioSet3

$setglobal sm_Title "This plot shows: "
LOOP( (MyScenarioSet1, MyScenarioSet2,MyScenarioSet3),

$libinclude shademap <map ID> <Parameter>



Map Examples

The quality of maps is usually higher than the quality of the maps below.

If you use firefox you may not see the image below because they are in EMF format which is not supported by firefox. You can see the images with the internet explorer and perhaps with other browsers. With firefox, you can right click the image icon and choose a program to display the image.


World Countries


Europe NUTS2



The Contiguous US States


All US States


US Counties


The 10 US FASOM Regions



The 11 GGI-FASOM Regions


Map creation for GIS maps   

The following steps describe how to create new maps using ArcView 3.x or Mapinfo. With a special data exporting script (for download below), one can create two files for each map using Arcview. These files, however, must be further processed in order to match the required format for shademap. I have written small awk scripts for use with GAMS that do the job. These awk scripts will be used if you follow the steps below.

1) Convert ArcGIS Shape files to MIF/MID format using Geoconverter

2) Create a new directory of your choice 

3) Change the name of the <yourmapname>.mif file into <yourmapname>_mif.gis
    Change the name of the <yourmapname>.mid file into <yourmapname>_mid.gis

4) Place <yourmapname>_mif.gis and <yourmapname>_mid.gis into a GIS subdirectory of your new directory

5) Extract these files in the new directory and open a GAMS project in your new directory. The following files should be in this directory:


6) Open file 1_prepare.gms

7) Place <yourmapname> as additional set element in the set mapname.

8) Select from the set mapname all maps (each element identifies a map) you want to prepare

8) Run 1_prepare.gms (This will create 2_runawk.gms and 3_putfiles.gms )

9) Open 2_runawk.gms and 3_putfiles.gms and execute sequentially  (3_putfiles.gms will produce one or more maps called 4_map_<map ID>.gms)

10) Run 4_map_<map ID>.gms files to check whether it works


Map enhancement

Mark Horridge has written a DOS tool to improve maps. Cleanmap.exe is included in the zip file which contains the shade map program.

Syntax: takes 2 filenames (WITHOUT extensions) and a number as parameters:

cleanmap inmapnam outmapnam frac

inmapnam name of existing MapInfo region boundaries files (suffixed MIF/MID)
outmapnam name of new MapInfo region boundaries files (suffixed MIF/MID)
frac fraction (eg, 0.01) remove polygons area < frac*largest poly in region
tol (optional) remove polygons area < tol. The largest polygon in a region is never removed.



Legal Notice