mapIT: Choropleth Maps of Italy
In quantide/mapIT: Maps of Italy

Description Usage Arguments Details Value Author(s) See Also Examples

Creazione di mappe (coroplete) delle regioni italiane in maniera semplice.

mapIT(values, id, data, detail = "regions", dataSource = "istat",
  sub = NULL, show_missing = TRUE, show_na = TRUE, discrete = NULL,
  graphPar = list(guide.label = NULL, title = NULL, low = "#f0f0f0", high =
  "#005096", na_color = "#333333", palette = "BuGn", colours = NULL, theme =
  theme_minimal(), themeOption = list(title = element_text(size = 18),
  axis.ticks = element_blank(), axis.text.x = element_blank(), axis.text.y =
  element_blank()), borderCol = "black", show_grid = TRUE, show_guide = TRUE))

`values`	Vettore numerico contenente i valori da associare a ciascuna regione. Può essere indicato un oggetto di tipo vettore oppure una stringa indicante la colonna del data.frame specificato in `data`.
`id`	Vettore contenente i nomi delle aree geografiche a cui associare i valori di `values`. Spazi e altri caratteri non alfabetici vengono ignorati. Questo significa che si può scrivere indifferentemente: 'Trentino-Alto Adige', 'Trentino Alto Adige' o 'TrentinoAltoAdige'. E' indifferente usare lettere maiuscole o minuscole. Per le localit con denominazione bilingue, viene riconosciuta la sola dicitura in italiano. Può essere indicato un oggetto di tipo vettore oppure una stringa indicante la colonna del data.frame specificato in `data`. Per ulteriori informazioni, si vedano i dettagli.
`data`	Specifica il data.frame in cui sono contenuti `values` e `id`. Può essere omesso nel caso in cui `values` e `id` siano due vettori.
`detail`	Dettaglio con cui disegnare la mappa. Aggiunto per future estensioni, attualmente l'unico valore ammesso è quello di default, '`regions`'. Valori diversi vengono ignorati.
`dataSource`	Fonte dei dati. Se uguale a '`istat`' (default), vengono usati i dati forniti dall'Istat e contenuti nel package. Altrimenti un data.frame con la stessa struttura dei dati Istat può essere utilizzato.
`sub`	Vettore contenente i nomi delle aree geografiche da mostrare nella mappa. Consente di produrre una mappa di alcune aree e non di tutta l'Italia.
`show_missing`	Se TRUE (default) mostra anche le aree geografiche per cui non ci sono dati. Se FALSE, invece, le aree geografiche per cui non ci sono dati non vengono mostrate.
`show_na`	Correntemente non implementato. Per sviluppi futuri.
`discrete`	Considera valori numerici come fattori.
`graphPar`	Lista contenente i seguenti parametri grafici: `guide.label` Una stringa contenente un'etichetta per i dati. Se mancante, il nome dell'oggetto contenente i valori `values` viene utilizzato. `title` Titolo del grafico. Se nullo (default), nessun titolo sarà visualizzato. `low` solo se `values` assume valori continui, colore da assegnare alle aree geografiche con valore di `values` più basso. (default: #F0F0F0) `high` solo se `values` assume valori continui, colore da assegnare alle aree geografiche con valore di `values` più alto. (default: #005096) `na_color` solo se `values` assume valori continui, colore da assegnare alle aree geografiche il cui valore è mancante. (default: #333333) `palette` solo se `values` assume valori discreti, tipo di palette RColorBrewer da utilizzare. Viene ignorato se `colours` non è nullo. Per visualizzare tutte le palette disponibili, è possibile utilizzare il comando `RColorBrewer::display.brewer.all()` (default: 'BuGn') `colours` solo se `values` assume valori discreti, colore da associare a ciascun valore di 'values'. Se nullo (default), viene ignorato e utilizzata una palette. `theme` tema ggplot2 da utilizzare. (default: `theme_minimal()`) `themeOption` lista contenente le seguenti impostazioni relative al tema: `title`, `axis.ticks`, `axis.text.x`, `axis.text.y`. Per informazioni sul significato si veda `theme`. `borderCol` colore per i confini delle diverse aree. (default: '`black`') `show_grid` Se TRUE (default), mostra la griglia di sfondo. Se FALSE, la griglia di sfondo non viene visualizzata. Questo parametro viene ignorato se un `theme` viene specificato. `show_guide` correntemente ignorato. Per future estensioni.

Se id è mancante, i valori contenuti in values sono associati alle regioni nel seguente ordine: Piemonte, Valle d'Aosta, Lombardia, Trentino-Alto Adige, Veneto, Friuli-Venezia Giulia, Liguria, Emilia-Romagna, Toscana, Umbria, Marche, Lazio, Abruzzo, Molise, Campania, Puglia, Basilicata, Calabria, Sicilia, Sardegna.

A ggplot class object

Nicola Sturaro

About the ggplot function to map data: geom_map. About data (shapefile): shapefile_istat_regioni.

### utilizza dati continui
  values = runif(20, min = 0, max = 1000)

  # funzione minimale per creare la mappa
  mapIT(values = values)

  # crea id regionali
  # è indifferente usare maiuscole e minuscole
  # i caratteri quali trattini e apostrofi posso essere ignorati
  id = c('Piemonte', 'VALLE DAOSTA', 'lOMBARDiA', 'Trentino Alto Adige', 'VENETO', 'FRiULi - VENEZiA GiULiA', 'LiGURiA', 'EMiLiAROMAGNA', 'TOSCANA', 'UMBRiA', 'MARCHE', 'LAZiO', 'ABRUZZO', 'MOLiSE', 'CAMPANiA', 'PUGLiA', 'BASiLiCATA', 'CALABRiA', 'SiCiLiA', 'SARDEGNA')

  # crea la mappa
  mapIT(values = values, id = id, graphPar = list(guide.label = "Valori"))

  # modifica i colori
  mapIT(values = values, id = id, graphPar = list(guide.label = "Valori", low = "#00ff00", high = "#ff0000"))

  ### utilizza dati categoriali
  values = c(rep("Nord-Ovest", 4), rep("Nord-Est", 4), rep("Centro", 4), rep("Sud", 6), rep("Isole", 2))
  id = c('Piemonte', 'VALLE DAOSTA', 'lOMBARDiA', 'LiGURiA', 'Trentino Alto Adige', 'VENETO', 'FRiULi - VENEZiA GiULiA', 'EMiLiAROMAGNA', 'TOSCANA', 'UMBRiA', 'MARCHE', 'LAZiO', 'ABRUZZO', 'MOLiSE', 'CAMPANiA', 'PUGLiA', 'BASiLiCATA', 'CALABRiA', 'SiCiLiA', 'SARDEGNA')

  # funzione minimale per creare la mappa
  mapIT(values = values, id = id, graphPar = list(guide.label = "Valori"))

  mapIT(values = values, id = id, graphPar = list(guide.label = "Aree geografiche", colours = c("red", "darkblue", "green", "yellow", "purple")))

  # utilizzando i set di colori predefiniti, si ottiene un risultato migliore
  mapIT(values = values, id = id, graphPar = list(guide.label = "Aree geografiche", palette = "Dark2"))

  # modificando i dati affinché le macroaree siano un fattore ordinato, si ottiene una legenda e una colorazione più coerente
  values = factor(values, levels = c("Nord-Ovest", "Nord-Est", "Centro", "Sud", "Isole"), ordered = TRUE)
  mapIT(values = values, id = id, graphPar = list(guide.label = "Aree geografiche"))