tmap-package: Thematic Map Visualization

tmap-packageR Documentation

Thematic Map Visualization

Description

Thematic maps are geographical maps in which spatial data distributions are visualized. This package offers a flexible, layer-based, and easy to use approach to create thematic maps, such as choropleths and bubble maps. It is based on the grammar of graphics, and resembles the syntax of ggplot2.

Details

This page provides a brief overview of all package functions. See vignette("tmap_sneak_peek") for a short introduction with examples.

Quick plotting method

qtm() Plot a thematic map
--------------------------- -------------------------------------------

Main plotting method

Shape specification:

tm_shape() Specify a shape object

Aesthetics base layers:

tm_polygons() Create a polygon layer (with borders)
tm_symbols() Create a layer of symbols
tm_lines() Create a layer of lines
tm_raster() Create a raster layer
tm_text() Create a layer of text labels
tm_basemap() Create a layer of basemap tiles
tm_tiles() Create a layer of overlay tiles

Aesthetics derived layers:

tm_fill() Create a polygon layer (without borders)
tm_borders() Create polygon borders
tm_bubbles() Create a layer of bubbles
tm_squares() Create a layer of squares
tm_dots() Create a layer of dots
tm_markers() Create a layer of markers
tm_iso() Create a layer of iso/contour lines
tm_rgb() Create a raster layer of an image

Faceting (small multiples)

tm_facets() Define facets

Attributes:

tm_grid() Create grid lines
tm_scale_bar() Create a scale bar
tm_compass() Create a map compass
tm_credits() Create a text for credits
tm_logo() Create a logo
tm_xlab() and tm_ylab() Create axis labels
tm_minimap() Create a minimap (view mode only)

Layout element:

tm_layout() Adjust the layout (main function)
tm_legend() Adjust the legend
tm_view() Configure the interactive view mode
tm_style() Apply a predefined style
tm_format() Apply a predefined format

Change options:

tmap_mode() Set the tmap mode: "plot" or "view"
ttm() Toggle between the modes
tmap_options() Set global tmap options (from tm_layout(), tm_view(), and a couple of others)
tmap_style() Set the default style

Create icons:

tmap_icons() Specify icons for markers or proportional symbols

Output functions

print() Plot in graphics device or view interactively in web browser or RStudio's viewer pane
tmap_last() Redraw the last map
tmap_leaflet() Obtain a leaflet widget object
tmap_animation() Create an animation
tmap_arrange() Create small multiples of separate maps
tmap_save() Save thematic maps (either as image or HTML file)

Spatial datasets

World World country data (sf object of polygons)
NLD_prov Netherlands province data (sf object of polygons)
NLD_muni Netherlands municipal data (sf object of polygons)
metro Metropolitan areas (sf object of points)
rivers Rivers (sf object of lines)
land Global land cover (stars object)

Author(s)

Martijn Tennekes mtennekes@gmail.com

References

Tennekes, M., 2018, tmap: Thematic Maps in R, Journal of Statistical Software, 84(6), 1-39, \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v084.i06")}

See Also

vignette("tmap_sneak_peek"), https://r-tmap.github.io/tmap/


r-tmap/tmap documentation built on June 23, 2024, 9:58 a.m.