Routino SVN Repository Browser

Check out the latest version of Routino: svn co http://routino.org/svn/trunk routino

ViewVC logotype

Contents of /trunk/extras/find-fixme/README.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1376 - (show annotations) (download)
Mon Jun 3 18:53:36 2013 UTC (11 years, 9 months ago) by amb
File MIME type: text/plain
File size: 3799 byte(s)
Make it easier to select arbitrary tags and store them.

1 Find and Display FIXME tags
2 ===========================
3
4 The "fixme" tag is often used in OSM data to mark an item whose details are not
5 completely known - as a reminder or request for somebody to check it. Since
6 Routino can now generate a map of tagging problems that it finds it is easy to
7 extend this to finding all "fixme" tags. The files in this directory provide a
8 complete set of executables and web pages for extracting and displaying all
9 items with "fixme" tags on a map.
10
11 Editing fixme.xml and changing the rules for selecting tags allows for creating
12 custom databases to display items containing any desired tag(s).
13
14
15 fixme-finder
16 ------------
17
18 This program is a modified version of the Routino planetsplitter program and can
19 be used on an OSM file to extract the fixme tags and generate a database of
20 them.
21
22
23 Usage: fixme-finder [--help]
24 [--dir=<dirname>]
25 [--sort-ram-size=<size>] [--sort-threads=<number>]
26 [--tmpdir=<dirname>]
27 [--tagging=<filename>]
28 [--loggable] [--logtime]
29 [<filename.osm> ...
30 | <filename.pbf> ...
31 | <filename.o5m> ...
32 | <filename.(osm|o5m).bz2> ...
33 | <filename.(osm|o5m).gz> ...]
34
35 --help Prints this information.
36
37 --dir=<dirname> The directory containing the fixme database.
38
39 --sort-ram-size=<size> The amount of RAM (in MB) to use for data sorting
40 (defaults to 256MB otherwise.)
41 --sort-threads=<number> The number of threads to use for data sorting.
42
43 --tmpdir=<dirname> The directory name for temporary files.
44 (defaults to the '--dir' option directory.)
45
46 --tagging=<filename> The name of the XML file containing the tagging rules
47 (defaults to 'fixme.xml' with '--dir' option)
48
49 --loggable Print progress messages suitable for logging to file.
50 --logtime Print the elapsed time for each processing step.
51
52 <filename.osm>, <filename.pbf>, <filename.o5m>
53 The name(s) of the file(s) to read and parse.
54 Filenames ending '.pbf' read as PBF, filenames ending
55 '.o5m' read as O5M, others as XML.
56 Filenames ending '.bz2' will be bzip2 uncompressed.
57 Filenames ending '.gz' will be gzip uncompressed.
58
59
60 fixme-dumper
61 ------------
62
63 This program is a modified version of the Routino filedumper program and is used
64 by the web page CGI to display the information on a map.
65
66
67 Usage: fixme-dumper [--help]
68 [--dir=<dirname>]
69 [--visualiser --latmin=<latmin> --latmax=<latmax>
70 --lonmin=<lonmin> --lonmax=<lonmax>
71 --data=<data-type>]
72 [--dump--visualiser [--data=fixme<number>]]
73
74 --help Prints this information.
75
76 --dir=<dirname> The directory containing the routing database.
77
78 --visualiser Extract selected data from the routing database:
79 --latmin=<latmin> * the minimum latitude (degrees N).
80 --latmax=<latmax> * the maximum latitude (degrees N).
81 --lonmin=<lonmin> * the minimum longitude (degrees E).
82 --lonmax=<lonmax> * the maximum longitude (degrees E).
83 --data=<data-type> * the type of data to select.
84
85 <data-type> can be selected from:
86 fixmes = fixme tags extracted from the data.
87
88 --dump-visualiser Dump selected contents of the database in HTML.
89 --data=fixme<number> * the fixme with the selected index.