Skip to content
R package for thematic maps
R Other
  1. R 99.7%
  2. Other 0.3%
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
R improved grid lines/graticules Jun 5, 2020
build improved land and plotting multi-layered stars Jan 23, 2020
data improved land and plotting multi-layered stars Jan 23, 2020
demo/tutorials cleaned README.MD Oct 14, 2019
examples original CRS in view mode working May 28, 2020
inst Fix typo Mar 22, 2019
man added tmap option check.and.fix Jun 4, 2020
sandbox cleaned / renamed scripts May 3, 2020
tests fixed bug in raster warning (free.scales=F) Apr 3, 2020
vignettes classInt updated Apr 8, 2020
.Rbuildignore SUBMITTED TO CRAN (VERSION 2.2) Jan 4, 2019
._.Rhistory options to translate choropleth legend strings May 4, 2015
.gitignore improved facets #267 #268 Jan 3, 2019
.travis.yml ... May 4, 2020
DESCRIPTION added in.iframe to tmap_save May 19, 2020
LICENSE Initial commit Nov 25, 2013
NAMESPACE original CRS in view mode working May 28, 2020
NEWS original CRS in view mode working May 28, 2020 updated readme, travis and tic scripts Apr 10, 2020
appveyor.yml moved pkg to root Dec 29, 2016
codecov.yml replaced sapply by vapply (safer + faster), testing testthat and covr May 17, 2018 submitted to CRAN (3.0) Apr 8, 2020
tic.R ... May 4, 2020
tmap.Rproj moved pkg to root Dec 29, 2016 fixed #166 Feb 4, 2018 check() ok Feb 3, 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

See below the source code for these images.


tmap is available on CRAN (version 3.0). Installation is straightforward:


However, some operating systems require additional libraries. The installation procedure is as follows:

Windows No additional installation required.

Linux (Ubuntu) See

macOS See Please address installation 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. See the reproducible code using tmap 2.x.


tmap: get started!

tmap: what is changed in recent versions?


tmap in RMarkdown


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.
You can’t perform that action at this time.