I-X Map Tool - Addon Help   Based on I-X Technology
AIAI, University of Edinburgh
I-X Map Tool

The I-X Map Tool is an optional State Viewer and can be installed by setting the parameter -state-viewer-class=StateViewMap (rather than the default StateViewTable class). The Map Tool can be displayed using the I-P2 Tools menu.

The I-X Map Tool is based on the Open Source BBN OpenMap system. An OpenMap "properties" file must be present when the Map Tool is used. This must be specified via a -map-properties=<props-file> parameter. If this file is not present an error message is given and the Process Panel and Map Tool will exit.

Other optional parameters are:

According to these paths, the relation object/icon follows the algorithm below:

IF there is an icon in the directory specified in “map-object-icons” parameter with the same name of the object (without the extension .gif), this icon will be used.

ELSE IF the object has a type pattern (e.g. Buckingham.type=palace) AND there is an icon in the directory specified in “map-object-icons” parameter with the same name of the type value (in the example, palace), this icon will be used.

ELSE IF the “map-default-icon” parameter was specified, the related icon will be used.

ELSE the system will use its default icon.

<props-file> Composition

This file is used to configure the map tool and its layers. The parameters that can be used to configure the map are:

Each kind of layer has a particular set of parameter/value in the format <layer prefix>.<parameter>=<value>. The default map property file of the map tool shows a example of layer configuration.
map.layers=world
map.Latitude=0.0
map.Longitude=0.0
map.Scale=128000000.0

world.class=com.bbn.openmap.layer.shape.ShapeLayer
world.prettyName=World Map
world.shapeFile=resources/map-default/map.shp
world.spatialIndex=resources/map-default/map.ssx
world.lineColor=ff000000
world.fillColor=ff009900

The plug-in ix.ip2.map.JpgMapLayer can be used if the application needs to use a jpg figure as a map. In this case the map property file can be configured as the example below:  

map.layers=jpgmaplayer
map.Latitude=17.0f         # centre map latitude
map.Longitude=39.0f      # centre map longitude
map.Scale=8000000.0f   

jpgmaplayer.class=com.bbn.openmap.plugin.PlugInLayer
jpgmaplayer.prettyName=Binni Boundaries    # name to represent the layer
jpgmaplayer.plugin=ix.ip2.map.JpgMapLayer
jpgmaplayer.jpgPath=resources/map/binni.jpg    # path to the jpg file

jpgmaplayer.selfSetting=true                 # if true, you do not need to set the parameters below
jpgmaplayer.latLeftSuperior=25.0f       # top-left latitude
jpgmaplayer.lonLeftSuperior=28.0f      # top-left longitude
jpgmaplayer.latRightInferior=10.0f       # bottom-right latitude
jpgmaplayer.lonRightInferior=48.0f      # bottom-right longitude

Details about configuration of others kinds of layers can be found in the OpenMap API in BBN OpenMap.

  Principal Functions



Clauirton Siebra, CISA/AIAI, University of Edinburgh AIAI