The contents of this legacy page are no longer maintained nor supported, and are made available only for historical purposes.

GeoPlot: Applet Parameters

List of Applet Parameters for GeoPlot continues with parameter:data below.

GeoPlot is considered a deprecated tool and is not any longer supported by CAIDA. These pages are made available for historical purposes.


List of Parameters

Parameter : mapname


The mapname parameter is used to specify the name of the image that is to be used as the background. An image has to be specified to use GeoPlot. The image can be specified in two ways. One is to specify the filename including path if required from the document base, or the other method is to specify a URL.
Example:
<param name=mapname value="xyz.gif">
<param name=mapname value="/maps/xyz.gif">
<param name=mapname value="URL">

Parameter : bgcolor


The bgcolor parameter is used to specify the background color of the applet. The color can be either specified as a word or as a RGB value. Colors lists the supported colors in words and also indicates the syntax to specify the RGB value. The default value used is white.
Example:
<param name=bgcolor value="lightGray">
<param name=bgcolor value="rgb-255-0-255">

Parameter : fgcolor


The fgcolor parameter is used to specify the foreground color for the applet. This color will be used as the color with which all text and mouse overs are drawn on the applet. Colors lists the supported colors in words and also indicates the syntax to specify the RGB value. The default value used is black.
Example:
<param name=fgcolor value="red">
<param name=fgcolor value="rgb-255-0-0">

Parameter : title


The title parameter is used to specify the title of the image, the title is displayed centered at the top of the applet. There is no title by default. The user has the alternative of specifying the title using html tags and not making it part of the applet.
Example:
<param name=title value="xyz">

Parameter : date


The date parameter specifies the date that gets displayed at the top right-hand side of the applet. There is no date by default.
Example:
<param name=date value="07/15/1999">

Parameter : default_node_size


The default_node_size parameter gives the diameter of the circle with which nodes that have no indiviual size values are drawn on the applet. The default is taken as 6.
Example:
<param name=default_node_size value=6>

Parameter : default_line_size


The default_line_size parameter gives the width with which lines that have no size values are drawn on the applet. The default is taken as 1.
Example:
<param name=default_line_size value=1>

Parameter : default_node_color


The default_node_color gives the color of the circle for nodes that do not have their own color values. The default color is black.
Example:
<param name=default_node_color value="red">

Parameter : default_line_color


The default_line_color gives the color with which lines that do not have their own color values are drawn. The default color is red.
Example:
<param name=default_line_color value="green">

Parameter : default_font_size


The default_font_size parameter specifies the size of the font to be used for all writings on the applet. There is no option to specify a font and the font used is Dialog. The default value for this parameter is 10.
Example:
<param name=default_font_size value=10>

Parameter : refresh_interval


The refresh_interval parameter is used to specify the time interval in seconds after which the data is refetched and the applet is redrawn. The URL for the data file is specified in the data parameter. By default the applet does not refresh its contents.
Example:
<param name=refresh_interval value=60>

Parameter : hide_key


The hide_key parameter toggles the display of the color and size keys if either is present. A value of FALSE displays the keys and a value of TRUE hides the keys. By default the keys are displayed if they exist.
Example:
<param name=hide_key value="false">

Parameter : top_lat


The top_lat parameter should indicate the latitude at the top-left hand corner of the image. This value must be specified. If this parameter confuses you read Using Latitude and Longitude and look at example which picks out the top latitude value from France's map.
Example:
alt alt

<param name=top_lat value=52>

Parameter : top_lon


The top_lon parameter should indicate the longitude at the top-left hand corner of the image. This value must be specified. If this parameter confuses you read Using Latitude and Longitude and look at example which picks out the top longitude value from France's map.
Example:
alt alt

<param name=top_lon value=-5>

Parameter : bot_lat


The bot_lat parameter should indicate the latitude at the bottom-right hand corner of the image. This value must be specified. If this parameter confuses you read Using Latitude and Longitude and look at example which picks out the bottom latitude value from France's map.
Example:
alt alt

<param name=bot_lat value=42>

Parameter : bot_lon


The bot_lon parameter should indicate the longitude at the bottom-right hand corner of the image. This value must be specified. If this parameter confuses you read Using Latitude and Longitude and look at example which picks out the bottom longitude value from France's map.
Example:
alt alt

