tmap (version 2.2)

tm_scale_bar: Scale bar


Creates a scale bar. By default, the coordinate units are assumed to be meters, and the map units in kilometers. This can be changed in tm_shape.


tm_scale_bar(breaks = NULL, width = NA, size = 0.5,
  text.color = NA, color.dark = "black", color.light = "white",
  lwd = 1, position = NA, just = NA)



breaks of the scale bar. If not specified, breaks will be automatically be chosen given the prefered width of the scale bar. Not available for view mode.


(preferred) width of the scale bar. Only applicable when breaks=NULL. In plot mode, it corresponds the relative width; the default is 0.25 so one fourth of the map width. In view mode, it corresponds to the width in pixels; the default is 100.


relative text size (which is upperbound by the available label width)


color of the text. By default equal to the argument attr.color of tm_layout.


color of the dark parts of the scale bar, typically (and by default) black.


color of the light parts of the scale bar, typically (and by default) white.


line width of the scale bar


position of the scale bar Vector of two values, specifying the x and y coordinates. Either this vector contains "left", "LEFT", "center", "right", or "RIGHT" for the first value and "top", "TOP", "center", "bottom", or "BOTTOM" for the second value, or this vector contains two numeric values between 0 and 1 that specifies the x and y value of the left bottom corner of the scale bar. The uppercase values correspond to the position without margins (so tighter to the frame). The default value is controlled by the argument "attr.position" of tm_layout.


Justification of the attribute relative to the point coordinates. The first value specifies horizontal and the second value vertical justification. Possible values are: "left" , "right", "center", "bottom", and "top". Numeric values of 0 specify left/bottom alignment and 1 right/top alignment. This option is only used, if position is specified by numeric coordinates. The default value is controlled by the argument "attr.just" of tm_layout.


Run this code
current.mode <- tmap_mode("plot")

qtm(NLD_muni, theme = "NLD") + tm_scale_bar(position=c("left", "bottom"))

# restore current mode
# }

Run the code above in your browser using DataCamp Workspace