Object of class UK
UK.Rd
Creates an object with data and coordinates of class UK
for United Kindome statistical units to use with mapping
functions or available in other R "maps" packages.
Usage
UK(data, colID = NULL, unit = c("country", "county"),
year = c("2020", "2019"), matchWith = c("name", "code"),
scale = c("500", "20"), 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 or codes
- unit
the type of Italian statistical unit
- year
year of the analysis
- matchWith
the type of id to check:
"name"
if unit names "code"
if unit code - scale
the scale of the map
- 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 withunit
names- dir
local directory in which shape files are stored
- use_cache
a logical value indicating whether use the cache
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")
.
Examples
data("popUK")
uk <- UK(data = popUK, unit = "county", matchWith = "code")
### Adding two varaibles
# \donttest{
uk2 <- UK(data = popUK, unit = "county", matchWith = "code",
add = ~I(population/1000) + I(population/100) )
### Adding to variables and names
uk3 <- UK(data = popUK, unit = "county", matchWith = "code",
add = ~I(population/1000) + I(population/100),
new_var_names = c("ratio1", "ratio2"))
# }