<param name=bot_lon value=9>

Parameter : color_key


Using the color_key parameter, it is possible to define a color key that can be used to determine the color of the lines drawn. Line definitions would have a color value that would get matched against this key to determine the color of the line. Such a color value takes precedence over a color defined for the line using the cl: parameter. The syntax for defining the key is shown below.

EACH LINE OF THE COLOR KEY DEFINITION MUST BE SEPERATED BY A SEMI-COLON. The line that begins with the keyword key defines the dimensions of the key and where it is to be drawn in the applet. Other lines define the different key items.
Syntax of first line: key,x: ,y: ,w: ,h: ,t: ,s: ;
x: x-coordinate of the top-left hand corner of the key
y: y-coordinate of the top-left hand corner of the key
w: width of the key
h: height of the key
t: title of the key (Cannot have a comma in the title as of this release)
s: font-size with which title should be displayed, the key labels are displayed at a font-size 3 less than the value specified here

Syntax for defining key elements: (value/range) : (color) : [(description)];
The value can be expressed either as a single value or as a range. The syntax for expressing the value as a range is lower_bound && upper_bound The color is expressed either as a word or RGB value. The description is optional, if none is specifed then the value is written next to a square that shows the color on the key. The font size is 3 less than what ever was specified for the key title.
Example:
<param name=color_key value=
"key,x:10,y:400,w:150,h:110,t:% of Bytes,s:13;
0 && 0.01 : black : From USA;
0.01 && 0.02 : rgb-255-0-0;
0.02 && 0.03 : cyan;
0.03 && 0.04 : gray;
0.04 && 0.05 : darkgray;
0.05 && 0.06 : magenta;
0.06 && 0.07 : orange;
0.07 && 0.08 : pink;
0.08 && 0.09 : blue;
0.09 && 0.1 : yellow;
0.1 && 100 : green;">

Parameter : size_key


Using the size_key parameter, it is possible to define a size key that can be used to determine the width of the lines drawn. Line definitions would have a size value that would get matched against this key to determine the width of the line. Such a size value takes precedence over a size defined for the line using the sz: parameter. The syntax for defining the key is shown below.

EACH LINE OF THE SIZE KEY DEFINITION MUST BE SEPERATED BY A SEMI-COLON. The line that begins with the keyword key defines the dimensions of the key and where it is to be drawn in the applet. Other lines define the different key items.
Syntax of first line: key,x: ,y: ,w: ,h: ,t: ,s: ;
x: x-coordinate of the top-left hand corner of the key
y: y-coordinate of the top-left hand corner of the key
w: width of the key
h: height of the key
t: title of the key (Cannot have a comma in the title as of this release)
s: font-size with which title should be displayed, the key labels are displayed at a font-size 3 less than the value specified here

Syntax for defining key elements: (value/range) : (width) : [(description)];
The value can be expressed either as a single value or as a range. The syntax for expressing the value as a range is lower_bound && upper_bound The color is expressed either as a word or RGB value. The description is optional, if none is specifed then the value is written next to a square that shows the color on the key. The font size is 3 less than what ever was specified for the key title.
Example:
<param name=size_key value=
"key,x:170,y:440,w:150,h:70,t:% of Bytes,s:13;
5 : 22 : Telnet;
11 && 20 : 12 : Rlogin;
21 && 30 : 8 : SSH;">

Parameter : data


The data parameter is used to define the nodes and lines that need to be plotted. This can either be an URL to a data file containing all the definitions in the specified format or in the applet tag itself. All node and line definitions must be terminated by a semi-colon.

NODES

Syntax :

Field 1 Field 2 Field 3 Field 4 [Field 5]
n/N key latitude longitude Optional Description String

Field 1 : this field tells GeoPlot that your defining a node.
Field 2 : this field must uniquely identify each node, any unique identifier can be used.
Field 3 : latitude of the node.
Field 4 : longitude of the node.
Field 5 : the table below shows the optional attributes that can be specified for each node.
t: title
sz: diameter of node
vc: color value that is matched against color key
vs: size value that is matched against size key
cl: color of node
u: URL to open when clicked on
d: description that is shown in status bar when mouse is over node

