Check out the latest version of Routino: svn co http://routino.org/svn/trunk routino
Contents of /trunk/doc/html/usage.html
Parent Directory
|
Revision Log
Revision 1504 -
(show annotations)
(download)
(as text)
Thu Jan 30 19:45:45 2014 UTC (11 years, 1 month ago) by amb
File MIME type: text/html
File size: 26995 byte(s)
Thu Jan 30 19:45:45 2014 UTC (11 years, 1 month ago) by amb
File MIME type: text/html
File size: 26995 byte(s)
Add an option to calculate a circular route.
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
2 | <html> |
3 | |
4 | <head> |
5 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
6 | |
7 | <title>Routino : Usage</title> |
8 | |
9 | <!-- |
10 | Routino documentation - usage |
11 | |
12 | Part of the Routino routing software. |
13 | |
14 | This file Copyright 2008-2014 Andrew M. Bishop |
15 | |
16 | This program is free software: you can redistribute it and/or modify |
17 | it under the terms of the GNU Affero General Public License as published by |
18 | the Free Software Foundation, either version 3 of the License, or |
19 | (at your option) any later version. |
20 | |
21 | This program is distributed in the hope that it will be useful, |
22 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
23 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
24 | GNU Affero General Public License for more details. |
25 | |
26 | You should have received a copy of the GNU Affero General Public License |
27 | along with this program. If not, see http://www.gnu.org/licenses/. |
28 | --> |
29 | |
30 | <link href="style.css" type="text/css" rel="stylesheet"> |
31 | </head> |
32 | |
33 | <body> |
34 | |
35 | <!-- Header Start --> |
36 | |
37 | <div class="header"> |
38 | |
39 | <h1>Routino : Usage</h1> |
40 | |
41 | <hr> |
42 | </div> |
43 | |
44 | <!-- Header End --> |
45 | |
46 | <!-- Content Start --> |
47 | |
48 | <div class="content"> |
49 | |
50 | <h2 id="H_1_1">Program Usage</h2> |
51 | |
52 | There are five programs that make up this software. The first one takes the |
53 | planet.osm datafile from OpenStreetMap (or other source of data using the same |
54 | formats) and converts it into a local database. The second program uses the |
55 | database to determine an optimum route between two points. The third program |
56 | allows visualisation of the data and statistics to be extracted. The fourth |
57 | program allows dumping the raw parsed data for test purposes and the fifth is a |
58 | test program for the tag transformations. |
59 | |
60 | <h3 id="H_1_1_1">planetsplitter</h3> |
61 | |
62 | This program reads in the OSM format XML file and splits it up to create the |
63 | database that is used for routing. |
64 | |
65 | <pre class="boxed"> |
66 | Usage: planetsplitter [--help] |
67 | [--dir=<dirname>] [--prefix=<name>] |
68 | [--sort-ram-size=<size>] [--sort-threads=<number>] |
69 | [--tmpdir=<dirname>] |
70 | [--tagging=<filename>] |
71 | [--loggable] [--logtime] |
72 | [--errorlog[=<name>]] |
73 | [--parse-only | --process-only] |
74 | [--append] [--keep] [--changes] |
75 | [--max-iterations=<number>] |
76 | [--prune-none] |
77 | [--prune-isolated=<len>] |
78 | [--prune-short=<len>] |
79 | [--prune-straight=<len>] |
80 | [<filename.osm> ... | <filename.osc> ... |
81 | | <filename.pbf> ... |
82 | | <filename.o5m> ... | <filename.o5c> ... |
83 | | <filename.(osm|osc|o5m|o5c).bz2> ... |
84 | | <filename.(osm|osc|o5m|o5c).gz> ...] |
85 | </pre> |
86 | |
87 | <dl> |
88 | <dt>--help |
89 | <dd>Prints out the help information. |
90 | <dt>--dir=<dirname> |
91 | <dd>Sets the directory name in which to save the results. |
92 | Defaults to the current directory. |
93 | <dt>--prefix=<name> |
94 | <dd>Sets the filename prefix for the files that are created. |
95 | Defaults to no prefix. |
96 | <dt>--sort-ram-size=<size> |
97 | <dd>Specifies the amount of RAM (in MB) to use for sorting the data. If not |
98 | specified then 64 MB will be used in slim mode or 256 MB otherwise. |
99 | <dt>--sort-threads=<number> |
100 | <dd>The number of threads to use for data sorting (the sorting memory is |
101 | shared between the threads - too many threads and not enough memory will |
102 | reduce the performance). |
103 | <dt>--tmpdir=<dirname> |
104 | <dd>Specifies the name of the directory to store the temporary disk files. If |
105 | not specified then it defaults to either the value of the --dir option or the |
106 | current directory. |
107 | <dt>--tagging=<filename> |
108 | <dd>Sets the filename containing the list of tagging rules in XML format for |
109 | the parsing the input files. If the file doesn't exist then dirname, prefix |
110 | and "profiles.xml" will be combined and used, if that doesn't exist then the |
111 | file '/usr/local/share/routino/profiles.xml' (or custom installation |
112 | location) will be used. |
113 | <dt>--loggable |
114 | <dd>Print progress messages that are suitable for logging to a file; normally |
115 | an incrementing counter is printed which is more suitable for real-time |
116 | display than logging. |
117 | <dt>--logtime |
118 | <dd>Print the elapsed time for each processing step. |
119 | <dt>--errorlog[=<name>] |
120 | <dd>Log OSM parsing and processing errors to 'error.log' or the specified file |
121 | name (the '--dir' and '--prefix' options are applied). If the --append |
122 | option is used then the existing log file will be appended, otherwise a new |
123 | one will be created. If the --keep option is also used a geographically |
124 | searchable database of error logs is created for use in the visualiser. |
125 | <dt>--parse-only |
126 | <dd>Parse the input files and store the data in intermediate files but don't |
127 | process the data into a routing database. This option must be used with the |
128 | --append option for all except the first file. |
129 | <dt>--process-only |
130 | <dd>Don't read in any files but process the existing intermediate files |
131 | created by using the --parse-only option. |
132 | <dt>--append |
133 | <dd>Parse the input file and append the result to the existing intermediate |
134 | files; the appended file can be either an OSM file or an OSC change file. |
135 | <dt>--keep |
136 | <dd>Store a set of intermediate files after parsing the OSM files, sorting and |
137 | removing duplicates; this allows appending an OSC file and re-processing |
138 | later. |
139 | <dt>--changes |
140 | <dd>This option indicates that the data being processed contains one or more |
141 | OSC (OSM changes) files, they must be applied in time sequence if more than |
142 | one is used. This option implies --append when parsing data files and |
143 | --keep when processing data. |
144 | <dt>--max-iterations=<number> |
145 | <dd>The maximum number of iterations to use when generating super-nodes and |
146 | super-segments. Defaults to 5 which is normally enough. |
147 | <dt>--prune-none |
148 | <dd>Disable the prune options below, they can be re-enabled by adding them to |
149 | the command line after this option. |
150 | <dt>--prune-isolated=<length> |
151 | <dd>Remove the access permissions for a transport type from small disconnected |
152 | groups of segments and remove the segments if they end up with no access |
153 | permission (defaults to removing groups under 500m). |
154 | <dt>--prune-short=<length> |
155 | <dd>Remove short segments (defaults to removing segments up to a maximum |
156 | length of 5m). |
157 | <dt>--prune-straight=<length> |
158 | <dd>Remove nodes in almost straight highways (defaults to removing nodes up to |
159 | 3m offset from a straight line). |
160 | <dt><filename.osm>, <filename.osc>, <filename.pbf>, <filename.o5m>, <filename.o5c> |
161 | <dd>Specifies the filename(s) to read data from. Filenames ending '.pbf' will |
162 | be read as PBF, filenames ending in '.o5m' or '.o5c' will be read as |
163 | O5M/O5C, otherwise as XML. Filenames ending '.bz2' will be bzip2 |
164 | uncompressed (if bzip2 support compiled in). Filenames ending '.gz' will be |
165 | gzip uncompressed (if gzip support compiled in). |
166 | </dl> |
167 | |
168 | <p> |
169 | <i>Note: In version 2.5 of Routino the ability to read data from the standard |
170 | input has been removed. This is because there is now the ability to read |
171 | compressed files (bzip2 and gzip) and PBF files directly. Also using standard |
172 | input the file type cannot be auto-detected from the filename.</i> |
173 | |
174 | <p> |
175 | Example usage 1: |
176 | |
177 | <pre class="boxed"> |
178 | planetsplitter --dir=data --prefix=gb great_britain.osm |
179 | </pre> |
180 | |
181 | This will generate the output files 'data/gb-nodes.mem', 'data/gb-segments.mem' |
182 | and 'data/gb-ways.mem'. Multiple filenames can be specified on the command |
183 | line and they will all be read in, combined and processed together. |
184 | |
185 | <p> |
186 | Example usage 2: |
187 | |
188 | <pre class="boxed"> |
189 | planetsplitter --dir=data --prefix=gb --parse-only great_britain_part1.osm |
190 | planetsplitter --dir=data --prefix=gb --parse-only --append great_britain_part2.osm |
191 | planetsplitter --dir=data --prefix=gb --parse-only --append ... |
192 | planetsplitter --dir=data --prefix=gb --process-only |
193 | </pre> |
194 | |
195 | This will generate the same output files as the first example but parsing the |
196 | input files is performed separately from the data processing. The first file |
197 | read in must not use the --append option but the later ones must. |
198 | |
199 | <p> |
200 | Example usage 3: |
201 | |
202 | <pre class="boxed"> |
203 | planetsplitter --dir=data --prefix=gb --keep great_britain.osm |
204 | |
205 | planetsplitter --dir=data --prefix=gb --changes great_britain.osc |
206 | </pre> |
207 | |
208 | This will generate the same output files as the first example. The first |
209 | command will process the complete file and keep some intermediate data for |
210 | later. The second command will apply a set of changes to the stored |
211 | intermediate data and keep the updated intermediate files for repeating this |
212 | step later with more change data. |
213 | <p> |
214 | The parsing and processing can be split into multiple commands as it was in |
215 | example 2 with the --keep option used with --process-only for the initial OSM |
216 | file(s) and the --changes option used with --parse-only or --process-only for |
217 | every OSC file. |
218 | |
219 | |
220 | <h3 id="H_1_1_2">router</h3> |
221 | |
222 | This program performs the calculation of the optimum routes using the database |
223 | generated by the planetsplitter program. |
224 | |
225 | <pre class="boxed"> |
226 | Usage: router [--help | --help-profile | --help-profile-xml | |
227 | --help-profile-json | --help-profile-perl ] |
228 | [--dir=<dirname>] [--prefix=<name>] |
229 | [--profiles=<filename>] [--translations=<filename>] |
230 | [--exact-nodes-only] |
231 | [--loggable | --quiet] |
232 | [--output-html] |
233 | [--output-gpx-track] [--output-gpx-route] |
234 | [--output-text] [--output-text-all] |
235 | [--output-none] [--output-stdout] |
236 | [--profile=<name>] |
237 | [--transport=<transport>] |
238 | [--shortest | --quickest] |
239 | --lon1=<longitude> --lat1=<latitude> |
240 | --lon2=<longitude> --lon2=<latitude> |
241 | [ ... --lon99=<longitude> --lon99=<latitude>] |
242 | [--reverse] [--loop] |
243 | [--heading=<bearing>] |
244 | [--highway-<highway>=<preference> ...] |
245 | [--speed-<highway>=<speed> ...] |
246 | [--property-<property>=<preference> ...] |
247 | [--oneway=(0|1)] [--turns=(0|1)] |
248 | [--weight=<weight>] |
249 | [--height=<height>] [--width=<width>] [--length=<length>] |
250 | </pre> |
251 | |
252 | <dl> |
253 | <dt>--help |
254 | <dd>Prints out the help information. |
255 | <dt>--help-profile |
256 | <dd>Prints out the selected transport profile (type, speed limits, highway |
257 | preferences etc.) |
258 | <dt>--help-profile-xml |
259 | <dd>Prints out all the loaded profiles as an XML file in the same format that |
260 | can be loaded in. |
261 | <dt>--help-profile-json |
262 | <dd>Prints out all the loaded profiles in JavaScript Object Notation (JSON) |
263 | format for use in the interactive webpage. |
264 | <dt>--help-profile-perl |
265 | <dd>Prints out all the loaded profiles as a Perl object for use in the router |
266 | CGI. |
267 | <dt>--dir=<dirname> |
268 | <dd>Sets the directory name in which to read the local database. |
269 | Defaults to the current directory. |
270 | <dt>--prefix=<name> |
271 | <dd>Sets the filename prefix for the files in the local database. |
272 | Defaults to no prefix. |
273 | <dt>--profiles=<filename> |
274 | <dd>Sets the filename containing the list of routing profiles in XML format. |
275 | If the file doesn't exist then dirname, prefix and "profiles.xml" will be |
276 | combined and used, if that doesn't exist then the file |
277 | '/usr/local/share/routino/profiles.xml' (or custom installation location) |
278 | will be used. |
279 | <dt>--translations=<filename> |
280 | <dd>Sets the filename containing the list of translations in XML format for |
281 | the output files. If the file doesn't exist then dirname, prefix and |
282 | "translations.xml" will be combined and used, if that doesn't exist then the |
283 | file '/usr/local/share/routino/translations.xml' (or custom installation |
284 | location) will be used. |
285 | <dt>--exact-nodes-only |
286 | <dd>When processing the specified latitude and longitude points only select |
287 | the nearest node instead of finding the nearest point within a segment |
288 | (quicker but less accurate unless the points are already near nodes). |
289 | <dt>--loggable |
290 | <dd>Print progress messages that are suitable for logging to a file; normally |
291 | an incrementing counter is printed which is more suitable for real-time |
292 | display than logging. |
293 | <dt>--quiet |
294 | <dd>Don't generate any screen output while running (useful for running in a script). |
295 | <dt>--language=<lang> |
296 | <dd>Select the language specified from the file of translations. If this |
297 | option is not given and the file exists then the first language in the file |
298 | will be used. If this option is not given and no file exists the |
299 | compiled-in default language (English) will be used. |
300 | <dt>--output-html |
301 | <dt>--output-gpx-track |
302 | <dt>--output-gpx-route |
303 | <dt>--output-text |
304 | <dt>--output-text-all |
305 | <dd>Generate the selected output file formats (HTML, GPX track file, GPX route |
306 | file, plain text route and/or plain text with all nodes). If no output is |
307 | specified then all are generated, specifying any automatically disables those |
308 | not specified. |
309 | <dt>--output-none |
310 | <dd>Do not generate any output or read in any translations files. |
311 | <dt>--output-stdout |
312 | <dd>Write to stdout instead of a file (requires exactly one output format |
313 | option, implies '--quiet'). |
314 | <dt>--profile=<name> |
315 | <dd>Specifies the name of the profile to use. |
316 | <dt>--transport=<transport> |
317 | <dd>Select the type of transport to use, <transport> can be set to: |
318 | <ul> |
319 | <li>foot = Foot |
320 | <li>horse = Horse |
321 | <li>wheelchair = Wheelchair |
322 | <li>bicycle = Bicycle |
323 | <li>moped = Moped (Small motorcycle, limited speed) |
324 | <li>motorcycle = Motorcycle |
325 | <li>motorcar = Motorcar |
326 | <li>goods = Goods (Small lorry, van) |
327 | <li>hgv = HGV (Heavy Goods Vehicle - large lorry) |
328 | <li>psv = PSV (Public Service Vehicle - bus, coach) |
329 | </ul> |
330 | Defaults to 'motorcar', this option also selects the default profile |
331 | information if the '--profile' option is not given and a profile matching |
332 | the transport name is found. |
333 | <dt>--shortest |
334 | <dd>Find the shortest route between the waypoints. |
335 | <dt>--quickest |
336 | <dd>Find the quickest route between the waypoints. |
337 | <dt>--lon1=<longitude>, --lat1=<latitude> |
338 | <dt>--lon2=<longitude>, --lat2=<latitude> |
339 | <dt>... --lon99=<longitude>, --lat99=<latitude> |
340 | <dd>The location of the waypoints that make up the start, middle and end |
341 | points of the route. Up to 99 waypoints can be specified and the route will |
342 | pass through each of the specified ones in sequence. The algorithm will use |
343 | the closest node or point within a segment that allows the specified traffic |
344 | type. |
345 | <dt>--reverse |
346 | <dd>Find a route between the waypoints in reverse order. |
347 | <dt>--loop |
348 | <dd>Find a route that returns to the first waypoint after the last one. |
349 | <dt>--heading=<bearing> |
350 | <dd>Specifies the initial direction of travel at the start of the route (from |
351 | the lowest numbered waypoint) as a compass bearing from 0 to 360 degrees. |
352 | <dt>--highway-<highway>=<preference> |
353 | <dd>Selects the percentage preference for using each particular type of |
354 | highway. The value of <highway> can be selected from: |
355 | <ul> |
356 | <li>motorway = Motorway |
357 | <li>trunk = Trunk |
358 | <li>primary = Primary |
359 | <li>secondary = Secondary |
360 | <li>tertiary = Tertiary |
361 | <li>unclassified = Unclassified |
362 | <li>residential = Residential |
363 | <li>service = Service |
364 | <li>track = Track |
365 | <li>cycleway = Cycleway |
366 | <li>path = Path |
367 | <li>steps = Steps |
368 | <li>ferry = Ferry |
369 | </ul> |
370 | Default value depends on the profile selected by the --transport option. |
371 | <dt>--speed-<highway>=<speed> |
372 | <dd>Selects the speed limit in km/hour for each type of highway. Default |
373 | value depends on the profile selected by the --transport option. |
374 | <dt>--property-<property>=<preference> |
375 | <dd>Selects the percentage preference for using each particular highway |
376 | property |
377 | The value of <property> can be selected from: |
378 | <ul> |
379 | <li>paved = Paved (suitable for normal wheels) |
380 | <li>multilane = Multiple lanes |
381 | <li>bridge = Bridge |
382 | <li>tunnel = Tunnel |
383 | <li>footroute = A route marked for foot travel |
384 | <li>bicycleroute = A route marked for bicycle travel |
385 | </ul> |
386 | Default value depends on the profile selected by the --transport option. |
387 | <dt>--oneway=[0|1] |
388 | <dd>Selects if the direction of oneway streets are to be obeyed (useful to not |
389 | obey them when walking). Default value depends on the profile selected by |
390 | the --transport option. |
391 | <dt>--turns=[0|1] |
392 | <dd>Selects if turn restrictions are to be obeyed (useful to not obey them |
393 | when walking). Default value depends on the profile selected by the |
394 | --transport option. |
395 | <dt>--weight=<weight> |
396 | <dd>Specifies the weight of the mode of transport in tonnes; ensures that the |
397 | weight limit on the highway is not exceeded. Default value depends on the |
398 | profile selected by the --transport option. |
399 | <dt>--height=<height> |
400 | <dd>Specifies the height of the mode of transport in metres; ensures that the |
401 | height limit on the highway is not exceeded. Default value depends on the |
402 | profile selected by the --transport option. |
403 | <dt>--width=<width> |
404 | <dd>Specifies the width of the mode of transport in metres; ensures that the |
405 | width limit on the highway is not exceeded. Default value depends on the |
406 | profile selected by the --transport option. |
407 | <dt>--length=<length> |
408 | <dd>Specifies the length of the mode of transport in metres; ensures that the |
409 | length limit on the highway is not exceeded. Default value depends on the |
410 | profile selected by the --transport option. |
411 | </dl> |
412 | |
413 | <p> |
414 | The meaning of the <preference> parameter in the command line options is |
415 | slightly different for the highway preferences and the property preferences. |
416 | For the highway preference consider the choice between two possible highways |
417 | between the start and finish when looking for the shortest route. If highway A |
418 | has a preference of 100% and highway B has a preference of 90% then highway A |
419 | will be chosen even if it is up to 11% longer (100/90 = 111%). For the highway |
420 | properties each highway either has a particular property or not. If the |
421 | preference for the property is 60% then a highway with the property has a |
422 | preference of 77% (sqrt(60%)) and one without has a preference of 63% |
423 | (sqrt(100-60%)). A highway with the property will be chosen even if it is up to |
424 | 22% longer than one without the property (77/63 = 122%). The overall preference |
425 | for each highway segment is the product of the preference for the highway type |
426 | and all of the preferences for the highway properties. |
427 | |
428 | <p> |
429 | Example usage (motorcycle journey, scenic route, not very fast): |
430 | |
431 | <pre class="boxed"> |
432 | router --dir=data --prefix=gb --transport=motorcycle --highway-motorway=0 \ |
433 | --highway-trunk=0 --speed-primary=80 --speed-secondary=80 --quickest |
434 | </pre> |
435 | |
436 | This will use the files 'data/gb-nodes.mem', 'data/gb-segments.mem' and |
437 | 'data/gb-ways.mem' to find the quickest route by motorcycle not using motorways |
438 | or trunk roads and not exceeding 80 km/hr. |
439 | |
440 | |
441 | <h3 id="H_1_1_3">filedumper</h3> |
442 | |
443 | This program is used to extract statistics from the database, extract particular |
444 | information for visualisation purposes or for dumping the database contents. |
445 | |
446 | <pre class="boxed"> |
447 | Usage: filedumper [--help] |
448 | [--dir=<dirname>] [--prefix=<name>] |
449 | [--statistics] |
450 | [--visualiser --latmin=<latmin> --latmax=<latmax> |
451 | --lonmin=<lonmin> --lonmax=<lonmax> |
452 | --data=<data-type>] |
453 | [--dump [--node=<node> ...] |
454 | [--segment=<segment> ...] |
455 | [--way=<way> ...] |
456 | [--turn-relation=<relation> ...] |
457 | [--errorlog=<number> ...]] |
458 | [--dump-osm [--no-super] |
459 | [--latmin=<latmin> --latmax=<latmax> |
460 | --lonmin=<lonmin> --lonmax=<lonmax>]] |
461 | [--dump-visualiser [--data=node<node>] |
462 | [--data=segment<segment>] |
463 | [--data=turn-relation<rel>] |
464 | [--data=errorlog<number>]] |
465 | </pre> |
466 | |
467 | <dl> |
468 | <dt>--help |
469 | <dd>Prints out the help information. |
470 | <dt>--dir=<dirname> |
471 | <dd>Sets the directory name in which to read the local database. |
472 | Defaults to the current directory. |
473 | <dt>--prefix=<name> |
474 | <dd>Sets the filename prefix for the files in the local database. |
475 | <dt>--statistics |
476 | <dd>Prints out statistics about the database files. |
477 | <dt>--visualiser |
478 | <dd>Selects a data visualiser mode which will output a set of data according |
479 | to the other parameters below. |
480 | <dl> |
481 | <dt>--latmin=<latmin> --latmax=<latmax> |
482 | <dd>The range of latitudes to print the data for. |
483 | <dt>--lonmin=<lonmin> --lonmax=<lonmax> |
484 | <dd>The range of longitudes to print the data for. |
485 | <dt>--data=<data-type> |
486 | <dd>The type of data to output, <data-type> can be selected from: |
487 | <ul> |
488 | <li>junctions = segment count at each junction. |
489 | <li>super = super-node and super-segments. |
490 | <li>oneway = oneway segments. |
491 | <li>highway-* = segments of the specified highway type |
492 | (e.g. highway-primary to display segments ofprimary roads). |
493 | <li>transport-* = segments allowing the specified transport type |
494 | (e.g. transport-foot to display segments accessible on foot). |
495 | <li>turns = turn restrictions. |
496 | <li>speed = speed limits. |
497 | <li>weight = weight limits. |
498 | <li>height = height limits. |
499 | <li>width = width limits. |
500 | <li>length = length limits. |
501 | <li>property-* = segments having the specified property |
502 | (e.g. property-paved to display segments of paved highway). |
503 | <li>errorlogs = errors logged during parsing. |
504 | </ul> |
505 | </dl> |
506 | <dt>--dump |
507 | <dd>Selects a data dumping mode which allows looking at individual items in |
508 | the databases (specifying 'all' instead of a number dumps all of them). |
509 | More than one of the following parameters can be specified on the command |
510 | line. |
511 | <dl> |
512 | <dt>--node=<node> |
513 | <dd>Prints the information about the selected node number (internal |
514 | number, not the node id number in the original source file). |
515 | <dt>--segment=<segment> |
516 | <dd>Prints the information about the selected segment number. |
517 | <dt>--way=<way> |
518 | <dd>Prints the information about the selected way number (internal |
519 | number, not the way id number in the original source file). |
520 | <dt>--turn-relation=<relation> |
521 | <dd>Prints the information about the selected turn relation number |
522 | (internal number, not the relation id number in the original source |
523 | file). |
524 | <dt>--errorlog=<number> |
525 | <dd>Prints the information about the selected error log that was stored |
526 | when the data was parsed. |
527 | </dl> |
528 | <dt>--osm-dump |
529 | <dd>Dumps the contents of the database as an OSM format XML file, the whole |
530 | database will be dumped unless the latitude and longitude ranges are |
531 | specified. |
532 | <dl> |
533 | <dt>--no-super |
534 | <dd>The super segments will not be output. |
535 | <dt>--latmin=<latmin> --latmax=<latmax> |
536 | <dd>The range of latitudes to dump the data for. |
537 | <dt>--lonmin=<lonmin> --lonmax=<lonmax> |
538 | <dd>The range of longitudes to dump the data for. |
539 | </dl> |
540 | <dt>--dump-visualiser |
541 | <dd>Dumps the contents of the database as HTML formatted items for display in |
542 | the visualiser web page. |
543 | <dl> |
544 | <dt>--data=node<node> |
545 | <dd>Prints the information about the selected node number (internal |
546 | node number, not from the original source file). |
547 | <dt>--data=segment<segment> |
548 | <dd>Prints the information about the selected segment number as if it was |
549 | a way (internal segment number, unrelated to original source file). |
550 | <dt>--data=turn-relation<relation> |
551 | <dd>Prints the information about the selected turn relation number |
552 | (internal turn relation number, not from the original source file). |
553 | <dt>--data=errorlog<number> |
554 | <dd>Prints the information about the selected error log that was stored |
555 | when the data was parsed. |
556 | </dl> |
557 | </dl> |
558 | |
559 | |
560 | <h3 id="H_1_1_4">filedumperx</h3> |
561 | |
562 | This program is a modified version of filedumper that will dump out the contents |
563 | of the intermediate data that is saved by planetsplitter after processing using |
564 | the --keep or --changes option. This is intended for test purposes only and |
565 | gives no useful information about the routing database. |
566 | |
567 | <pre class="boxed"> |
568 | Usage: filedumperx [--help] |
569 | [--dir=<dirname>] [--prefix=<name>] |
570 | [--dump [--nodes] |
571 | [--ways] |
572 | [--route-relations] |
573 | [--turn-relations]] |
574 | </pre> |
575 | |
576 | <dl> |
577 | <dt>--help |
578 | <dd>Prints out the help information. |
579 | <dt>--dir=<dirname> |
580 | <dd>Sets the directory name in which to read the local database. |
581 | Defaults to the current directory. |
582 | <dt>--prefix=<name> |
583 | <dd>Sets the filename prefix for the files in the local database. |
584 | <dt>--dump |
585 | <dd>Dumps the complete set of data in the intermediate files that are written |
586 | by planetsplitter using the --keep or --changes options. |
587 | <dl> |
588 | <dt>--nodes |
589 | <dd>Dumps the node data. |
590 | <dt>--ways |
591 | <dd>Dumps the way data. |
592 | <dt>--route-relations |
593 | <dd>Dumps the route relation data. |
594 | <dt>--turn-relations |
595 | <dd>Dumps the turn relation data. |
596 | </dl> |
597 | </dl> |
598 | |
599 | </div> |
600 | |
601 | <!-- Content End --> |
602 | |
603 | <!-- Footer Start --> |
604 | |
605 | <div class="footer"> |
606 | <hr> |
607 | |
608 | <address> |
609 | © Andrew M. Bishop - <a href="http://www.routino.org/">http://www.routino.org/</a> |
610 | </address> |
611 | |
612 | </div> |
613 | |
614 | <!-- Footer End --> |
615 | |
616 | </body> |
617 | |
618 | </html> |