SchoolDataIT (version 0.2.4)

Map_School_Buildings: Display data fom the school buildings database

Description

This function displays a map of the data downloaded trough the Get_DB_MIUR function. It supports two kinds of map:

• Interactive map (default option), which allows the user to visualize all the data in scope through the interactive popup, and

• Static map (ggplot), which can be easily exported in .pdf objects.

Usage

Map_School_Buildings(
  data = NULL,
  field,
  order = NULL,
  level = "LAU",
  region_code = c(1:20),
  plot = "mapview",
  pal = "viridis",
  col_rev = FALSE,
  popup_height = 200,
  main_pos = "top",
  main = "",
  only_observed = FALSE,
  verbose = TRUE,
  input_shp = NULL,
  autoAbort = FALSE,
  ...
)

Value

If plot == "mapview", an object of class mapview. Otherwise, if plot == "ggplot", an object of class gg and ggplot.

Arguments

data

Object of class list or tbl_df, tbl and data.frame. Input data obtained as output of the function Group_DB_MIUR If NULL, it will be downloaded automatically but not saved in the global environment. NULL by default.

field

Character. The variable to display in the map.

order

Character. The school order. Either "Primary", "Middle", or "High" (high school). If NULL, an average of the three school orders will be displayed for the target variable. NULL by default.

level

Character. The administrative level of detailed at which the target variable must be displayed. Either "LAU"/"Municipality" or "NUTS-3"/"Province". "LAU" by default.

region_code

Numeric. The NUTS-2 codes of the units that must be displayed. If the level is set to "LAU", choosing a limited number of regions is recommended. By default, c(1:20), i.e. all Italian regions.

plot

Character. The type of map to display; either "mapview" for interactive maps, or "ggplot" for static maps. "mapview" by default.

pal

Character. The palette to use if the "mapview" mode is chose. "viridis" by default.

col_rev

Logical. Whether the scale of the colour palette should be reverted or not, if the "mapview" mode is chosen. FALSE by default

popup_height

Numeric. The height of the popup table in terms of pixels if the "mapview" mode is chosen. 200 by default.

main_pos

Character. Where the header should be placed if the ggplot mode is chosen. The header is located on the top if "top" is given as input, and above the legend scale otherwise. "top" by default.

main

Character. The customary title to display in the "ggplot" rendering options

only_observed

Logical. Whether to remove unobserved areas from the plot. FALSE by default.

verbose

Logical. If TRUE, the user keeps track of the main underlying operations. TRUE by default.s

input_shp

Object of class sf, tbl_df, tbl, data.frame. The relevant shapefiles of Italian administrative boudaries, at the selected level of detail (LAU or NUTS-3). If NULL it is downloaded automatically but not saved in the global environment. NULL by default.

autoAbort

Logical. In case any data must be retrieved, whether to automatically abort the operation and return NULL in case of missing internet connection or server response errors. FALSE by default.

...

If data is not provided, the arguments to Group_DB_MIUR.

Examples

  library(magrittr)

  DB23_MIUR <- example_input_DB23_MIUR %>%
    Util_DB_MIUR_num(track.deleted = FALSE) %>%
    Group_DB_MIUR(InnerAreas = FALSE, count_missing = FALSE)

  DB23_MIUR %>% Map_School_Buildings(field = "School_bus",
     order = "Primary",level = "NUTS-3",  plot = "ggplot",
     input_shp = example_Prov22_shp)

  DB23_MIUR %>% Map_School_Buildings(field = "Railway_transport",
     order = "High",level = "NUTS-3", plot = "ggplot",
     input_shp = example_Prov22_shp)

  DB23_MIUR %>% Map_School_Buildings(field = "Context_without_disturbances",
     order = "Middle",level = "NUTS-3", plot = "ggplot",
     input_shp = example_Prov22_shp, col_rev = TRUE)