Guides: axes and legends

The guides (the axes and legends) help readers interpret your plots. Guides are mostly controlled via the scale (e.g. with the limits, breaks, and labels arguments), but sometimes you will need additional cover over the guide apperance. Use guides() or the guide argument to individual scales along with guide_colourbar() or guide_legend().

標記（坐標軸和圖例）幫助讀者理解圖形充坑。標記大多是由規(guī)模來控制的（例如温亲，有限制、中斷和標簽參數(shù)）继低，但是有的時候日熬，你需要放一些額外的標記。使用guides()命令或者使用個性化的guides參數(shù)，像guide_colourbar() 或者 guide_legend().

guide_colourbar guide_colorbar

（原文鏈接：http://ggplot2.tidyverse.org/reference/guide_colourbar.html）
Colour bar guide shows continuous color scales mapped onto values. Colour bar is available with scale_fill and scale_colour. For more information, see the inspiration for this function: Matlab's colorbar function.
生成連續(xù)的彩條圖例
彩色條導圖顯示連續(xù)的顏色標度映射到數(shù)值上顾犹。彩色條可以來自scale_fill和scale_colour。更多信息參考Matlab的顏色條功能褒墨。

代碼

guide_colourbar(title = waiver(), title.position = NULL, title.theme = NULL, title.hjust = NULL, title.vjust = NULL, label = TRUE, label.position = NULL, label.theme = NULL, label.hjust = NULL, label.vjust = NULL, barwidth = NULL, barheight = NULL, nbin = 20, raster = TRUE, ticks = TRUE, draw.ulim = TRUE, draw.llim = TRUE, direction = NULL, default.unit = "line", reverse = FALSE, order = 0, ...)

guide_colorbar(title = waiver(), title.position = NULL, title.theme = NULL, title.hjust = NULL, title.vjust = NULL, label = TRUE, label.position = NULL, label.theme = NULL, label.hjust = NULL, label.vjust = NULL, barwidth = NULL, barheight = NULL, nbin = 20, raster = TRUE, ticks = TRUE, draw.ulim = TRUE, draw.llim = TRUE, direction = NULL, default.unit = "line", reverse = FALSE, order = 0, ...)

參數(shù)

title

A character string or expression indicating a title of guide. If NULL, the title is not shown. By default (waiver), the name of the scale object or the name specified in labs is used for the title.
表示標題的表達式炫刷。如果NULL，則沒有標題郁妈。在默認情況下不顯示浑玛，將使用scale對象的名稱或在實驗室中指定的名稱作為標題。

title.position

A character string indicating the position of a title. One of "top" (default for a vertical guide), "bottom", "left" (default for a horizontal guide), or "right."
標題位置噩咪，上下左右

title.theme

A theme object for rendering the title text. Usually the object of element_text is expected. By default, the theme is specified by legend.title in theme or theme.
呈現(xiàn)標題文本的主題對象顾彰。通常需要element_text對象。默認情況下胃碾，主題由legend指定涨享。

title.hjust

A number specifying horizontal justification of the title text.
指定標題文本的水平對齊。

title.vjust

A number specifying vertical justification of the title text.
指定標題文本的垂直對齊书在。

label

logical. If TRUE then the labels are drawn. If FALSE then the labels are invisible.
邏輯性灰伟。如果是真的，那么標簽就畫出來了儒旬。如果假的話栏账，標簽是看不見的竹伸。

label.position

A character string indicating the position of a label. One of "top", "bottom" (default for horizontal guide), "left", or "right" (default for vertical guide).
表示標簽位置的字符串啥酱。“頂部”咒唆、“底部”甚垦、“左”或“右”茶鹃。

label.theme

A theme object for rendering the label text. Usually the object of element_text is expected. By default, the theme is specified by legend.text in theme or theme.
呈現(xiàn)標簽文本的主題對象涣雕。通常需要element_text對象。默認情況下闭翩，主題由legend指定挣郭。主題或主題的文本。

label.hjust

A numeric specifying horizontal justification of the label text.
指定標簽文本水平對齊疗韵。

label.vjust

A numeric specifying vertical justification of the label text.
指定標簽文本的垂直對齊兑障。

barwidth

A numeric or a unit object specifying the width of the colorbar. Default value islegend.key.width or legend.key.size in theme or theme.
指定colorbar寬度。默認值是Theme的 islegend.key.width或legend.key.size

barheight

A numeric or a unit object specifying the height of the colorbar. Default value islegend.key.height or legend.key.size in theme or theme.
指定顏色條高度蕉汪。默認值是Theme的islegend.key.height或legend.key.size

nbin

A numeric specifying the number of bins for drawing colorbar. A smoother colorbar for a larger value.
指定繪制colorbar的箱子數(shù)的數(shù)字流译。值越大colorbar越平滑。

raster

A logical. If TRUE then the colorbar is rendered as a raster object. If FALSE then the colorbar is rendered as a set of rectangles. Note that not all graphics devices are capable of rendering raster image.
邏輯者疤。如果是TRUE福澡，那么colorbar被呈現(xiàn)為一個光柵對象。如果FALSE驹马，那么colorbar被呈現(xiàn)為一組矩形革砸。注意，并不是所有的圖形設(shè)備都能渲染光柵圖像窥翩。

ticks

A logical specifying if tick marks on colorbar should be visible.
在colorbar上指定標記的邏輯應(yīng)該是可見的业岁。

draw.ulim

A logical specifying if the upper limit tick marks should be visible.
一個邏輯指定如果上限的刻度標記應(yīng)該是可見的。

draw.llim

A logical specifying if the lower limit tick marks should be visible.
一個邏輯指定如果下限刻度標記應(yīng)該是可見的寇蚊。

direction

A character string indicating the direction of the guide. One of "horizontal" or "vertical."
指示向?qū)У姆较虻淖址适薄！八降摹被颉按怪钡摹薄?/p>

default.unit

A character string indicating unit for barwidth and barheight
.一個字符字符串指示單位的barwidth和barheight

reverse

logical. If TRUE the colorbar is reversed. By default, the highest value is on the top and the lowest value is on the bottom
合乎邏輯的仗岸。如果真允耿，colorbar被顛倒了。默認情況下扒怖，最高的值在頂部较锡，最低的值在底部

order

positive integer less that 99 that specifies the order of this guide among multiple guides. This controls the order in which multiple guides are displayed, not the contents of the guide itself. If 0 (default), the order is determined by a secret algorithm.
在多個指南中指定該指南順序的99個正整數(shù)。這將控制顯示多個向?qū)У捻樞虻裂鳎皇窍驅(qū)П旧淼膬?nèi)容蚂蕴。如果0(默認)，順序由一個秘密算法決定俯邓。
... ignored.

Value
A guide object

Details
Guides can be specified in each scale_* or in guides guide="legend" in scale_* is syntactic sugar forguide=guide_legend() (e.g. scale_color_manual(guide = "legend")). As for how to specify the guide for each scale in more detail, ee guides

See also
Other guides: guide_legend, guides

Examples

df <- reshape2::melt(outer(1:4, 1:4), varnames = c("X1", "X2"))
p1 <- ggplot(df, aes(X1, X2)) + geom_tile(aes(fill = value))
p2 <- p1 + geom_point(aes(size = value))
# Basic form
p1 + scale_fill_continuous(guide = "colorbar")

guide_legend

Legend guide

guides

Set guides for each scale

sec_axis dup_axis derive

Specify a secondary axis