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
if (FALSE) { # \dontrun{
# 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")
} # }