WR: Object of class 'WR'

In mapping: Automatic Download, Linking, Manipulating Coordinates for Maps

Object of class WR

Description

Creates an object with data and coordinate of class WR to use with mapping function or available in other R "maps" packages.

Usage

WR(data, colID = NULL,
   unit = c("country", "nato", "ocde", "continent",
            "region", "subregion", "region_wb",
            "type_income", "type_economy"),
   matchWith = c("country", "iso2", "iso3", "iso3_eh",
                 "iso3_numeric", "iso3_un", "iso2_wb",
                 "iso3_wb", "name_formal", "name_wb"),
   res = c("low", "hi"), show_wr = TRUE, subset = NULL,
   add = NULL, new_var_names = NULL,
   aggregation_fun = sum, aggregation_unit = NULL, aggregation_var = NULL,
   facets = NULL, check.unit.names = TRUE, dir = NULL, use_cache = TRUE,
   print = FALSE, use_internet = TRUE, crs = NULL)

Arguments

data	a data.frame object with variables to display
colID	character value or columns number indicating the column with unit names
unit	the type of world statistical unit
matchWith	the type of id to check: "country" if country names "iso2" if iso2 code "iso3" if iso3 code "iso3_eh" if iso3_eh code "iso3_numeric" if iso3 numeric code "iso3_un" if iso3 United Nations "iso2_wb" if iso2 World Bank "iso3_wb" if iso3 World Bank "name_formal" if formal names "name_wb" if World Bank names
res	map resolution
show_wr	logical value set to TRUE indicating if the entire map is drawn or only the coordinates linked to the input data
subset	a formula indicating the condition to subset the data, see the Details
add	a formula to add new transformed variables starting from the variables in the data
new_var_names	a character value or vector indicating the names of the new variables created in add
aggregation_fun	function to use when data are aggregated
aggregation_unit	variable name by which the unit are aggregated
aggregation_var	variable name with value to aggregate
facets	variable(s) name to split the data
check.unit.names	a logical value indicating if the colID names are checked with unit names
dir	local directory in which shape files are stored
use_cache	a logical value indicating whether use the cache
print	a logical value indicating whether print the nomatched names
use_internet	a logical value indicating wheter the coordinates are downloaded from https://github.com/mappinguniverse/geospatial. If FALSE the maps downloaded during package installation will be used
crs	coordinate reference system. Look at st_crs

Details

The function links (automatically) the id in the data and the coordinates for the given unit.

Since the names (or codes) provided in the data given in input must be checked with the unit names (or codes) available in the package, the check.unit.names provides a preliminary check.

subset provide an expression to subset the data, using a formula with the logical operators. For example, sub-samples of the data can be selected as follows: ~I("Variable 1" == "condition 1" & "Variable 2" != "condition 2") or for example, ~I("Variable 1" > "condition 1" | "Variable 2" != "condition 2").

Value

An object of class WR, with data and coordinates to use in functions which perform map.

See Also

EU, IT, US, DE, UK

Examples

data("popWR")

wr <- WR(data = popWR, colID = "country_code",
         matchWith = "iso3_eh", res = "low")
str(wr, 1)

wr1 <- WR(data = popWR, colID = "country_code",
          matchWith = "iso3_eh", res = "low",
          add = ~I(male/total) + I(female/total))
str(wr1)

wr2 <- WR(data = popWR, colID = "country_code",
          matchWith = "iso3_eh", res = "low",
          add = ~I(male/total) + I(female/total),
          new_var_names = c("Per_Male", "Per_Female"))
str(wr2)

mapping documentation built on May 29, 2024, 5:10 a.m.