Placement of Title :

GeoPlot automatically places the title in the best possible location around the node, best refers to the area where there is the least number of lines connected to the node. The user also has the option of overriding this placement and specifying their own location. This is defined as a value following the title seperated by a comma. Commas can be placed in the title, this will not affect the final location attribute if there is one.The values correspond to the quadrant diagram shown below with the circle in the center representing the node.
alt
56 title appears centered between quadrants 5 and 6
21 title appears centered between quadrants 1 and 2
70 title appears centered between quadrants 0 and 7
43 title appears centered between quadrants 3 and 4
0 through 7 title appears begining or ending in their respective quadrant

Example:

n CN 38.00 105.00 d:This was the 1st node definition;
n US 38.00 -98.00 t:USA,70 d:This was the 2nd node definition u:http://www.aciri.org;
n RO 46.00 25.00 d:This was the 3rd node definition;
n CA 60.00 -96.00 t:Canada cl:rgb-0-255-0 d:This was the 4th node definition;


LINES

Syntax :

Field 1 Field 2 Field 3 [Field 4]
l/L source key destination key Optional Description String

Field 1 : this field tells GeoPlot that your defining a line.
Field 2 : source node
Field 3 : destination node.
Field 4 : the table below shows the optional attributes that can be specified for each node.
t: title
sz: width of line
vc: color value that is matched against color key
vs: size value that is matched against size key
cl: color of line
u: URL to open when clicked on
d: description that is shown in status bar when mouse is over line
r: direction of arrow

Types of Lines :
There are three kinds of lines that can be drawn between nodes. The simplest is just a single line between the source node and the destination node. Lines can also be drawn with both the source and the destionation referring to the same node. Such lines are depicted as circles and there can be more than one of these definitions. The maximum for a single node is 24 lines going to itself. There can be any number of lines between a pair of nodes and their definitions don't have to be together in a single block. All the indiviual lines between the nodes are drawn seperately and there is no aggregation.
Placement of Title :

alt
By default GeoPlot places the title of a line at the locations marked 3 in the diagram above. The user can override this by specifying their own location. This is defined as a value following the title seperated by a comma. Commas can be placed in the title, this will not affect the final location attribute if there is one. In the case of circles which represent links between the same source and destination node, titles are placed by default at location 2 in the diagram shown below and there is an additional value '4' that can be specified.
alt

Direction of Arrow :

alt
By default arrows are not drawn on lines. They must be specified with the r attribute and can take any of the three values described below. Arrows are not marked on links starting and ending at the same node.
1 arrow at destination end of line
2 arrow at source end of line
3 arrow on both ends

Example:

l US AU vc:0.15 vs:25 d:Fat pipe USA-AUS u:http://www.cnn.com;
l US AU vc:0.025;
l AU US;
l AU US vc:0.045;
l AU US cl:rgb-255-0-255;
l BR BR vc:0.015 vs:25;
l US BR vc:0.025 r:3 t:USA-BRAZIL,1;

Colors


There are thirteen colors that can be expressed in words. They are listed below:
black  
red  
blue  
cyan  
darkGray  
gray  
green  
lightGray  
magenta  
orange  
pink  
white  
yellow  

Colors can also be expressed as a RGB value.
Syntax : rgb-r-g-b
All values have to be expressed in decimal form
r red component
g green component
b blue component

Using Latitude and Longitude


grid map
This picture shows how latitude and longitude usually appear on a map. The red line is the equator. All the latitudes above the equator are North latitudes, and those below are South latitudes The blue line is the Prime Meridian. The meridians to the left of the blue lines are West longitudes, and those to the right are East Longitudes.
If this were a graph in math class, you would read the bottom numbers (the X axis) first. This may seem odd, but maps are different. On a map you must read the side first to determine the latitude, and then the bottom last to determine the longitude. South latitudes and West longitudes should be specified as negative values to GeoPlot.
Explanation taken from: http://www.acs.ucalgary.ca/~dmjarvey/tutorial

Related Objects

See https://catalog.caida.org/software/geoplot/ to explore related objects to this document in the CAIDA Resource Catalog.
Published
Last Modified