Try to clarify documentation for point dropping

This commit is contained in:
Eric Fischer
2017-11-15 13:19:42 -08:00
parent f1c3811d97
commit 4dec9b43ae
2 changed files with 16 additions and 12 deletions
+8 -6
View File
@@ -96,13 +96,15 @@ delete the file that already exists with that name.
If you aren't sure what the right maxzoom is for your data, `-zg` will guess one for you If you aren't sure what the right maxzoom is for your data, `-zg` will guess one for you
based on the density of features. based on the density of features.
If you are mapping point features, you will often want to use `-Bg` to automatically choose Tippecanoe will normally drop a fraction of point features at zooms below the maxzoom,
a base zoom level for dot dropping. If that doesn't work out for you, try to keep the low-zoom tiles from getting too big. If you have a smaller data set where
`-r1 --drop-fraction-as-needed` to turn off the normal dot dropping and instead all the points would fit without dropping any of them, use `-r1` to keep them all.
only drop features if the tiles get too big. If you do want point dropping, but you still want the tiles to be denser than `-zg`
thinks they should be, use `-B` to set a basezoom lower than the maxzoom.
If you are mapping points or polygons, you will often want to use `--drop-densest-as-needed` If some of your tiles are coming out too big in spite of the settings above, you will
to drop some of them if necessary to make the low zoom levels work. often want to use `--drop-densest-as-needed` to drop whatever fraction of the features
is necessary at each zoom level to make that zoom level's tiles work.
If your features have a lot of attributes, use `-y` to keep only the ones you really need. If your features have a lot of attributes, use `-y` to keep only the ones you really need.
+8 -6
View File
@@ -93,13 +93,15 @@ delete the file that already exists with that name.
If you aren't sure what the right maxzoom is for your data, \fB\fC\-zg\fR will guess one for you If you aren't sure what the right maxzoom is for your data, \fB\fC\-zg\fR will guess one for you
based on the density of features. based on the density of features.
.PP .PP
If you are mapping point features, you will often want to use \fB\fC\-Bg\fR to automatically choose Tippecanoe will normally drop a fraction of point features at zooms below the maxzoom,
a base zoom level for dot dropping. If that doesn't work out for you, try to keep the low\-zoom tiles from getting too big. If you have a smaller data set where
\fB\fC\-r1 \-\-drop\-fraction\-as\-needed\fR to turn off the normal dot dropping and instead all the points would fit without dropping any of them, use \fB\fC\-r1\fR to keep them all.
only drop features if the tiles get too big. If you do want point dropping, but you still want the tiles to be denser than \fB\fC\-zg\fR
thinks they should be, use \fB\fC\-B\fR to set a basezoom lower than the maxzoom.
.PP .PP
If you are mapping points or polygons, you will often want to use \fB\fC\-\-drop\-densest\-as\-needed\fR If some of your tiles are coming out too big in spite of the settings above, you will
to drop some of them if necessary to make the low zoom levels work. often want to use \fB\fC\-\-drop\-densest\-as\-needed\fR to drop whatever fraction of the features
is necessary at each zoom level to make that zoom level's tiles work.
.PP .PP
If your features have a lot of attributes, use \fB\fC\-y\fR to keep only the ones you really need. If your features have a lot of attributes, use \fB\fC\-y\fR to keep only the ones you really need.
.PP .PP