Learn R Programming

tmap (version 2.0)

tmap-package: 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.

Arguments

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 (RasterBrick object)
--------------------------- ---------------------------------------------------------------------------------------------------

Details

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

References

Tennekes, M., 2018, tmap: Thematic Maps in R, Journal of Statistical Software, 84(6), 1-39, DOI

See Also

vignette("tmap-getstarted")