build_gmap: Build a glyph map
In pkuhnert/VizU: Visualizing Uncertainty in Spatial Data

build_gmap

R Documentation

Build a glyph map

Description

This function builds a map that visualises estimates and errors simultaneously with rotated glyphs.

Usage

build_gmap(
  data,
  geoData = NULL,
  id = NULL,
  size = 50,
  border = NULL,
  glyph = "icone",
  palette = "Blues",
  limits = NULL,
  max_error = NULL
)

Arguments

`data`	A data frame with estimates and errors, formatted with `read.uv`.
`geoData`	An sf or sp object.
`id`	Name of the common column shared by the objects passed to `data` and `geoData`. The estimates and errors in the data frame will be matched to the geographical regions through this column.
`size`	An integer between 1 and 100. Value controls the size of the glyphs.
`border`	Name of geographical borders to be added to the map. It must be one of `county`, `france`, `italy`, `nz`, `state`, `usa` or `world` (see documentation for `map_data` for more information). The borders will be refined to match latitute and longtidue coordinates from the geoData argument.
`glyph`	Name of glyph shape. Options include `icone` and `semi`.
`palette`	Name of colour palette. It must be one of `Blues`, `Greens`, `Greys`, `Oranges`, `Purples` or `Reds` (see documentation for `scale_fill_distiller` for more information).
`limits`	Limits for the legend. Default is NULL, which takes the limits to be the range of the data.
`max_error`	maximum error value. Default is NULL, which takes the maximum from the error given

Details

If an sf or sp object is used, glyphs will be plotted at region centroids. If geoData remains NULL, glyphs will be plotted at points on the map representing specific sites; in this case, the data frame must include latitude and longitude coordinates in columns "long" and "lat".

Examples

data(us_data)
data(us_geo)
co_geo <- subset(us_geo, us_geo@data$STATE == "08")
us_data$GEO.id2 <- as.numeric(us_data$GEO.id2)
co_data <- subset(us_data, us_data$GEO.id2 > 8000 & us_data$GEO.id2 < 9000)
co_data <- read.uv(data = co_data, estimate = "pov_rate", error = "pov_moe")

# build a glyph map
map <- build_gmap(data = co_data, geoData = co_geo, id = "GEO_ID",
 size = 70, border = "state", glyph = "icone")
view(map)

pkuhnert/VizU documentation built on Nov. 2, 2024, 4:52 p.m.