trunk/doc/USAGE.txt

                               Routino : Usage
                               ===============


   There are four programs that make up this software. The first one takes
   the planet.osm datafile from OpenStreetMap (or other source of data
   using the same formats) and converts it into a local database. The
   second program uses the database to determine an optimum route between
   two points. The third program allows visualisation of the data and
   statistics to be extracted. The fourth program is a test program for
   the tag transformations.


planetsplitter
--------------

   This program reads in the OSM format XML file and splits it up to
   create the database that is used for routing.

  Usage: planetsplitter [--help]
                        [--dir=<dirname>] [--prefix=<name>]
                        [--slim] [--sort-ram-size=<size>]
                        [--tmpdir=<dirname>]
                        [--parse-only | --process-only]
                        [--max-iterations=<number>]
                        [--tagging=<filename>]
                        [<filename.osm> ...]

   --help
          Prints out the help information.

   --dir=<dirname>
          Sets the directory name in which to save the results. Defaults
          to the current directory.

   --prefix=<name>
          Sets the filename prefix for the files that are created.
          Defaults to no prefix.

   --slim
          Selects a mode of operation that uses less memory and will
          therefore work where virtual memory is very limited or
          unavailable. Selecting this option will cause raw data to be
          held in disk files with only indexes in RAM. Not using this
          option will still use disk files but only for sequential access
          and the files are memory mapped for random access.

   --sort-ram-size=<size>
          Specifies the amount of RAM (in MB) to use for sorting the data.
          If not specified then 64 MB will be used if the '--slim' option
          is specified or 256 MB otherwise.

   --tmpdir=<dirname>
          Specifies the name of the directory to store the temporary disk
          files. If not specified then it defaults to either the value of
          the --dir option or the current directory.

   --parse-only
          Parse the input files and store them in a temporary file but
          don't process the data into a routing database.

   --process-only
          Don't read in any files but process the existing temporary file
          into the routing database.

   --max-iterations=<number>
          The maximum number of iterations to use when generating
          super-nodes and super-segments. Defaults to 10 which is normally
          enough.

   --tagging=<filename>
          The name of the XML file containing the tagging rules (defaults
          to 'tagging.xml' with '--dirname' and '--prefix' options).

   <filename.osm> ...
          Specifies the filename(s) to read data from, by default data is
          read from the standard input.

   Note: In version 1.4 of Routino the --transport, --not-highway and
   --not-property options have been removed. The same functionality can be
   achieved by editing the tagging rules file to not output unwwanted
   data.

   Example usage:

./planetsplitter --dir=data --prefix=gb great_britain.osm

   This will generate the output files 'data/gb-nodes.mem',
   'data/gb-segments.mem' and 'data/gb-ways.mem'.


router
------

   This program performs the calculation of the optimum routes using the
   database generated by the planetsplitter program.

  Usage: router [--help | --help-profile | --help-profile-xml |
                          --help-profile-json | --help-profile-perl ]
                [--dir=<dirname>] [--prefix=<name>]
                [--profiles=<filename>] [--translations=<filename>]
                [--exact-nodes-only]
                [--quiet]
                [--output-html]
                [--output-gpx-track] [--output-gpx-route]
                [--output-text] [--output-text-all]
                [--output-none]
                [--profile=<name>]
                [--transport=<transport>]
                [--shortest | --quickest]
                --lon1=<longitude> --lat1=<latitude>
                --lon2=<longitude> --lon2=<latitude>
                [ ... --lon99=<longitude> --lon99=<latitude>]
                [--highway-<highway>=<preference> ...]
                [--speed-<highway>=<speed> ...]
                [--property-<property>=<preference> ...]
                [--oneway=(0|1)]
                [--weight=<weight>]
                [--height=<height>] [--width=<width>] [--length=<length>]

   --help
          Prints out the help information.

   --help-profile
          Prints out the selected transport profile (type, speed limits,
          highway preferences etc.)

   --help-profile-xml
          Prints out all the loaded profiles as an XML file in the same
          format that can be loaded in.

   --help-profile-json
          Prints out all the loaded profiles in JavaScript Object Notation
          (JSON) format for use in the interactive webpage.

   --help-profile-perl
          Prints out all the loaded profiles as a Perl object for use in
          the router CGI.

   --dir=<dirname>
          Sets the directory name in which to read the local database.
          Defaults to the current directory.

   --prefix=<name>
          Sets the filename prefix for the files in the local database.
          Defaults to no prefix.

   --profiles=<filename>
          Sets the filename containing the list of profiles in XML format.
          If the file doesn't exist then dirname, prefix and
          "profiles.xml" will be combined and used, if that doesn't exist
          then the command line must contain all relevant profile
          information.

   --translations=<filename>
          Sets the filename containing the list of translations in XML
          format for the output files. If the file doesn't exist then
          dirname, prefix and "translations.xml" will be combined and
          used, if that doesn't exist then no file will be read and no
          language can be selected.

   --exact-nodes-only
          When processing the specified latitude and longitude points only
          select the nearest node instead of finding the nearest point
          within a segment (quicker but less accurate unless the points
          are already near nodes).

   --quiet
          Don't generate any screen output while running (useful for
          running in a script).

   --language=<lang>
          Select the language specified from the file of translations. If
          this option is not given and the file exists then the first
          language in the file will be used. If this option is not given
          and no file exists the compiled-in default language (English)
          will be used.

   --output-html
   --output-gpx-track
   --output-gpx-route
   --output-text
   --output-text-all
          Generate the selected output file formats (HTML, GPX track file,
          GPX route file, plain text route and/or plain text with all
          nodes). If no output is specified then all are generated,
          specifying any automatically disables those not specified.

   --output-none
          Do not generate any output or read in any translations files.

   --profile=<name>
          Specifies the name of the profile to use.

   --transport=<transport>
          Select the type of transport to use, <transport> can be set to:

          + foot = Foot
          + horse = Horse
          + wheelchair = Wheelchair
          + bicycle = Bicycle
          + moped = Moped (Small motorbike, limited speed)
          + motorbike = Motorbike
          + motorcar = Motorcar
          + goods = Goods (Small lorry, van)
          + hgv = HGV (Heavy Goods Vehicle - large lorry)
          + psv = PSV (Public Service Vehicle - bus, coach)

          Defaults to 'motorcar', this option also selects the default
          profile information if the '--profile' option is not given and a
          profile matching the transport name is found.

   --shortest
          Find the shortest route between the waypoints.

   --quickest
          Find the quickest route between the waypoints.

   --lon1=<longitude>, --lat1=<latitude>
   --lon2=<longitude>, --lat2=<latitude>
   ... --lon99=<longitude>, --lat99=<latitude>
          The location of the waypoints that make up the start, middle and
          end points of the route. Up to 99 waypoints can be specified and
          the route will pass through each of the specified ones in
          sequence. The algorithm will use the closest node or point
          within a segment that allows the specified traffic type.

   --highway-<highway>=<preference>
          Selects the percentage preference for using each particular type
          of highway. The value of <highway> can be selected from:

          + motorway = Motorway
          + trunk = Trunk
          + primary = Primary
          + secondary = Secondary
          + tertiary = Tertiary
          + unclassified = Unclassified
          + residential = Residential
          + service = Service
          + track = Track
          + cycleway = Cycleway
          + path = Path
          + steps = Steps

          Default value depends on the profile selected by the --transport
          option.

   --speed-<highway>=<speed>
          Selects the speed limit in km/hour for each type of highway.
          Default value depends on the profile selected by the --transport
          option.

   --property-<property>=<preference>
          Selects the percentage preference for using each particular
          highway property The value of <property> can be selected from:

          + paved = Paved (suitable for normal wheels)
          + multilane = Multiple lanes
          + bridge = Bridge
          + tunnel = Tunnel

          Default value depends on the profile selected by the --transport
          option.

   --oneway=[0|1]
          Selects if the direction of oneway streets are to be obeyed
          (useful to not obey them when walking). Default value depends on
          the profile selected by the --transport option.

   --weight=<weight>
          Specifies the weight of the mode of transport in tonnes; ensures
          that the weight limit on the highway is not exceeded. Default
          value depends on the profile selected by the --transport option.

   --height=<height>
          Specifies the height of the mode of transport in metres; ensures
          that the height limit on the highway is not exceeded. Default
          value depends on the profile selected by the --transport option.

   --width=<width>
          Specifies the width of the mode of transport in metres; ensures
          that the width limit on the highway is not exceeded. Default
          value depends on the profile selected by the --transport option.

   --length=<length>
          Specifies the length of the mode of transport in metres; ensures
          that the length limit on the highway is not exceeded. Default
          value depends on the profile selected by the --transport option.

   The meaning of the <preference> parameter in the command line options
   is slightly different for the highway preferences and the property
   preferences. For the highway preference consider the choice between two
   possible highways between the start and finish when looking for the
   shortest route. If highway A has a preference of 100% and highway B has
   a preference of 90% then highway A will be chosen even if it is up to
   11% longer (100/90 = 111%). For the highway properties each highway
   either has a particular property or not. If the preference for highways
   with the property is 60% then the preference for highways without the
   property is 40%. The overall preference for the highway is the product
   of the highway preference and the preference for highways with (or
   without) each property that the highway has (or doesn't have).

   Example usage (motorbike journey, scenic route, not very fast):

   ./router --dir=data --prefix=gb --transport=motorbike --highway-motorway=0 \
            --highway-trunk=0 --speed-primary=80 --speed-secondary=80 --quickest

   This will use the files 'data/gb-nodes.mem', 'data/gb-segments.mem' and
   'data/gb-ways.mem' to find the quickest route by motorbike not using
   motorways or trunk roads and not exceeding 80 km/hr.


filedumper
----------

   This program is used to extract statistics from the database, extract
   particular information for visualisation purposes or for dumping the
   database contents.

  Usage: filedumper [--help]
                    [--dir=<dirname>] [--prefix=<name>]
                    [--statistics]
                    [--visualiser --latmin=<latmin> --latmax=<latmax>
                                  --lonmin=<lonmin> --lonmax=<lonmax>
                                  --data=<data-type>]
                    [--dump [--node=<node> ...]
                            [--segment=<segment> ...]
                            [--way=<way> ...]]
                    [--dump-osm [--no-super]
                                [--latmin=<latmin> --latmax=<latmax>
                                 --lonmin=<lonmin> --lonmax=<lonmax>]]

   --help
          Prints out the help information.

   --dir=<dirname>
          Sets the directory name in which to read the local database.
          Defaults to the current directory.

   --prefix=<name>
          Sets the filename prefix for the files in the local database.

   --statistics
          Prints out statistics about the database files.

   --visualiser
          Selects a data visualiser mode which will output a set of data
          according to the other parameters below.

        --latmin=<latmin> --latmax=<latmax>
                The range of latitudes to print the data for.

        --lonmin=<lonmin> --lonmax=<lonmax>
                The range of longitudes to print the data for.

        --data=<data-type>
                The type of data to output, <data-type> can be selected
                from:

               o junctions = segment count at each junction.
               o super = super-node and super-segments.
               o oneway = oneway segments.
               o speed = speed limits.
               o weight = weight limits.
               o height = height limits.
               o width = width limits.
               o length = length limits.

   --dump
          Selects a data dumping mode which allows looking at individual
          items in the databases (specifying 'all' instead of a number
          dumps all of them).

        --node=<node>
                Prints the information about the selected node number
                (internal number, not the node id number in the original
                source file).

        --segment=<segment>
                Prints the information about the selected segment number.

        --way=<way>
                Prints the information about the selected way number
                (internal number, not the way id number in the original
                source file).

   --osm-dump
          Dumps the contents of the database as an OSM format XML file,
          the whole database will be dumped unless the latitude and
          longitude ranges are specified.

        --no-super
                The super segments will not be output.

        --latmin=<latmin> --latmax=<latmax>
                The range of latitudes to dump the data for.

        --lonmin=<lonmin> --lonmax=<lonmax>
                The range of longitudes to dump the data for.

tagmodifier
-----------

   This program is used to run the tag transformation process on an OSM
   XML file for test purposes.

   Usage: tagmodifier [--help]
                      [--tagging=<filename>]
                      [<filename.osm>]

   --help
          Prints out the help information.

   --tagging=<filename>
          The name of the XML file containing the tagging rules (defaults
          to 'tagging.xml' in the current directory).

   <filename.osm> ...
          Specifies the filename to read data from, by default data is
          read from the standard input.


--------

Copyright 2008-2010 Andrew M. Bishop.
1	amb	381	Routino : Usage
2			===============
3	amb	152
4
5	amb	420	There are four programs that make up this software. The first one takes
6			the planet.osm datafile from OpenStreetMap (or other source of data
7			using the same formats) and converts it into a local database. The
8	amb	191	second program uses the database to determine an optimum route between
9			two points. The third program allows visualisation of the data and
10	amb	420	statistics to be extracted. The fourth program is a test program for
11			the tag transformations.
12	amb	152
13	amb	429
14	amb	152	planetsplitter
15	amb	318	--------------
16	amb	152
17	amb	420	This program reads in the OSM format XML file and splits it up to
18			create the database that is used for routing.
19
20	amb	381	Usage: planetsplitter [--help]
21			[--dir=<dirname>] [--prefix=<name>]
22			[--slim] [--sort-ram-size=<size>]
23			[--tmpdir=<dirname>]
24			[--parse-only \| --process-only]
25			[--max-iterations=<number>]
26	amb	420	[--tagging=<filename>]
27	amb	381	[<filename.osm> ...]
28	amb	152
29			--help
30			Prints out the help information.
31
32	amb	381	--dir=<dirname>
33	amb	152	Sets the directory name in which to save the results. Defaults
34			to the current directory.
35
36			--prefix=<name>
37			Sets the filename prefix for the files that are created.
38			Defaults to no prefix.
39
40	amb	288	--slim
41			Selects a mode of operation that uses less memory and will
42			therefore work where virtual memory is very limited or
43			unavailable. Selecting this option will cause raw data to be
44			held in disk files with only indexes in RAM. Not using this
45			option will still use disk files but only for sequential access
46			and the files are memory mapped for random access.
47
48	amb	381	--sort-ram-size=<size>
49			Specifies the amount of RAM (in MB) to use for sorting the data.
50			If not specified then 64 MB will be used if the '--slim' option
51			is specified or 256 MB otherwise.
52
53			--tmpdir=<dirname>
54	amb	288	Specifies the name of the directory to store the temporary disk
55			files. If not specified then it defaults to either the value of
56			the --dir option or the current directory.
57
58	amb	381	--parse-only
59			Parse the input files and store them in a temporary file but
60			don't process the data into a routing database.
61
62			--process-only
63			Don't read in any files but process the existing temporary file
64			into the routing database.
65
66	amb	318	--max-iterations=<number>
67			The maximum number of iterations to use when generating
68			super-nodes and super-segments. Defaults to 10 which is normally
69			enough.
70
71	amb	420	--tagging=<filename>
72			The name of the XML file containing the tagging rules (defaults
73			to 'tagging.xml' with '--dirname' and '--prefix' options).
74	amb	318
75	amb	381	<filename.osm> ...
76			Specifies the filename(s) to read data from, by default data is
77			read from the standard input.
78
79	amb	420	Note: In version 1.4 of Routino the --transport, --not-highway and
80	amb	429	--not-property options have been removed. The same functionality can be
81			achieved by editing the tagging rules file to not output unwwanted
82			data.
83	amb	420
84	amb	152	Example usage:
85	amb	381
86	amb	420	./planetsplitter --dir=data --prefix=gb great_britain.osm
87	amb	180
88	amb	152	This will generate the output files 'data/gb-nodes.mem',
89			'data/gb-segments.mem' and 'data/gb-ways.mem'.
90
91	amb	318
92	amb	152	router
93	amb	318	------
94	amb	152
95	amb	420	This program performs the calculation of the optimum routes using the
96			database generated by the planetsplitter program.
97
98	amb	381	Usage: router [--help \| --help-profile \| --help-profile-xml \|
99			--help-profile-json \| --help-profile-perl ]
100			[--dir=<dirname>] [--prefix=<name>]
101			[--profiles=<filename>] [--translations=<filename>]
102			[--exact-nodes-only]
103			[--quiet]
104			[--output-html]
105			[--output-gpx-track] [--output-gpx-route]
106			[--output-text] [--output-text-all]
107			[--output-none]
108			[--profile=<name>]
109			[--transport=<transport>]
110			[--shortest \| --quickest]
111			--lon1=<longitude> --lat1=<latitude>
112			--lon2=<longitude> --lon2=<latitude>
113			[ ... --lon99=<longitude> --lon99=<latitude>]
114			[--highway-<highway>=<preference> ...]
115			[--speed-<highway>=<speed> ...]
116			[--property-<property>=<preference> ...]
117			[--oneway=(0\|1)]
118			[--weight=<weight>]
119			[--height=<height>] [--width=<width>] [--length=<length>]
120	amb	152
121			--help
122			Prints out the help information.
123
124			--help-profile
125			Prints out the selected transport profile (type, speed limits,
126			highway preferences etc.)
127
128	amb	381	--help-profile-xml
129			Prints out all the loaded profiles as an XML file in the same
130			format that can be loaded in.
131	amb	152
132	amb	381	--help-profile-json
133			Prints out all the loaded profiles in JavaScript Object Notation
134			(JSON) format for use in the interactive webpage.
135	amb	152
136	amb	381	--help-profile-perl
137			Prints out all the loaded profiles as a Perl object for use in
138			the router CGI.
139
140			--dir=<dirname>
141	amb	191	Sets the directory name in which to read the local database.
142			Defaults to the current directory.
143	amb	152
144			--prefix=<name>
145	amb	191	Sets the filename prefix for the files in the local database.
146	amb	152	Defaults to no prefix.
147
148	amb	381	--profiles=<filename>
149			Sets the filename containing the list of profiles in XML format.
150			If the file doesn't exist then dirname, prefix and
151			"profiles.xml" will be combined and used, if that doesn't exist
152			then the command line must contain all relevant profile
153			information.
154	amb	152
155	amb	381	--translations=<filename>
156			Sets the filename containing the list of translations in XML
157			format for the output files. If the file doesn't exist then
158			dirname, prefix and "translations.xml" will be combined and
159			used, if that doesn't exist then no file will be read and no
160			language can be selected.
161	amb	152
162	amb	318	--exact-nodes-only
163			When processing the specified latitude and longitude points only
164			select the nearest node instead of finding the nearest point
165	amb	381	within a segment (quicker but less accurate unless the points
166			are already near nodes).
167	amb	318
168	amb	152	--quiet
169			Don't generate any screen output while running (useful for
170			running in a script).
171
172	amb	381	--language=<lang>
173			Select the language specified from the file of translations. If
174			this option is not given and the file exists then the first
175			language in the file will be used. If this option is not given
176			and no file exists the compiled-in default language (English)
177			will be used.
178
179			--output-html
180			--output-gpx-track
181			--output-gpx-route
182			--output-text
183			--output-text-all
184			Generate the selected output file formats (HTML, GPX track file,
185			GPX route file, plain text route and/or plain text with all
186			nodes). If no output is specified then all are generated,
187			specifying any automatically disables those not specified.
188
189			--output-none
190			Do not generate any output or read in any translations files.
191
192			--profile=<name>
193			Specifies the name of the profile to use.
194
195	amb	152	--transport=<transport>
196	amb	191	Select the type of transport to use, <transport> can be set to:
197	amb	318
198			+ foot = Foot
199			+ horse = Horse
200			+ wheelchair = Wheelchair
201			+ bicycle = Bicycle
202			+ moped = Moped (Small motorbike, limited speed)
203			+ motorbike = Motorbike
204			+ motorcar = Motorcar
205			+ goods = Goods (Small lorry, van)
206			+ hgv = HGV (Heavy Goods Vehicle - large lorry)
207			+ psv = PSV (Public Service Vehicle - bus, coach)
208
209			Defaults to 'motorcar', this option also selects the default
210	amb	381	profile information if the '--profile' option is not given and a
211			profile matching the transport name is found.
212	amb	152
213	amb	381	--shortest
214			Find the shortest route between the waypoints.
215
216			--quickest
217			Find the quickest route between the waypoints.
218
219			--lon1=<longitude>, --lat1=<latitude>
220			--lon2=<longitude>, --lat2=<latitude>
221			... --lon99=<longitude>, --lat99=<latitude>
222			The location of the waypoints that make up the start, middle and
223			end points of the route. Up to 99 waypoints can be specified and
224			the route will pass through each of the specified ones in
225			sequence. The algorithm will use the closest node or point
226			within a segment that allows the specified traffic type.
227
228	amb	180	--highway-<highway>=<preference>
229			Selects the percentage preference for using each particular type
230	amb	318	of highway. The value of <highway> can be selected from:
231	amb	152
232	amb	318	+ motorway = Motorway
233			+ trunk = Trunk
234			+ primary = Primary
235			+ secondary = Secondary
236			+ tertiary = Tertiary
237			+ unclassified = Unclassified
238			+ residential = Residential
239			+ service = Service
240			+ track = Track
241			+ cycleway = Cycleway
242			+ path = Path
243			+ steps = Steps
244
245			Default value depends on the profile selected by the --transport
246			option.
247
248	amb	152	--speed-<highway>=<speed>
249	amb	191	Selects the speed limit in km/hour for each type of highway.
250			Default value depends on the profile selected by the --transport
251			option.
252	amb	152
253	amb	318	--property-<property>=<preference>
254			Selects the percentage preference for using each particular
255			highway property The value of <property> can be selected from:
256
257			+ paved = Paved (suitable for normal wheels)
258			+ multilane = Multiple lanes
259			+ bridge = Bridge
260			+ tunnel = Tunnel
261
262			Default value depends on the profile selected by the --transport
263			option.
264
265	amb	152	--oneway=[0\|1]
266			Selects if the direction of oneway streets are to be obeyed
267			(useful to not obey them when walking). Default value depends on
268			the profile selected by the --transport option.
269
270			--weight=<weight>
271	amb	318	Specifies the weight of the mode of transport in tonnes; ensures
272	amb	191	that the weight limit on the highway is not exceeded. Default
273			value depends on the profile selected by the --transport option.
274	amb	152
275			--height=<height>
276	amb	318	Specifies the height of the mode of transport in metres; ensures
277	amb	191	that the height limit on the highway is not exceeded. Default
278			value depends on the profile selected by the --transport option.
279	amb	152
280			--width=<width>
281	amb	318	Specifies the width of the mode of transport in metres; ensures
282	amb	191	that the width limit on the highway is not exceeded. Default
283			value depends on the profile selected by the --transport option.
284	amb	152
285			--length=<length>
286	amb	318	Specifies the length of the mode of transport in metres; ensures
287	amb	191	that the length limit on the highway is not exceeded. Default
288			value depends on the profile selected by the --transport option.
289	amb	152
290	amb	318	The meaning of the <preference> parameter in the command line options
291			is slightly different for the highway preferences and the property
292			preferences. For the highway preference consider the choice between two
293			possible highways between the start and finish when looking for the
294			shortest route. If highway A has a preference of 100% and highway B has
295			a preference of 90% then highway A will be chosen even if it is up to
296			11% longer (100/90 = 111%). For the highway properties each highway
297			either has a particular property or not. If the preference for highways
298			with the property is 60% then the preference for highways without the
299			property is 40%. The overall preference for the highway is the product
300			of the highway preference and the preference for highways with (or
301			without) each property that the highway has (or doesn't have).
302
303	amb	152	Example usage (motorbike journey, scenic route, not very fast):
304	amb	180
305	amb	152	./router --dir=data --prefix=gb --transport=motorbike --highway-motorway=0 \
306			--highway-trunk=0 --speed-primary=80 --speed-secondary=80 --quickest
307
308			This will use the files 'data/gb-nodes.mem', 'data/gb-segments.mem' and
309			'data/gb-ways.mem' to find the quickest route by motorbike not using
310			motorways or trunk roads and not exceeding 80 km/hr.
311
312	amb	180
313	amb	191	filedumper
314	amb	318	----------
315	amb	152
316	amb	420	This program is used to extract statistics from the database, extract
317			particular information for visualisation purposes or for dumping the
318			database contents.
319
320	amb	381	Usage: filedumper [--help]
321			[--dir=<dirname>] [--prefix=<name>]
322			[--statistics]
323			[--visualiser --latmin=<latmin> --latmax=<latmax>
324			--lonmin=<lonmin> --lonmax=<lonmax>
325			--data=<data-type>]
326			[--dump [--node=<node> ...]
327			[--segment=<segment> ...]
328			[--way=<way> ...]]
329	amb	420	[--dump-osm [--no-super]
330			[--latmin=<latmin> --latmax=<latmax>
331			--lonmin=<lonmin> --lonmax=<lonmax>]]
332	amb	152
333	amb	191	--help
334			Prints out the help information.
335	amb	152
336	amb	381	--dir=<dirname>
337	amb	191	Sets the directory name in which to read the local database.
338			Defaults to the current directory.
339	amb	152
340	amb	191	--prefix=<name>
341			Sets the filename prefix for the files in the local database.
342	amb	180
343	amb	191	--statistics
344			Prints out statistics about the database files.
345	amb	152
346	amb	191	--visualiser
347			Selects a data visualiser mode which will output a set of data
348			according to the other parameters below.
349	amb	152
350	amb	191	--latmin=<latmin> --latmax=<latmax>
351			The range of latitudes to print the data for.
352	amb	152
353	amb	191	--lonmin=<lonmin> --lonmax=<lonmax>
354			The range of longitudes to print the data for.
355	amb	155
356	amb	191	--data=<data-type>
357			The type of data to output, <data-type> can be selected
358			from:
359	amb	381
360	amb	191	o junctions = segment count at each junction.
361			o super = super-node and super-segments.
362			o oneway = oneway segments.
363			o speed = speed limits.
364			o weight = weight limits.
365			o height = height limits.
366			o width = width limits.
367			o length = length limits.
368	amb	155
369	amb	288	--dump
370			Selects a data dumping mode which allows looking at individual
371	amb	381	items in the databases (specifying 'all' instead of a number
372			dumps all of them).
373	amb	191
374	amb	288	--node=<node>
375			Prints the information about the selected node number
376	amb	318	(internal number, not the node id number in the original
377	amb	288	source file).
378
379			--segment=<segment>
380			Prints the information about the selected segment number.
381
382			--way=<way>
383	amb	318	Prints the information about the selected way number
384			(internal number, not the way id number in the original
385			source file).
386	amb	288
387	amb	420	--osm-dump
388			Dumps the contents of the database as an OSM format XML file,
389			the whole database will be dumped unless the latitude and
390			longitude ranges are specified.
391	amb	288
392	amb	420	--no-super
393			The super segments will not be output.
394
395			--latmin=<latmin> --latmax=<latmax>
396			The range of latitudes to dump the data for.
397
398			--lonmin=<lonmin> --lonmax=<lonmax>
399			The range of longitudes to dump the data for.
400
401			tagmodifier
402			-----------
403
404			This program is used to run the tag transformation process on an OSM
405			XML file for test purposes.
406
407			Usage: tagmodifier [--help]
408			[--tagging=<filename>]
409			[<filename.osm>]
410
411			--help
412			Prints out the help information.
413
414			--tagging=<filename>
415			The name of the XML file containing the tagging rules (defaults
416			to 'tagging.xml' in the current directory).
417
418			<filename.osm> ...
419			Specifies the filename to read data from, by default data is
420			read from the standard input.
421
422	amb	429
423	amb	152	--------
424
425	amb	381	Copyright 2008-2010 Andrew M. Bishop.