Welcome Intro Format Data Download

LINMAP Program Documentation

Introduction and Basic Use of LINMAP

LINMAP is a FORTRAN mapping program designed to display outlines of areas which match corresponding verbal descriptions in a large European ethnohistorical dataset. The accompanying ethnohistorical dataset describes the locations and movements associated with most known ethnic units from 3000 BC to 1970 AD. Each data record is identified by both a reference and record number, which refers back to a master reference list, specifying the cited historical source for displayed information. To effectively use LINMAP, you should have a printed copy of the ethnohistory dataset at hand while running the program.

To view a particular area, you can invoke the installed program by typing LINMAP at the DOS prompt. The program displays the question "polygon number?" in a small box in the upper-left corner of the screen display. You should be prepared to enter the reference and record numbers matching the record you wish to examine, with a single space separating the values. For example, typing 238 3 in the corner query box will cause LINMAP to display an outline for Turkey showing where a subgroup of the Crimean Tatars migrated to from 1878 to 1880 (See example below). The program displays a message "searching for 238 3" while it searches the input data file. The program is ready to display another outline when it once again indicates the question "polygon number?".

If the return key is pressed prematurely or an invalid number is given to LINMAP, the program displays the message "cannot find it" under the usual "polygon number?" prompt. To exit from LINMAP, hit the CTRL-Z keys simultaneously, followed by ENTER.

Customizing the Screen Display for LINMAP

You can change the default screen display for LINMAP by altering values specified in the configuration file, LINMAP.CFG. You can change the default settings by editing the LINMAP.CFG file with an ASCII text editor.

LINMAP.CFG contains the following default options/settings:
0                       Display grid? (0=no 1=yes)
1                       Display political boundaries? (0=no 1=yes)
1                       Display rivers? (0=no 1=yes)
7                       Set the background color.
8                       Set the 1 degree grid color.
15                      Set the 10 degree grid color.
15                      Set the coastline color.
15                      Set the political boundary color.
9                       Set the river color.
9                       Specify the number of polygon colors to use.
11 12 13 14 10 2 3 4 5  Specify a color list for data outline display.

Note: the display color choices (from 0-15) are:

 0 black    4 red           8 dark gray      12 light red
 1 blue     5 magenta       9 light blue     13 light magenta
 2 green    6 brown        10 light green    14 yellow
 3 cyan     7 light gray   11 light cyan     15 white
You can turn on an optional 1-degree latitude/longitude grid by changing the value in column 1 of line 1 from 0 to 1. Similarly, you can choose whether or not to display political boundaries and rivers by modifying the values in lines 2 and 3.

Lines 4-11 of the configuration specify the color settings to use for various aspects of the screen display. (You can choose any color from 0 to 15--see the color list specified above for choices.) The configuration shown above will use light gray (7) for the background color, dark gray (8) and white (15) for the latitude/longitude grid (if grid is turned on by a 1 in line 1), white (15) for coastlines, white (15) for political boundaries (if turned on by a 1 in line 2), and light blue (9) for rivers (if turned on by a 1 in line 3).

The final two active lines (10 and 11) of the configuration specify the number of colors to use for displaying outlines and the list of the order in which the colors are to be used. You can choose up to 9 colors for display. The colors specified in the final line will be used in order until the last one is used. At that point, the first color will be re-used for data display. The program will display as many outlines as the user wishes. If the map becomes too busy it can be refreshed by exiting the program as shown below and redrawing the map of Europe.

Emergency exits

To exit the program, simply hit the CTRL-Z keys simultaneously, followed by ENTER. However, if your computer display freezes, and you cannot exit normally, you can abort LINMAP by pressing the CTRL-Break keys simultaneously and then ENTER. DOS will display the prompt "terminate batch job y/n?" and you should respond y (yes). To reset your computer from graphics to text mode after a sudden interrupt, type MODE co80 at the DOS prompt. (The reset is automatic when using the normal CTRL-Z, ENTER exit.)

Welcome Intro Format Data Download

Last Altered January 10, 1996
E-mail: Questions/Comments Technical Problems
The Ethnohistory Project / msr@life.bio.sunysb.edu