MAPresso: Parameters

Parameters in red are required. Parameters with *: can be set as default for all datasets or for each dataset by substitute * by the dataset number. Parameters in italics indicate deprecated parameters.
Colors have to be defined in a RGB color system.

To start it is enough to define the number of areal units and an appropriate geometry. There are default values for all other parameters.

Texts: For special characters there are special escape sequences (starting with $)

Basics, Layout

nobs

Number of areal units.

language

Language (of dialogs, menus) (en: english / de: deutsch / fr: français / it: italiano).

xmap / ymap

Position of the top left corner of the map (0 / 0).

 

xleg / yleg

Position of the top left corner of the legend (2 / 7).

infolevel

Level of debug messages (0: no msg / 9999: many).

Geometry

geo*

URL or relative path of the polygons in ARC/INFO shape file format (with extension ".shp"; there must be also a ".dbf" file with the same name containing the IDs as 3rd column
or
URL or relative path of the polygons in "psc" format (with extension ".psc"). This kind of outline data set may be compressed and end in "psc.gz".

or
URL or relative path of the polygons in "cir" format (with extension ".cir"). The circle format is used as a result of a Dorling cartogram.
Normally there is just one geometry, you use "geo", otherwise you would need "geo1", "geo2", etc.

geoname*

Name of the geometry which apears in the pop-up-menu (only when there is more than one geometry).

nam

URL or relative path of the areal unit names (with extension ".nam")

lab

URL or relative path of the areal unit labels (only for circles)

filter

Filter data set. Format of the filter dataset: (not yet described)

filterW

Weight data set. Format of the filter weight dataset: (not yet described)

hinumgeo

Maximum number of geometry files (5)

Datasets

data

Dataset name (delimited text - tabs, blanks, semicolon with extension ".txt"; may end in "txt.gz" - compressed data); first row contains variable names. Data in clipboard has to be in the same format.

or
URL or relative path of the polygons in "dbf" format (with extension ".dbf").

 

vnm

Additional information about the variables (in the same order as the variables appear in the data file. Tabulator delimited are the following items (one variable per record):
variable name<tab>data type<tab>data units<tab>long data units

variable name (may not be the same as in the data file but a longer one)
data type: relative or absolute values (r / a). With relative values it is no possible to create cartograms; absolute values are used to make cartograms, they are visualized by areal density values.
data units: e.g. "%" (appears in information windows) ("")
long data units: e.g. "[per capita]" (appears below the legend) (=data units)

 

dataorder

Order of the variables how they appear on the menu (1, 2, 3, 4, ....). All *-parameters refer to the original order in the dataset.

 

exclude

Variables may be excluded from the popup menu. Example: (1, 2) = do not include the first two variables; (-1, -2) = do not include the last two variables. The numbers refer to the original order (before sorting by "dataorder").

 

digits*

Number of digits after the decimal point (1)

 

hinum

Maximum number of variables (50). In the case of txt-files this number is automatically set to the number of read variables.

 

 

 

mtyp*

Type of symbolization: 1: continuously from "bright to dark", 2: continously from "bright" to "mbright" and form "mdark" to "dark"; 3: (...) (1)

classes* (bottom, medium, top)

The 3 "class" values; Defaults: ([mean - 1.5 * standardDeviation], [mean], [mean + 1.5 * standardDeviation])

colors* (white, bright, dark, black, missing, background, border, text)

Colors of the first color scheme (#ffff64, #ffff00, #ff0000, #a00000, #deffde, #dedeff, #000000, #000000: yellow to red)

bicolors* (white, bright, mbright, mdark, dark, black, missing, background, border, text)

Colors of the second color scheme (#a00000, #c70000, #debebe, #bedebe, #00aa00, #009600, #ffffff, #f6f6f6, #000000, #000000: red to reddish gray and greenish gray to green)

eyeexp*

Parameter for the transition from bright to dark

background* / bibackground*

Color of the map background for the 2 color schemes (#dedeff / #f6f6f6)

text* / bitext*

Color of the legend text (#000000 / #000000)

border* / biborder*

Color of the polygon boundaries (#000000 / #000000)

bitri

Experimental feature for the creation of bi- and trivariate maps (0 / 1)

pasteField

Small field where own data values can be pasted in (0 / 1)

EPSMenu

Export of the map as EPS data (appears in a separate window) (0 / 1)

psctMenu

Export of the polygons in a special text format (0 / 1)

reloadMenu

Option to reload newer data form the web server (0 / 1)

writeParamMenu

Export of some main parameters (e.g. changed colors) to the java console (0 / 1)

 

splash

Name of an alternative splash screen (splash.gif)

For the use in the files nam and vnm some special characters can be inserted (e.g. "Z$urich" gives "Zürich"):

 
           $a  ä
           $o  ö 
           $u  ü 
           
           $A  Ä 
           $O  Ö 
           $U  Ü 
           
           $n  â 
           $g  è 
           $e  é 
           $c  ê 
           $m  ë 
           $i  î 
           $t  ô 
           $p  ù 

           $2  2 (small exponent)

           \n  (new line) 
		  

Deprecated, for compatibility to older versions

data*

Dataset name

dbfdat

Dataset name (dbf format, may end in ".gz" - compressed data)

ownbtn

Offers a text field where you can paste your own data values (0, 1).

reloadbtn

Reload (actualized) data values (0, 1). We use this feature during the counting out of votation results with updated data on the server every quarter of an hour.

adjustbutton

Rezize map to window size (not possible as applet in a browser) (0, 1)

geobase

URL or relative path of the geometry ("none": documentbase)

symbolbtn

Brings up a dialog to change colors and class values (0, 1). Clicking into the legend area does the same.

top

values > top: color black

bottom

values < bottom: color white

bright - dark

values between bottom and top: color between the colors bright and dark

eyeexp

parameter for the transition from bright to dark

missing

color for areal units with missing values.

panelnorth

The panel with all these buttons, fields and pop-up-menus is below (0) or above (1) the map.

filterbtn

Add a button to do a simple thematic generalizaton by a polygon filtering (0, 1).

carto

Add a button for the construction of a areal unit cartogram (0, 1). There must be a suited variable with absolute values.

psbtn

Add a button for writing an EPS file to the java console (0, 1). Details.