Skip to contents

Map component: logo

Source: R/tm_components.R
tm_logo.Rd

Map component that adds a logo.

Usage

tm_logo(
  file,
  height,
  margins,
  between_margin,
  stack,
  position,
  frame,
  frame.lwd,
  frame.r,
  group.frame,
  resize_as_group,
  z
)

Arguments

file

either a filename or url of a png image. If multiple files/urls are provided with a character vector, the logos are placed near each other. To specify logos for small multiples use a list of character values/vectors. In order to stack logos vertically, multiple tm_logo elements can be stacked.

height

height of the logo in number of text line heights. The width is scaled based the height and the aspect ratio of the logo. If multiple logos are specified by a vector or list, the heights can be specified accordingly.

margins

margins

between_margin

Margin between

stack

stack

position

Vector of two values, specifying the x and y coordinates. The first is either "left" or "right", the second either "top" or "bottom".

frame

frame

frame.lwd

frame line width

frame.r

Radius of the rounded frame corners. 0 means no rounding.

group.frame

group.frame

resize_as_group

resize_as_group

z

z

Examples

data(World)

tm_shape(World) +
  tm_polygons("HPI", fill.scale = tm_scale_intervals(values = "RdYlGn")) +
  tm_logo(c("https://www.r-project.org/logo/Rlogo.png", 
        system.file("img/tmap.png", package="tmap"))) +
  tm_logo("http://blog.kulikulifoods.com/wp-content/uploads/2014/10/logo.png", 
      height=5, position = c("left", "top")) +
  tm_format("World")
#> [deprecated] `tm_format("World")` is deprecated as of tmap 4.0. Instead, please
#> use `tm_layout(inner.margins=c(0, 0.05, 0.025, 0.01),
#> legend.position=tm_pos_in("left", "bottom"), component.position=c("right",
#> "bottom"), scale=.8, title.size = 1.3)`
#> [tip] Consider a suitable map projection, e.g. by adding `+ tm_crs("auto")`.
#> [cols4all] color palettes: use palettes from the R package cols4all. Run
#> `cols4all::c4a_gui()` to explore them. The old palette name "RdYlGn" is named
#> "brewer.rd_yl_gn"
#> Multiple palettes called "rd_yl_gn" found: "brewer.rd_yl_gn", "matplotlib.rd_yl_gn". The first one, "brewer.rd_yl_gn", is returned.