Skip to content

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:
Clone this wiki locally