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>]
                        [--sort-ram-size=<size>]
                        [--tmpdir=<dirname>]
                        [--parse-only | --process-only]
                        [--loggable]
                        [--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.

   --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 in slim mode 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.

   --loggable
          Print progress messages that are suitable for logging to a file;
          normally an incrementing counter is printed which is more
          suitable for realtime display than logging.

   --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>
          Sets the filename containing the list of tagging rules in XML
          format for the parsing the input files. If the file doesn't
          exist then dirname, prefix and "profiles.xml" will be combined
          and used, if that doesn't exist then the file
          '/usr/local/share/routino/profiles.xml' (or custom installation
          location) will be used.

   <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.

   Note: In version 1.5 of Routino the --slim option has been removed but
   at compilation time a separate program called planetsplitter-slim is
   created that operates in slim mode. In slim mode the temporary files
   and database files are read as needed rather than being mapped into
   memory. This allows a database size greater than 2 GB on 32-bit
   machines or usage with little or no virtual memory (e.g. some virtual
   machines). The penalty for this is that the program takes about four
   times as long to run.

   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]
                [--loggable | --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)] [--turns=(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 routing 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 file '/usr/local/share/routino/profiles.xml' (or custom
          installation location) will be used.

   --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 the file
          '/usr/local/share/routino/translations.xml' (or custom
          installation location) will be used.

   --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).

   --loggable
          Print progress messages that are suitable for logging to a file;
          normally an incrementing counter is printed which is more
          suitable for realtime display than logging.

   --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
          + ferry = Ferry

          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
          + footroute = A route marked for foot travel
          + bicycleroute = A route marked for bicycle travel

          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.

   --turns=[0|1]
          Selects if turn restrictions 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.

   Note: In version 1.5 of Routino a slim option has been added and at
   compilation time a separate program called router-slim is created that
   operates in slim mode. In slim mode the database files are read as
   needed rather than being mapped into memory.

   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 the
   property is 60% then a highway with the property has a preference of
   77% (sqrt(60%)) and one without has a preference of 63%
   (sqrt(100-60%)). A highway with the property will be chosen even if it
   is up to 22% longer than one without the property (77/63 = 122%). The
   overall preference for each highway segment is the product of the
   preference for the highway type and all of the preferences for the
   highway properties.

   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> ...]
                            [--turn-relation=<relation> ...]]
                    [--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). More than one of the following parameters
          can be specified on the command line.

        --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).

        --turn-relation=<relation>
                Prints the information about the selected turn relation
                number (internal number, not the relation 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.

   Note: In version 1.5 of Routino a slim option has been added and at
   compilation time a separate program called filedumper-slim is created
   that operates in slim mode. In slim mode the database files are read as
   needed rather than being mapped into memory.


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

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

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

   --help
          Prints out the help information.

   --loggable
          Print progress messages that are suitable for logging to a file;
          normally an incrementing counter is printed which is more
          suitable for realtime display than logging.

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