Specify the layout of the maps. tm_layout()
is identical as tm_options()
but only contain the tmap options that are directly related to the layout. tm_style()
sets the style for the map. A style is a specified set of options (that can be changed afterwards with tm_layout()
). These functions are used within a plot a plot call (stacked with the +
operator). Their counterparts tmap_options()
and tmap_style()
can be used to set the (layout) options globally.
tm_style(style, ...)tm_layout(
scale,
asp,
bg.color,
outer.bg.color,
frame,
frame.lwd,
frame.r,
frame.double_line,
outer.margins,
inner.margins,
inner.margins.extra,
meta.margins,
meta.auto_margins,
between_margin,
panel.margin,
component.offset,
component.stack_margin,
grid.mark.height,
xylab.height,
coords.height,
xlab.show,
xlab.text,
xlab.size,
xlab.color,
xlab.rotation,
xlab.space,
xlab.fontface,
xlab.fontfamily,
xlab.alpha,
xlab.side,
ylab.show,
ylab.text,
ylab.size,
ylab.color,
ylab.rotation,
ylab.space,
ylab.fontface,
ylab.fontfamily,
ylab.alpha,
ylab.side,
panel.type,
panel.wrap.pos,
panel.xtab.pos,
unit,
color.sepia_intensity,
color.saturation,
color_vision_deficiency_sim,
text.fontface,
text.fontfamily,
text.alpha,
component.position,
component.autoscale,
legend.show,
legend.design,
legend.orientation,
legend.position,
legend.width,
legend.height,
legend.stack,
legend.group.frame,
legend.resize_as_group,
legend.reverse,
legend.na.show,
legend.title.color,
legend.title.size,
legend.title.fontface,
legend.title.fontfamily,
legend.title.alpha,
legend.xlab.color,
legend.xlab.size,
legend.xlab.fontface,
legend.xlab.fontfamily,
legend.xlab.alpha,
legend.ylab.color,
legend.ylab.size,
legend.ylab.fontface,
legend.ylab.fontfamily,
legend.ylab.alpha,
legend.text.color,
legend.text.size,
legend.text.fontface,
legend.text.fontfamily,
legend.text.alpha,
legend.frame,
legend.frame.lwd,
legend.frame.r,
legend.bg.color,
legend.bg.alpha,
legend.only,
legend.absolute_fontsize,
legend.settings.standard.portrait,
legend.settings.standard.landscape,
chart.show,
chart.plot.axis.x,
chart.plot.axis.y,
chart.position,
chart.width,
chart.height,
chart.stack,
chart.group.frame,
chart.resize_as_group,
chart.reverse,
chart.na.show,
chart.title.color,
chart.title.size,
chart.title.fontface,
chart.title.fontfamily,
chart.title.alpha,
chart.xlab.color,
chart.xlab.size,
chart.xlab.fontface,
chart.xlab.fontfamily,
chart.xlab.alpha,
chart.ylab.color,
chart.ylab.size,
chart.ylab.fontface,
chart.ylab.fontfamily,
chart.ylab.alpha,
chart.text.color,
chart.text.size,
chart.text.fontface,
chart.text.fontfamily,
chart.text.alpha,
chart.frame,
chart.frame.lwd,
chart.frame.r,
chart.bg.color,
chart.bg.alpha,
chart.object.color,
title.size,
title.color,
title.fontface,
title.fontfamily,
title.alpha,
title.bg.color,
title.bg.alpha,
title.padding,
title.frame,
title.frame.lwd,
title.frame.r,
title.stack,
title.position,
title.width,
title.group.frame,
title.resize_as_group,
credits.size,
credits.color,
credits.fontface,
credits.fontfamily,
credits.alpha,
credits.bg.color,
credits.bg.alpha,
credits.padding,
credits.frame,
credits.frame.lwd,
credits.frame.r,
credits.stack,
credits.position,
credits.width,
credits.height,
credits.group.frame,
credits.resize_as_group,
compass.north,
compass.type,
compass.text.size,
compass.size,
compass.show.labels,
compass.cardinal.directions,
compass.text.color,
compass.color.dark,
compass.color.light,
compass.lwd,
compass.bg.color,
compass.bg.alpha,
compass.margins,
compass.stack,
compass.position,
compass.frame,
compass.frame.lwd,
compass.frame.r,
compass.group.frame,
compass.resize_as_group,
logo.height,
logo.margins,
logo.between_margin,
logo.stack,
logo.position,
logo.frame,
logo.frame.lwd,
logo.frame.r,
logo.group.frame,
logo.resize_as_group,
scalebar.breaks,
scalebar.width,
scalebar.text.size,
scalebar.text.color,
scalebar.color.dark,
scalebar.color.light,
scalebar.lwd,
scalebar.bg.color,
scalebar.bg.alpha,
scalebar.size,
scalebar.margins,
scalebar.stack,
scalebar.position,
scalebar.frame,
scalebar.frame.lwd,
scalebar.frame.r,
scalebar.group.frame,
scalebar.resize_as_group,
grid.show,
grid.labels.pos,
grid.x,
grid.y,
grid.n.x,
grid.n.y,
grid.crs,
grid.col,
grid.lwd,
grid.alpha,
grid.labels.show,
grid.labels.size,
grid.labels.col,
grid.labels.rot,
grid.labels.format,
grid.labels.cardinal,
grid.labels.margin.x,
grid.labels.margin.y,
grid.labels.space.x,
grid.labels.space.y,
grid.labels.inside_frame,
grid.ticks,
grid.lines,
grid.ndiscr,
mouse_coordinates.stack,
mouse_coordinates.position,
mouse_coordinates.show,
minimap.server,
minimap.toggle,
minimap.stack,
minimap.position,
minimap.show,
panel.show,
panel.labels,
panel.label.size,
panel.label.color,
panel.label.fontface,
panel.label.fontfamily,
panel.label.alpha,
panel.label.bg.color,
panel.label.frame,
panel.label.frame.lwd,
panel.label.frame.r,
panel.label.height,
panel.label.rot,
bbox,
qtm.scalebar,
qtm.minimap,
qtm.mouse_coordinates,
earth_boundary,
earth_boundary.color,
earth_boundary.lwd,
earth_datum,
space.color,
check_and_fix,
basemap.show,
basemap.server,
basemap.alpha,
basemap.zoom,
tiles.show,
tiles.server,
tiles.alpha,
tiles.zoom,
attr.color,
title = NULL,
...
)
name of the style
List of tmap options to be set, or option names (characters) to be returned (see details)
Overall scale of the map
Aspect ratio of each map. When asp
is set to NA
(default) the aspect ratio will be adjusted to the used shapes. When set to 0 the aspect ratio is
adjusted to the size of the device divided by the number of columns and rows.
Background color of the map.
Background color of map outside the frame.
Overall frame of the map
The line width of the frame. See graphics::par
, option 'lwd'.
The r (radius) of the frame.
The double line of the frame. TRUE
or FALSE
.
The margins of the outer space (outside the frame. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The margins of the inner space (inside the frame). A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The extra arguments of the margins of the inner space (inside the frame). A list of arguments.
The margins of the meta. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The auto_margins of the meta.
Margin between the map.
The margin of the panel.
The offset of the component.
The stack_margin of the component.
The height of the mark of the grid.
The height of the xylab.
The height of the coords.
The visibility of the xlab. TRUE
or FALSE
.
The text of the xlab.
The size of the xlab.
The color of the xlab.
The rotation of the xlab.
The space of the xlab. In terms of number of text line heights.
The font face of the xlab. See graphics::par
, option 'font'.
The font family of the xlab. See graphics::par
, option 'family'.
The alpha transparency of the xlab.
The side of the xlab.
The visibility of the ylab. TRUE
or FALSE
.
The text of the ylab.
The size of the ylab.
The color of the ylab.
The rotation of the ylab.
The space of the ylab. In terms of number of text line heights.
The font face of the ylab. See graphics::par
, option 'font'.
The font family of the ylab. See graphics::par
, option 'family'.
The alpha transparency of the ylab.
The side of the ylab.
The type of the panel.
The panel positions for wrapped facets created with tm_facets_grid()
. One of "left"
, "right"
, "top"
(default) or "bottom"
.
The panel positions for grid facets created with tm_facets_grid()
. Vector of two, where the first determines the locations of row panels ("left"
or "right"
) and the second the location of column panels ( "top"
or `"bottom")
Unit of the coordinate
The sepia_intensity of the color.
The saturation of the color.
`Color vision deficiency simulation
The font face of the text. See graphics::par
, option 'font'.
The font family of the text. See graphics::par
, option 'family'.
The alpha transparency of the text.
The position of the component. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The autoscale of the component.
The visibility of the legend. TRUE
or FALSE
.
The design of the legend.
The orientation of the legend.
The position of the legend. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The width of the legend.
The height of the legend.
The stack of the legend.
The frame of the group of the legend.
The resize_as_group of the legend.
The reverse of the legend.
The visibility of the na of the legend. TRUE
or FALSE
.
The color of the title of the legend.
The size of the title of the legend.
The font face of the title of the legend. See graphics::par
, option 'font'.
The font family of the title of the legend. See graphics::par
, option 'family'.
The alpha transparency of the title of the legend.
The color of the xlab of the legend.
The size of the xlab of the legend.
The font face of the xlab of the legend. See graphics::par
, option 'font'.
The font family of the xlab of the legend. See graphics::par
, option 'family'.
The alpha transparency of the xlab of the legend.
The color of the ylab of the legend.
The size of the ylab of the legend.
The font face of the ylab of the legend. See graphics::par
, option 'font'.
The font family of the ylab of the legend. See graphics::par
, option 'family'.
The alpha transparency of the ylab of the legend.
The color of the text of the legend.
The size of the text of the legend.
The font face of the text of the legend. See graphics::par
, option 'font'.
The font family of the text of the legend. See graphics::par
, option 'family'.
The alpha transparency of the text of the legend.
The frame of the legend.
The line width of the frame of the legend. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the legend.
The color of the bg of the legend.
The alpha transparency of the bg of the legend.
The only of the legend.
The absolute fontsize of the legend. So far, only used to calculate legend dimensions
The portrait of the standard of the settings of the legend.
The landscape of the standard of the settings of the legend.
The visibility of the chart. TRUE
or FALSE
.
The x of the axis of the plot of the chart.
The y of the axis of the plot of the chart.
The position of the chart. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The width of the chart.
The height of the chart.
The stack of the chart.
The frame of the group of the chart.
The resize_as_group of the chart.
The reverse of the chart.
The visibility of the na of the chart. TRUE
or FALSE
.
The color of the title of the chart.
The size of the title of the chart.
The font face of the title of the chart. See graphics::par
, option 'font'.
The font family of the title of the chart. See graphics::par
, option 'family'.
The alpha transparency of the title of the chart.
The color of the xlab of the chart.
The size of the xlab of the chart.
The font face of the xlab of the chart. See graphics::par
, option 'font'.
The font family of the xlab of the chart. See graphics::par
, option 'family'.
The alpha transparency of the xlab of the chart.
The color of the ylab of the chart.
The size of the ylab of the chart.
The font face of the ylab of the chart. See graphics::par
, option 'font'.
The font family of the ylab of the chart. See graphics::par
, option 'family'.
The alpha transparency of the ylab of the chart.
The color of the text of the chart.
The size of the text of the chart.
The font face of the text of the chart. See graphics::par
, option 'font'.
The font family of the text of the chart. See graphics::par
, option 'family'.
The alpha transparency of the text of the chart.
The frame of the chart.
The line width of the frame of the chart. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the chart.
The color of the bg of the chart.
The alpha transparency of the bg of the chart.
The color of the object of the chart.
The size of the title.
The color of the title.
The font face of the title. See graphics::par
, option 'font'.
The font family of the title. See graphics::par
, option 'family'.
The alpha transparency of the title.
The color of the bg of the title.
The alpha transparency of the bg of the title.
The padding of the title. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The frame of the title.
The line width of the frame of the title. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the title.
The stack of the title.
The position of the title. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The width of the title.
The frame of the group of the title.
The resize_as_group of the title.
The size of the credits.
The color of the credits.
The font face of the credits. See graphics::par
, option 'font'.
The font family of the credits. See graphics::par
, option 'family'.
The alpha transparency of the credits.
The color of the bg of the credits.
The alpha transparency of the bg of the credits.
The padding of the credits. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The frame of the credits.
The line width of the frame of the credits. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the credits.
The stack of the credits.
The position of the credits. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The width of the credits.
The height of the credits.
The frame of the group of the credits.
The resize_as_group of the credits.
The north of the compass.
The type of the compass.
The size of the text of the compass.
The size of the compass.
The labels of the show of the compass.
The directions of the cardinal of the compass.
The color of the text of the compass.
The dark of the color of the compass.
The light of the color of the compass.
The line width of the compass. See graphics::par
, option 'lwd'.
The color of the bg of the compass.
The alpha transparency of the bg of the compass.
The margins of the compass. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The stack of the compass.
The position of the compass. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The frame of the compass.
The line width of the frame of the compass. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the compass.
The frame of the group of the compass.
The resize_as_group of the compass.
The height of the logo.
The margins of the logo. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The between_margin of the logo.
The stack of the logo.
The position of the logo. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The frame of the logo.
The line width of the frame of the logo. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the logo.
The frame of the group of the logo.
The resize_as_group of the logo.
The break values of the scalebar.
The width of the scalebar.
The size of the text of the scalebar.
The color of the text of the scalebar.
The dark of the color of the scalebar.
The light of the color of the scalebar.
The line width of the scalebar. See graphics::par
, option 'lwd'.
The color of the bg of the scalebar.
The alpha transparency of the bg of the scalebar.
The size of the scalebar.
The margins of the scalebar. A vector of 4 values: bottom, left, top, right. The unit is the device height (for bottom and top) or width (for left and right).
The stack of the scalebar.
The position of the scalebar. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The frame of the scalebar.
The line width of the frame of the scalebar. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the scalebar.
The frame of the group of the scalebar.
The resize_as_group of the scalebar.
The visibility of the grid. TRUE
or FALSE
.
The pos of the labels of the grid.
The x of the grid.
The y of the grid.
The x of the n of the grid.
The y of the n of the grid.
The coordinate reference system (CRS) of the grid.
The color of the grid.
The line width of the grid. See graphics::par
, option 'lwd'.
The alpha transparency of the grid.
The visibility of the labels of the grid. TRUE
or FALSE
.
The size of the labels of the grid.
The color of the labels of the grid.
The rot of the labels of the grid.
The format of the labels of the grid.
The cardinal of the labels of the grid.
The x of the margin of the labels of the grid.
The y of the margin of the labels of the grid.
The x of the space of the labels of the grid.
The y of the space of the labels of the grid.
The inside_frame of the labels of the grid.
The ticks of the grid.
The lines of the grid.
The ndiscr of the grid.
The stack of the mouse_coordinates.
The position of the mouse_coordinates. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The visibility of the mouse_coordinates. TRUE
or FALSE
.
The server of the minimap.
The toggle of the minimap.
The stack of the minimap.
The position of the minimap. A tm_pos object, or a shortcut of two values: horizontal (left, center, right) and vertical (top, center, bottom). See tm_pos for details
The visibility of the minimap. TRUE
or FALSE
.
The visibility of the panel. TRUE
or FALSE
.
The labels of the panel.
The size of the label of the panel.
The color of the label of the panel.
The font face of the label of the panel. See graphics::par
, option 'font'.
The font family of the label of the panel. See graphics::par
, option 'family'.
The alpha transparency of the label of the panel.
The color of the bg of the label of the panel.
The frame of the label of the panel.
The line width of the frame of the label of the panel. See graphics::par
, option 'lwd'.
The r (radius) of the frame of the label of the panel.
The height of the label of the panel.
The rot of the label of the panel.
Bounding box of the map (only used if shp
is the main shape (see is.main
)
The scalebar of the qtm.
The minimap of the qtm.
The mouse_coordinates of the qtm.
The earth boundary
The color of the earth_boundary.
The line width of the earth_boundary. See graphics::par
, option 'lwd'.
Earth datum
The color of the space.
Should attempt to fix an invalid shapefile
The visibility of the basemap. TRUE
or FALSE
.
The server of the basemap.
The alpha transparency of the basemap.
The zoom of the basemap.
The visibility of the tiles. TRUE
or FALSE
.
The server of the tiles.
The alpha transparency of the tiles.
The zoom of the tiles.
The color of the attr.
deprecated See tm_title()
tm_shape(World) +
tm_polygons() +
tm_layout(
bg.color = "steelblue",
outer.bg.color = "gold",
frame.lwd = 3,
inner.margins = 0)
tm_shape(World) +
tm_polygons(fill = "HPI") +
tm_style("classic")
tm_shape(World) +
tm_polygons(fill = "HPI") +
tm_style("cobalt")
Run the code above in your browser using DataLab