R package for thematic maps
Switch branches/tags
Nothing to show
Clone or download
Latest commit 55e8d80 Nov 12, 2018


tmap: thematic maps in R

Build Status AppVeyor Build Status Coverage Status License CRAN Downloads

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.

Classic World Map Bubble Map Bubble Map World facets US Choropleth US Choropleth London Crimes London Crimes London Crimes London Crimes


tmap is available on CRAN (version 2.1-1). Installation is straightforward:


However, for 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 intallation issues in the issue thread.

macOS See http://www.kyngchaos.com. Please address intallation issues in the issue thread.


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):


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!




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. The content of this paper using tmap 2.x is the following:


tmap: get started!

tmap: what is changed in version 2.0?


Demo: tmap in RMarkdown

Demo: tmap in Shiny


Other resources

Getting help

There are two main places to get help with tmap:

  1. 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.
  2. If you have a request or if think your problem is caused by a bug, please open an issue, preferably with a reproducible example.