MAPPER

Section: User Commands (1)
Updated: $Date $
Index

NAME

mapper - create maps from measurements

SYNOPSIS

mapper [-o outputfile] [-f tolerance] [-i limit] [ mapperfile ]

DESCRIPTION

mapper Mapper calculates the map coordinates of places, given measurements of their relative positions. Measurements may be in terms of the distances between places, bearings of one places from another, and relative bearings of two places from a third place. The program can also take information traced from existing maps. The program takes into account the inaccuracy of the measurements, so it is reasonably robust when given inaccurate or incorrect measurements.

mapper reads a file that gives the measurement information. This file can also include hints to mapper , so it is easier for the program to calculate the point positions. This input file is in XML format. mapper writes its results to standard output. This output is in the same XML format. In effect, mapper transforms a file having incomplete or inaccurate map information (incomplete or inaccurate because it does not have the correct coordinates of places) to a file having complete information. Technically speaking, the file format is an XML application , called Map-Data, and defined in a Document Type Definition (DTD) called Map-Data.dtd.

Mapper writes error messages to standard error output.

OPTIONS

-o outputfile: Write the resulting map data to the indicated outputfile rather than to standard output.
-f tolerance: Use the indicated calculation tolerance when calculating the point positions. This is a positive real number smaller than 1. Smaller values produce more accurate results, but take longer to calculate. The default value is 1E-8.
-i limit: Perform no more than the indicated ( limit ) number of iterations when calculating the point positions. This must be a non-negative integer.
: If 0 is given, which is the default, mapper will not calculate the point positions. Instead, it will only parse the input and write the unaltered data to output, with all defaults and cross-references filled in.
mapperfile: Read input data from the indicated mapperfile . The default is to read data from standard input.

EXAMPLES

Do a rough calculation, to an accuracy of only 1E-4 and with no more than 500 iterations:

: mapper -i 500 -f 1E-4 map_data.xml

AUTHOR

Copyright (C) 2002 Benedict Adamson. Mapper is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Mapper is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Mapper; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

For more information about Mapper, visit the following web site: http://www.badamson.nildram.co.uk/Mapper.

This document was created by man2html, using the manual pages.
Time: 15:53:14 GMT, July 14, 2002