-
Notifications
You must be signed in to change notification settings - Fork 74
v0.2.54..v0.2.55 changeset CommandLineExamples.asciidoc
Garret Voltz edited this page Aug 14, 2020
·
1 revision
diff --git a/docs/user/CommandLineExamples.asciidoc b/docs/user/CommandLineExamples.asciidoc
index bd71802..d3f2282 100644
--- a/docs/user/CommandLineExamples.asciidoc
+++ b/docs/user/CommandLineExamples.asciidoc
@@ -284,6 +284,12 @@ See the User Guide for more details on command usage.
hoot sort input.osm output.osm
-----
+===== Tag features with a conflate matcher capable of matching them (useful in debugging):
+
+-----
+ hoot convert -D convert.ops="hoot::ConflatableCriteriaVisitor" input.osm output.osm
+-----
+
==== Comparison
===== Calculate the difference between two maps:
@@ -476,12 +482,21 @@ See the User Guide for more details on command usage.
hoot convert -D changeset.user.id=1 \
-D osmapidb.bulk.inserter.disable.database.constraints.during.write=true \
-D osmapidb.bulk.inserter.disable.database.indexes.during.write=true \
+ input.osm.pbf osmapidb://username:password@localhost:5432/database
+-----
+
+===== Bulk write a map to an offline OSM API database specifying starting element IDs:
+
+-----
+ hoot convert -D changeset.user.id=1 \
+ -D osmapidb.bulk.inserter.disable.database.constraints.during.write=true \
+ -D osmapidb.bulk.inserter.disable.database.indexes.during.write=true \
-D apidb.bulk.inserter.starting.node.id=10 \
-D apidb.bulk.inserter.starting.way.id=10 -D apidb.bulk.inserter.starting.relation.id=10 \
input.osm.pbf osmapidb://username:password@localhost:5432/database
-----
-===== Bulk write a map to an online OSM API database:
+===== Bulk write a map to an online OSM API database (element IDs managed automatically):
-----
hoot convert -D changeset.user.id=1 \
@@ -496,6 +511,15 @@ See the User Guide for more details on command usage.
-D remove.elements.visitor.element.criteria="hoot::RelationCriterion" input.osm output.osm
-----
+===== Remove all but two specific relations:
+
+-----
+ hoot convert -D convert.ops="hoot::RemoveElementsVisitor" \
+ -D remove.elements.visitor.element.criteria="hoot::ElementIdCriterion"
+ -D element.id.criterion.ids="Relation:-1;Relation:7387470"
+ -D element.criterion.negate=true input.osm output.osm
+-----
+
===== Remove relations and ways from a map:
-----
@@ -703,7 +727,32 @@ hoot convert -D convert.ops="hoot::FindRailwayIntersectionsOp" input.osm output.
hoot convert -D convert.ops="hoot::PhoneNumberLocateVisitor" input.osm output.osm
-----
-===== Snap unconnected roads in the second dataset back to neighboring roads in the first dataset:
+===== Snap unconnected roads in one dataset back to neighboring roads in another dataset:
+
+-----
+ hoot convert -D convert.ops="hoot::UnconnectedWaySnapper" \
+ -D snap.unconnected.ways.snap.way.criterion=hoot::HighwayCriterion \
+ -D snap.unconnected.ways.snap.to.way.criterion=hoot::HighwayCriterion \
+ -D snap.unconnected.ways.snap.to.way.node.criterion=hoot::HighwayWayNodeCriterion \
+ -D snap.unconnected.ways.snap.to.way.status=Input1 \
+ -D snap.unconnected.ways.snap.way.status=Input2 \
+ input1.osm input2.osm output.osm
+-----
+
+===== Snap unconnected roads in one dataset back to neighboring roads in another dataset and mark them as needing review:
+
+-----
+ hoot convert -D convert.ops="hoot::UnconnectedWaySnapper" \
+ -D snap.unconnected.ways.snap.way.criterion=hoot::HighwayCriterion \
+ -D snap.unconnected.ways.snap.to.way.criterion=hoot::HighwayCriterion \
+ -D snap.unconnected.ways.snap.to.way.node.criterion=hoot::HighwayWayNodeCriterion \
+ -D snap.unconnected.ways.snap.to.way.status=Input1 \
+ -D snap.unconnected.ways.snap.way.status=Input2 \
+ -D snap.unconnected.ways.review.snapped=true \
+ input1.osm input2.osm output.osm
+-----
+
+===== Mark unconnected roads as needing review in one dataset that could be snapped back to neighboring roads in another dataset:
-----
hoot convert -D convert.ops="hoot::UnconnectedWaySnapper" \
@@ -712,6 +761,8 @@ hoot convert -D convert.ops="hoot::FindRailwayIntersectionsOp" input.osm output.
-D snap.unconnected.ways.snap.to.way.node.criterion=hoot::HighwayWayNodeCriterion \
-D snap.unconnected.ways.snap.to.way.status=Input1 \
-D snap.unconnected.ways.snap.way.status=Input2 \
+ -D snap.unconnected.ways.review.snapped=true \
+ -D snap.unconnected.ways.mark.only=true \
input1.osm input2.osm output.osm
-----
@@ -981,7 +1032,7 @@ Requires language translation server installation. See the Hootenanny Install G
===== List all extractors used to score feature properties:
-----
- hoot info --feature-extractors:
+ hoot info --feature-extractors
-----
===== List all input formats that support reading by geospatial bounds: