-
Notifications
You must be signed in to change notification settings - Fork 74
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]