tmap_format: Get or add format options

Description Usage Arguments Value See Also Examples

View source: R/tmap_format.R

Description

Format options are tmap options that are shape dependent. With tmap_format() the predefined formats can be retrieved. The values for a specific format can be retrieved with tmap_format(format), where format is the name of the format. The function tmap_format_add is used to add a format.

Usage

1
2
3

Arguments

format

name of the format. Run tmap_format() to see the choices.

...

options from tm_layout or tm_view. Can also be a list of those options.

name

name of the new format.

Value

the function tmap_format() returns the names of the available formats. When format is defined, it returns the option list corresponding the that format.

See Also

tm_layout for predefined styles, tmap_style_catalogue to create a style catalogue of all available styles, and tmap_options for tmap options.

tmap_options for tmap options

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# available formats
tmap_format()

# create option list to be used as a new format
World_small <- tmap_format("World")
World_small$scale <- 2

# add format
tmap_format_add(World_small, name = "World_small")

# observe that World_small is successfully added:
tmap_format()

data(World)

qtm(World, fill="HPI", format="World_small")

Example output

available formats are: "World", "World_wide", "NLD", "NLD_wide" 
format World_small succesfully added. Use this format with tm_format("World_small")
available formats are: "World", "World_wide", "NLD", "NLD_wide", "World_small" 

tmap documentation built on June 16, 2021, 9:10 a.m.