GitHub - r-tmap/tmap: R package for thematic maps (original) (raw)

tmap: thematic maps in R

tmap is an R package for drawing thematic maps. The API is based onA Layered Grammar of Graphics and resembles the syntax ofggplot2, a popular R-library for drawing charts.

Installation

Installation of tmap is straightforward:

In case it fails, please check the dependencies below.

Development version

The development version can be installed from the GitHub repository using one of the following functions:

install.packages("remotes")

remotes::install_github("r-tmap/tmap")

install.packages("pak")

pak::pak("r-tmap/tmap")

Or from r-universe

install.packages("tmap", repos = c("https://r-tmap.r-universe.dev", "https://cloud.r-project.org"))

Dependencies

tmap depend on other R packages, which will automatically be installed along. However, two packages sf and s2 have additional system requirements: for Windows users, these are also installed along. For Linux and MacOS users, these additional libraries may need to be installed manually.

Instructions for the libraries GEOS, GDAL and PROJ (required by sf): see the installation instructions of terra which requires the same libraries:MacOSandLinux

Instructions for the libraries Abseil and OpenSS (required by s2): see the installation instructions.

Getting started

Plot a World map of the happy planet index (HPI) per country. The objectWorld is an example spatial data (sf) object that is contained intmap:

tm_shape(World) + tm_polygons(fill = "HPI")

This map can be enhanced in several ways. For instance:

tm_shape(World, crs = "+proj=robin") + tm_polygons(fill = "HPI", fill.scale = tm_scale_continuous(values = "matplotlib.rd_yl_bu"), fill.legend = tm_legend(title = "Happy Planet Index", orientation = "landscape", frame = FALSE) )

Online tmap course

3-6 June, organized jointly byPRStatsandInstats

Additional Resources for Learning tmap

For more in-depth learning on the tmap package, refer to the following resources:

• Book Chapter: Geocomputation with Rincludes a chapter on Making Maps with R, which covers tmap.
• Official Vignettes: A collection of vignettes atr-tmap.github.io covers both basic and advanced topics with examples.
• Work-in-Progress Book: Elegant and Informative Maps with tmap is an upcoming book available attmap.geocompx.org.

These resources provide a solid foundation for working with tmap in R.