Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/r-tmap/tmap

R package for thematic maps
https://github.com/r-tmap/tmap

choropleth-maps maps r spatial thematic-maps visualisation

Last synced: 3 months ago
JSON representation

R package for thematic maps

Awesome Lists containing this project

README 

        
# tmap: thematic maps in R 



[![R-CMD-check](https://github.com/r-tmap/tmap/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/r-tmap/tmap/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/r-tmap/tmap/branch/master/graph/badge.svg)](https://app.codecov.io/gh/r-tmap/tmap?branch=master)

[![CRAN](https://www.r-pkg.org/badges/version/tmap)](https://cran.r-project.org/package=tmap) 

[![CRAN checks](https://cranchecks.info/badges/worst/tmap)](https://cran.r-project.org/web/checks/check_results_tmap.html)

[![Downloads](http://cranlogs.r-pkg.org/badges/tmap?color=brightgreen)](https://www.r-pkg.org:443/pkg/tmap)

[![License](https://img.shields.io/badge/License-GPL%20v3-brightgreen.svg?style=flat)](http://www.gnu.org/licenses/gpl-3.0.html)

[![r-universe](https://r-tmap.r-universe.dev/badges/tmap)](https://r-tmap.r-universe.dev/tmap)



[`tmap`][1] is an actively maintained open-source [R][2]-library for drawing thematic maps. The API is based on [*A Layered Grammar of Graphics*][4] and resembles the syntax of [`ggplot2`][3], 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](https://github.com/r-tmap/tmap/#reference) the source code for these images.



Installation

------------



`tmap` is available on [![CRAN](https://www.r-pkg.org/badges/version/tmap)](https://cran.r-project.org/package=tmap). Installation is straightforward:



```r

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://geocompx.org/post/2020/installing-r-spatial-packages-linux/. Please address installation issues in this [issue](https://github.com/r-tmap/tmap/issues/150).



**macOS**

See https://www.kyngchaos.com/. Please address installation issues in this [issue](https://github.com/r-tmap/tmap/issues/149).



Development

------------



The latest development version can be installed using `remotes`. 

In order to use the development version of `tmap`, it is recommended to use the development version of [tmaptools](https://github.com/r-tmap/tmaptools) as well:



```r

# install.packages("remotes")

install_github("r-tmap/tmap")



# On Linux, with pak

# 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"))

```



See [NEWS](https://github.com/r-tmap/tmap/blob/master/NEWS.md) for the latest features and improvements and the [issue list](https://github.com/r-tmap/tmap/issues) for discussions of enhancements and bugs.



Do you want to help with the development of the package?

Please let us know! 

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



Usage

-----



```r

library(tmap)

```



Reference

----

[Tennekes, M., 2018, tmap: Thematic Maps in R, Journal of Statistical Software, 84(6), 1-39](https://doi.org/10.18637/jss.v084.i06)



This paper has been written for `tmap` 1.11-2. See the [reproducible code](https://cran.r-project.org/package=tmap/vignettes/tmap-JSS-code.html) using `tmap` 2.x.



Vignettes 

-----



[tmap v3: get started!](https://cran.r-project.org/package=tmap/vignettes/tmap-getstarted.html)



[tmap: what is changed in recent versions?](https://cran.r-project.org/package=tmap/vignettes/tmap-changes.html)



Tutorials

-----



[tmap in RMarkdown](https://github.com/r-tmap/tmap/blob/master/demo/tutorials/rmarkdown_tmap.Rmd)



Presentations

-----



* [Creating thematic maps in R][23] (OpenGeoHUB Summer School 2019)

* [Plotting spatial data with R](https://github.com/mtennekes/tmap-workshop) (eRum 2018) 

* [Exploring and presenting maps with tmap][21] (useR!2017)

* [tmap: creating thematic maps in a flexible way][10] (useR!2015)]



Other resources

-----



* [Geocomputation with R; Making maps with R, Robin Lovelace, Jakub Nowosad, Jannes Muenchow][20]

* [R tip: Create maps in R][24]

* [Working with Spatial Data and using tmap, Samantha A. Alger][22]

* [Computer World: Mapping in R just got a whole lot easier][18]

* [National Socio-Environmental Synthesis Center: Maps in R][19]

* [Introduction to visualizing spatial data in R][9]

* [Blog post SpatialControl][7]

* [Blog post TWIAV][8]

* [Computer World: Create maps in R in 10 (fairly) easy steps][12]

* [Computer World: Great R packages for data import, wrangling and visualization][17]

* [Tutorial Visualizing spatial data: from base to shiny - workshop][15]

* [Stack Overflow questions (#tmap)][16]



Getting help

-----



There are two main places to get help with `tmap`:



1.  [stackoverflow](https://stackoverflow.com/tags/tmap) 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](https://github.com/r-tmap/tmap/issues), preferably with a reproducible example.



  [1]: https://cran.r-project.org/package=tmap

  [2]: https://stackoverflow.com/tags/r/info

  [3]: https://cran.r-project.org/package=ggplot2

  [4]: https://vita.had.co.nz/papers/layered-grammar.pdf

  [5]: https://github.com/r-tmap/tmap

  [6]: https://cran.r-project.org/web/packages/tmap/vignettes/tmap-nutshell.html

  [7]: http://spatcontrol.net/SpatialControl/2015/11/06/tmap-r-package/

  [8]: https://twiav.nl/en/blog0002en.php

  [9]: https://cran.r-project.org/doc/contrib/intro-spatial-rl.pdf

  [10]: https://mtennekes.github.io/downloads/presentations/tmap_user2015.pdf

  [11]: https://cran.r-project.org/web/packages/tmap/vignettes/tmap-modes.html

  [12]: https://www.computerworld.com/article/3038270/create-maps-in-r-in-10-fairly-easy-steps.html

  [13]: https://github.com/r-tmap/tmap/blob/master/demo/US_choropleth.R

  [14]: https://github.com/r-tmap/tmap/blob/master/demo/crimes_in_Greater_London.R

  [15]: https://github.com/Robinlovelace/Creating-maps-in-R/blob/master/vignettes/vspd-base-shiny.Rmd

  [16]: https://stackoverflow.com/questions/tagged/tmap

  [17]: https://www.computerworld.com/article/2921176/great-r-packages-for-data-import-wrangling-visualization.html

  [18]:	https://www.computerworld.com/article/3175623/mapping-in-r-just-got-a-whole-lot-easier.html

  [19]: https://sesync-ci.github.io/maps-in-R-lesson/

  [20]: https://r.geocompx.org/adv-map.html

  [21]: https://mtennekes.github.io/downloads/presentations/tmap_user2017.pdf

  [22]: https://gotellilab.github.io/Bio381/StudentPresentations/SpatialDataTutorial.html

  [23]: https://mtennekes.github.io/downloads/presentations/tmap_opengeo_muenster.pdf

  [24]: https://www.youtube.com/watch?v=wgFVmzSbaQc#t=3m20s