Pycnophylactic interpolation to an H3 grid

Interpolates polygon counts to an H3 grid while preserving source-zone totals.

Usage

to_h3(source, value_col, resolution, ...)

Arguments

source: An sf polygon object in a projected CRS.
value_col: Column containing the values to interpolate. May be supplied as an unquoted column name or a character string.
resolution: H3 resolution level (0–15). Higher values produce smaller cells and many more output polygons. For typical urban analyses, values around 9–12 are usually more practical.
...: Additional arguments passed to to_grid().

Value

An sf object containing H3 cells and interpolated values.

Details

H3 is a hierarchical global discrete grid system composed primarily of hexagonal cells. Higher resolution levels produce smaller cells and a larger number of output cells. H3 resolutions range from 0 to 15, but high resolutions may be impractical for large study areas.

Calls to_grid() with grid_type = "h3".

Examples

out <- to_h3(
  source = nyc_ct_small,
  value_col = populationE,
  resolution = 9,
  max_iter = 5
)
#> Warning: Pycnophylactic smoothing did not converge within `max_iter = 5`. Final relative mean change was 0.0008279.