Skip to content

v0.2.50..v0.2.51 changeset split map.asciidoc

Garret Voltz edited this page Jan 15, 2020 · 1 revision
diff --git a/docs/commands/split-map.asciidoc b/docs/commands/split-map.asciidoc
new file mode 100644
index 0000000..b1a57c0
--- /dev/null
+++ b/docs/commands/split-map.asciidoc
@@ -0,0 +1,26 @@
+[[split-map]]
+== split-map
+
+=== Description
+
+The +split-map+ command reads tile boundaries and input and writes out multiple maps, one for each tile in the tile boundary containing
+only the elements that reside within that boundary.  For elements that span multiple boundaries, the geospatial envelope of the element
+is compared to all tiles it intersects and is stored in the one that contains the highest percentage of overlap.
+
+* +tiles+         - Tile map; may be any supported input format (e.g. OSM file).  For use with tile maps generated by the
+                    https://github.com/ngageoint/hootenanny/blob/master/docs/commands/node-density-tiles.asciidoc[node-density-tiles] command.
+* +input+         - Input map; may be any supported input format (e.g. OSM file).
+* +output+        - Output file path; may be any suppported output format (e.g. OSM file).  The output will consist of 'n' number
+                    of output files where 'n' is the number of tiles in the +tiles+ map.  Each resulting map will contain only the
+                    elements whose geospatial envelope is mostly contained by the tile.
+
+=== Usage
+
+--------------------------------------
+split-map (tiles) (input) (output)
+--------------------------------------
+
+=== See Also
+
+* https://github.com/ngageoint/hootenanny/blob/master/docs/user/SupportedDataFormats.asciidoc#applying-changes-1[Supported Input Formats]
+* https://github.com/ngageoint/hootenanny/blob/master/docs/commands/node-density-tiles.asciidoc[node-density-tiles Command]
Clone this wiki locally