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