﻿=====================================
Bernstein Paper Atlas
Wiz - Visualizing georeferences software
=====================================
Vlad Atanasiu - version 2008.06.21



DOCUMENTATION

Goal of software
---------------------------
This software generates a map on which the location of 
placenames in the Bernstein Paper Atlas is visualized   
(http://www.bernstein.oeaw.ac.at). It is intended as a 
development support tool for georeferencing.

Software species
---------------------------
Written in MATLAB Version 7.4 (R2007a), Mapping Toolbox 
Version 2.5 (R2007a). Standalone for Windows XP.

Elements of the command window
---------------------------

Load data - Push to load the file with geographical references.
The data to be visualized is the dalek.xls file, which 
contains names of places, geographical coordinates
and region names. The content of the file is described in
its own documentation.

Sources selection - Make one or more selections among the
sources from where the georeferences were extracted.

Locations selection - Select the locations or regions for 
visualization. By default all locations are displayed ("Locations" 
is selected). The regions correspond to the The Nomenclature of 
Territorial Units for Statistics (NUTS) 2003 
(http://ec.europa.eu/eurostat/ramon/nuts/splash_regions.html).

Map - Push to generate the map showing the selected locations.

Target - "New window" generates maps in new windows for each 
new selection, "Overwrite" uses the same window for new maps
and "Superpose"  superposes new locations (red crosses) over
previous locations (blue circles). This option is useful to compare
the locations in two datasets.

Extension - Extends the map to the "World" or of "Europe".

Resolution - Displays less or highly detailed boundaries. Simpler
boundaries are quicker to draw.

Grid - Display the map grid.

Regions - Display NUTS regions boundaries (it might take 
quite a while to draw the boundaries). The availability of this
option depends on wherever a file containing the boundary
information and called "nuts.mat" is present in folder "shapes" .

The Matlab file should have the following structure.
nuts.nuts0
nuts.nuts1
nuts.nuts2
nuts.nuts3
nuts.nuts0.name - NUTS0 names
nuts.nuts0.longitude - longitude coordinates vectors
nuts.nuts0.latitude - latitude coordinates vectors
nuts.nuts0.id - NUTS0 code
idem for nuts1 to 3

NUTS boundaries are copyrighted by EuroGeographics
(http://www.eurogeographics.org).

Close - Close all active map windows.

Help - Displays this documentation.


Elements of the map window
---------------------------

Location information - Click once on the window to initiate the 
interactive functionality. Right-click near a locations to display 
its name, coordinates, NUTS regions and alternative names. 
Left-click to exit the information mode.

Zoom - Toggle the zoom-in, zoom-out, hand-movement icons.
To zoom you can click to zoom centered on the clicked point,
or click, hold and move the mouse to make a rectangular 
selection.

Save figure - formats: tiff, jpg, ai, svg, pdf, eps, etc.

Print figure
