Skip to content

BeansIsFat/tmap

 
 

Repository files navigation

tmap: thematic maps in R

License CRAN cran checks Downloads

tmap is an actively maintained open-source R-library for drawing thematic maps. The API is based on A Layered Grammar of Graphics 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.

Installation

tmap is available on CRAN. Installation is straightforward:

install.packages("tmap")

For Linux and macOS users who are new to working with spatial data in R, this may fail since additional (non-R) libraries are required (which are automatically installed for Windows users).

Windows No additional installation required.

Linux (Ubuntu) See https://r-spatial.github.io/sf/#linux

macOS See https://r-spatial.github.io/sf/#macos

Development (major update!)

We are working on a major update (version4). The development of the current CRAN release (3.3) has been stopped, but if there are critical bugs, let us know. Version 4 will be submitted to CRAN this year, when it is mature enough and when it is backwards compatible with version 3.

Are you curious about version 4? You can install the development version as follows:

library(remotes)
install_github("r-tmap/tmap@v4")

Any feedback, requests, tips, or bug reports are welcome!

Usage

library(tmap)

Book

Tennekes, M., Nowosad, J., Elegant and informative maps with tmap. Draft version, https://r-tmap.github.io/

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 and 3.x. When version 4 is published on CRAN, we will publish the book, which will then be the official reference for tmap.

Vignettes

tmap: get started!

tmap: what is changed in recent versions?

tmap v4: a sneak peak

Tutorials

tmap in RMarkdown

Presentations

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.

Releases

No releases published

Packages

No packages published

Languages

  • R 99.8%
  • Shell 0.2%