Make dot density points

Usage

dots_points(
  shp,
  cols,
  engine = engine_terra,
  divisor = 250,
  min_point = 0.1 * divisor
)

Arguments

shp: input shp with sf geometry.
cols: <tidy-select> columns to produce dots for.
engine: backend to use. Default is engine_terra.
divisor: Number of people per dot. Default is 250.
min_point: Minimum number of people to generate one dot. Defaults to 10% of the divisor.

Value

tibble with sf geometries

Examples

data('suffolk')
# subset to first 20 rows for speed on CRAN
dots_points(suffolk[1:20, ], c(vap_black))
#> Simple feature collection with 35 features and 2 fields
#> Geometry type: POINT
#> Dimension:     XY
#> Bounding box:  xmin: -7921437 ymin: 5200034 xmax: -7903455 ymax: 5222099
#> Projected CRS: WGS 84 / Pseudo-Mercator
#> First 10 features:
#>    vap_black dots_type                 geometry
#> 1          1 vap_black POINT (-7907258 5221082)
#> 2          2 vap_black POINT (-7909872 5205321)
#> 3          2 vap_black POINT (-7909596 5205285)
#> 4          1 vap_black POINT (-7918409 5203426)
#> 5          1 vap_black POINT (-7915016 5207796)
#> 6          1 vap_black POINT (-7921437 5203620)
#> 7          1 vap_black POINT (-7908255 5204734)
#> 8          1 vap_black POINT (-7912226 5214685)
#> 9          1 vap_black POINT (-7907319 5218853)
#> 10         3 vap_black POINT (-7913709 5208124)