hexify_grid: Create a hexagonal grid specification

In hexify: Equal-Area Hex Grids on the 'Snyder' 'ISEA' 'Icosahedron'

Create a hexagonal grid specification

Description

Creates a discrete global grid system (DGGS) object with hexagonal cells at a specified resolution. This is the main constructor for hexify grids.

Usage

hexify_grid(
  area,
  topology = "HEXAGON",
  metric = TRUE,
  resround = "nearest",
  aperture = 3,
  projection = "ISEA"
)

Arguments

area	Target cell area in km^2 (if metric=TRUE) or area code
topology	Grid topology (only "HEXAGON" supported)
metric	Whether area is in metric units (km^2)
resround	How to round resolution ("nearest", "up", "down")
aperture	Aperture sequence (3, 4, or 7)
projection	Projection type (only 'ISEA' supported currently)

Value

A hexify_grid object containing:

area	Target cell area
resolution	Calculated resolution level
aperture	Grid aperture (3, 4, or 7)
topology	Grid topology ("HEXAGON")
projection	Map projection ("ISEA")
index_type	Index encoding type ("z3", "z7", or "zorder")

See Also

hexify for the main user function, hexify_grid_to_cell for coordinate conversion

Other hexify main: hexify()

Examples

# Create a grid with ~1000 km^2 cells
grid <- hexify_grid(area = 1000, aperture = 3)
print(grid)

# Create a finer resolution grid (~100 km^2 cells)
fine_grid <- hexify_grid(area = 100, aperture = 3, resround = "up")

hexify documentation built on March 1, 2026, 1:07 a.m.