addMapLegend(rworldmap)
addMapLegend()所属R语言包：rworldmap
Add a legend to a map
添加图例图
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Creates a colour bar legend, showing the range of colours and the values the colours correspond to. Relies heavily on image.plot() from the package fields. For simple use, simply use addLegend=TRUE in a rworldmap map function. Or users can call addMapLegend seperately to fine tune the legend. The user should insure that data, catMethod,numCats and colourPalette match the values used in the plot. The legend is designed to be useful for the variety of classification methods that exist.
创建一个彩条的传说，显示的颜色和颜色对应的值的范围。在很大程度上依赖于从包装领域的image.plot（）。对于使用简单，简单地使用addLegend的“= TRUE在一个rworldmap的图功能。或者用户也可以单独调用addMapLegend微调的传说。的用户应确保的数据，catMethod，numCats和colourPalette，匹配的图中所使用的值。被设计成用于各种分类方法存在的图例。
用法----------Usage----------
addMapLegend(
colourVector=""
,cutVector=""
,legendLabels="limits"
,labelFontSize=1
,legendWidth=1.2
,legendShrink=0.9
,legendMar=3
,horizontal=TRUE
,legendArgs=NULL
,tcl=-.5
,mgp=c(3,1,0)
,sigFigs=4
,digits=3
,legendIntervals='page'
,plottedData=""
,catMethod="pretty"
,colourPalette="heat"
#,missingCountryCol="white"
)
参数----------Arguments----------
参数：cutVector
the categories or breaks used in the map
在图中使用的类别或断裂
参数：colourVector
colours used in the map
在图中使用的颜色
参数：legendLabels
Controls the style of the labels on the legend. Choose "none" for no labels, "limits" for the two end values, and "all" to show all the break values if they fit.
控制上的标签传说的风格。选择“无”，没有标签，“设限”的两个端值，和“所有”，以示他们是否适合所有的中断值。
参数：labelFontSize
Controls font size of the labels. A multiplier, so use 2 to double the size, 0.5 to halve it, etc.
控制字体大小的标签。的乘数，所以使用的规模增加一倍，0.5减半等。
参数：legendWidth
Controls the width of the colour bar.
控制的色条的宽度。
参数：legendShrink
Controls the length of the colour bar. 1 means full width of the plot.
控制长度的彩条。 1指全宽度的图。
参数：legendMar
Moves the legend away from the side of the plot. Measured in character widths.
移动的传说从侧的图。字符宽度测量。
参数：horizontal
If TRUE the legend is horizontal, if FALSE, vertical.
如果为true，传说是水平的，如果为FALSE，垂直。
参数：legendArgs
For producing titles and labels. A list of arguments to be passed to mtext.
对于标题和标签。要传递给多行文字的参数列表。
参数：tcl
Controls the length of the tick marks.Useful when labelFontSize is changed.
控制长度刻度线marks.Useful改变labelFontSize时。
参数：mgp
Numeric vector length 3. The second element controls the distance between labels and the axis. Useful when labelFontSize is changed.
数字矢量长度3。第二元件控制标签和轴之间的距离。有用的改变时labelFontSize。
参数：sigFigs
The number of significant figures for legend labels.
图例标签的数量显着数字。
参数：digits
An argument to the formatting of the labels
参数的标签的格式
参数：legendIntervals
"page" or "data". Controls the division of the colour bar, "page" sets the intervals equal on the page, "data" sets them to be equal in the units of the data.
“页面”或“数据”。控制部门的彩条，“页”设置页面上的间隔，“数据”将他们的数据的单位是平等的。
参数：plottedData
Numeric vector. The data which was plotted
数字矢量。绘制的数据
参数：catMethod
Controls the classification scheme. Usual options of "pretty", "quantiles", "fixedWidth", "logFixedWidth" or a vector of breaks.
控制的分类方案。常用选项的“漂亮”，“位数”，“设置fixedWidth”，的“logFixedWidth”或一个向量的中断。
参数：colourPalette
Controls the colour scheme. Usual options of "palette","heat","topo",...
控制的配色方案。常用选项的“调色板”，“热”，“地形”，...
Details
详细信息----------Details----------
The default legend is a horizontal colour bar, with labels only at the extremes.
默认的传说是一个水平的彩条，只有在极端的标签。
Can use a parameter list returned from mapping functions, e.g. mapCountryData(). mapCountryData(addLegend=TRUE) produces same results as: mapParams <- mapCountryData(addLegend=FALSE) do.call(addMapLegend, mapParams)
可以使用参数列表，返回的映射功能，例如： mapCountryData（）。 mapCountryData（addLegend = TRUE）产生相同的结果：mapParams < - mapCountryData（addLegend = FALSE）do.call（addMapLegend，mapParams）
Using the following allows the modification of the legend : mapParams <- mapCountryData(addLegend=FALSE) do.call(addMapLegend, c(mapParams, legendLabels="all", legendWidth=0.5))
使用下面的允许修改的传说：mapParams < - mapCountryData（addLegend = FALSE）do.call（addMapLegend，C（mapParams，legendLabels =“所有”，legendWidth = 0.5））
值----------Value----------
Adds a legend to a plot.
将一个传奇的图。
注意----------Note----------
Can have the unintentional effect of modifying graphical parameters, e.g. mfcol reverts to mfrow.
能有意外的效果修改图形参数，例如： mfcol，恢复到mfrow。
（作者）----------Author(s)----------
Andy South & Matthew Staines
参见----------See Also----------
mapCountryData, mapGriddedData, image.plot
mapCountryData，mapGriddedData，image.plot
实例----------Examples----------
#Set up the plot so the world map uses the full width.[设置世界图的图，所以使用的全宽。]
mapDevice()
#join eaxmple data to a map [到图中加入eaxmple数据]
data("countryExData",envir=environment())
sPDF <- joinCountryData2Map(countryExData
, joinCode = "ISO3"
, nameJoinColumn = "ISO3V10"
, projection = "none"
)
#map the data with no legend [没有传说中的数据映射]
mapParams <- mapCountryData( sPDF
, nameColumnToPlot="BIODIVERSITY"
, addLegend='FALSE'
)
#add a modified legend using the same initial parameters as mapCountryData [使用相同的初始参数mapCountryData添加修改后的传说]
do.call( addMapLegend, c( mapParams
, legendLabels="all"
, legendWidth=0.5
))
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-29 20:59:31
