tmap: thematic maps in R
tmap is an actively maintained open-source R-library for drawing thematic maps, written by Martijn Tennekes. The API is based on A Layered Grammar of Graphics by Hadley Wickham and resembles the syntax of ggplot2, a popular R-library for drawing charts.
See below the source code for these images.
Installation
tmap is available on CRAN (version 2.3-2). Installation is straightforward:
install.packages("tmap")
However, some operating systems require additional libraries.
The installation procedure is as follows:
Windows
No additional installation required.
Linux (Ubuntu)
See installation script for Ubuntu 16 and 17/18. Please address installation issues in the issue thread.
macOS
See http://www.kyngchaos.com. Please address installation issues in the issue thread.
Development
The latest development version can be installed using devtools.
In order to use the development version of tmap, it is recommended to use the development version of tmaptools as well (see tmaptools):
library(devtools)
install_github("mtennekes/tmaptools")
install_github("mtennekes/tmap")
See NEWS for the latest features and improvements and the issue list for discussions of enhancements and bugs.
Do you want to help with the development of the package?
Please let me know!
Any feedback, requests, tips, or bug reports are welcome!
Usage
library(tmap)
Reference
Tennekes, M., 2018, tmap: Thematic Maps in R, Journal of Statistical Software, 84(6), 1-39
This paper has been written for tmap 1.11-2. See the reproducible code using tmap 2.x.
Vignettes
tmap: what is changed in version 2.0?
Tutorials
Presentations
- Creating thematic maps in R (OpenGeoHUB Summer School 2019)
- Plotting spatial data with R (eRum 2018)
- Exploring and presenting maps with tmap (useR!2017)
- tmap: creating thematic maps in a flexible way (useR!2015)]
Other resources
- Geocomputation with R; Making maps with R, Robin Lovelace, Jakub Nowosad, Jannes Muenchow
- R tip: Create maps in R
- Working with Spatial Data and using tmap, Samantha A. Alger
- Computer World: Mapping in R just got a whole lot easier
- National Socio-Environmental Synthesis Center: Maps in R
- Introduction to visualising spatial data in R
- Blog post StatialControl
- Blog post TWIAV
- Computer World: Create maps in R in 10 (fairly) easy steps
- Computer World: Great R packages for data import, wrangling and visualization
- Tutorial Visualising spatial data: from base to shiny - workshop
- Stack Overflow questions (#tmap)
Getting help
There are two main places to get help with tmap:
- stackoverflow is a great source of answers to common tmap questions.
It is also a great place to get help, once you have created a reproducible example that illustrates your problem.
Please tag your questions with tmap. - If you have a request or if think your problem is caused by a bug, please open an issue, preferably with a reproducible example.