Next / Previous / Contents / TCC Help System / NM Tech homepage

5. The wayplot script: GUI display of waypoints on a base map

Once you have built up a map base for a given area, and created a set of GPS waypoints in that area, use the wayplot script to display the waypoints on the base map in a graphical user interface.

To run this program, use this command line:

    wayplot [options ...] wayfile [route-id]...

where the options include:

-m mag

specifies a magnification as a magnification code; the default is 4.

-k kind

specifies a kind of tile, 1 for photoquad tiles, 2 for topo map tiles. The default is 2.

-b map-base

Specifies the directory containing the map base (see building the map base, above). The default is subdirectory tiles in the current directory.

-x margin

Specifies an extra margin to be shown around the rectangle defined by the waypoints. The units of margin are in tiles, and the default value is 0.5, that is, half a tile. For example, if you are using photo tiles maps at 1 meters/pixel scale, a tile is 200 meters on a side, and the default margin is 100 meters. If you set the option -x 2.0, you would get a margin of 400 meters.

Positional arguments to the wayplot script:

wayfile

Specifies the waypoint file to be read. If no route in this file is selected by name or ID, all the waypoints in the file are displayed.

route-id

Selects one <route> element in the waypoint file, by specifying its id attribute. Any number of route IDs may be specified; if none are given, all the routes in the waypoint file are displayed.

You must be in an environment where you can create new windows. The script will bring up a window showing the base map in a large frame, with assorted controls (described below). You can drag the map around in the big frame by dragging with the middle mouse button.

The waypoints will be shown as circled numbers. Clicking mouse button 1 on a waypoint will display the descriptive text on that location from the waypoint file.

Other controls and indicators include: