Plot a thematic map of so-ii

Usage

map_so_ii(
  dataset,
  dataset_legend = NULL,
  theme = c("none", "collectivity", "catchment", "catnat", "clc", "hydro", "onrn", "osm",
    "population"),
  theme_legend = FALSE,
  detail,
  year,
  scope = "so.ii",
  bar = TRUE,
  limit = TRUE,
  inset = NULL,
  path = NULL,
  add = FALSE,
  ...
)

Arguments

dataset: sf object, data to be plotted
dataset_legend: list of parameters to be passed to legend.
theme: character, choice for the theme (if any). See details.
theme_legend: logical, should a legend be plotted for the theme.
detail: character, detail for theme, depends on theme. See details.
year: character, the year chosen for some themes. See details.
scope: character, choice for the scope of the map. See details.
bar: logical, should a bar be plotted for the dataset. See details.
limit: logical, should the limit of so.ii be plotted for the dataset. Default to TRUE.
inset: character, managing if an inset is plotted.
path: character, the name of the file to save the plot. Graphical device is chosen depending on extension. See details.
add: logical, should the plot be added to an existing one. Default to FALSE.
...: some parameters that will be used by plot (from sf) or by add_bar (so.ii).

Value

Nothing useful.

Details

theme specification

For the specification of detail, it depends on the theme chosen.

none: perimeter of so_ii is plotted.
catchment: The area of catchments are plotted with a scope depending on detail. At least, a division between Lez and Bassin de l'Or is plotted.
catnat: Informations on the number of "Arrêtés Cat Nat are provided at the scale of collectivities."
collectivty: Boundaries of collectivities are plotted, more some administrative informations depending on detail.
hydro: The hydrophic network is plotted. Depending on detail, only a part (rivers, canals, water bodies) or a degre of detail is plotted.
onrn: Informations on the claims coming from Cat Nat system are plotted at the scale of the collectivities. With detail a selection of the data is made, with year a selection of the period.
osm: A tile from OSM is plotted.
population: Informations on the population coming from INSEE are plotted at the scale of the collectivities. With year a selection of the period is made, with detail a selection of how evolution between 2 years.

detail specification

For the specification of detail, it depends on the theme chosen.

catchment: detail must be chosen in "none", "1", "2", "3" for levels of detail. If missing, "1" will be chosen.
catnat: detail must be chosen in "inondation", "submersion", or "nappe". If missing all type will be chosen and aggregated before plotting.
clc: detail must be chosen in "so.ii", "crop", "both". If missing, "so.ii" will be chosen, and only information inside so_ii_limit is plotted.
collectivity: detail must be chosen in "none", "syble", "symbo", "epci" or "syndicate". If missing, "none" will be chosen, and only the boundaries of collectivities are plotted.
hydro: detail must be chosen in "none", "1", "2", "3" for levels of detail or "canal", "river", "waterbody" for types of hydrographic elements. If missing, "none" will be chosen, and everything is plotted.
onrn: detail must be chosen in "n_catnat", "freq_sin", "cost", "cost_hab", "cost_mean", "ratio", "balance", "ppri_year".
population: detail must be chosen in "absolute", "relative". It used only when more than one year is provided to plot aither absolute or relative evolution.

year specification

For the specification of year, it depends on the theme chosen.

catnat: year corresponds to the year of data. If 2 or more years are given, the sum of the period corresponding to the range of given years is plotted. If missing, the whole available period is plotted.
population: year corresponds to the year of data. If missing, last available year is plotted. If 2 or more years are provided an analysis of the evolution between the range of given years is plotted.

inset specification

If inset is not NULL, an inset will be plotted, depending on the value of as.character(inset). Non-case sensitive partial matching is used, with "é" interpreted as "e".

so-ii: scope perimeter is located within so-ii. Only useful when scope is less than so-ii.
department: scope perimeter is located within Hérault departement, if inset may be interpreted as "department", "département", "hérault", "34".
region: scope perimeter is located within Occitanie region, if inset may be interpreted as "région", "Occitanie", "76" (INSEE code for Occitanie region).
nation: scope perimeter is located within the metropolitean part of France, if inset may be interpreted as "France", "métropole", "nation".

If all other cases, nothing is added.

scope specification

The scope should be either:

so.ii: the whole perimiter of so.ii is chosen. This is default value.
vector of INSEE codes of collectivities in so.ii: a perimeter is build with those collectivies. Only valid codes are taken into account. If none is chosen, a warning is dropped, and default value is used.

path specification

Depending on the extension a device is chosen.

pdf: grDevices::cairo_pdf
png: grDevices::png
jpg: grDevices::jpg
svg: grDevices::svg

If path is NULL, standard plotting is used. If an extension is not managed, an error is raised.

Author

Frédéric Grelot

David Nortes Martinez

Examples


if (FALSE) { # \dontrun{
# To be added (soon)
} # }