R语言 rworldmap包 mapCountryData()函数中文帮助文档(中英文对照)

loveR

mapCountryData(rworldmap)
mapCountryData()所属R语言包：rworldmap

                                        Map country-level data.
                                         图国家一级的数据。

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Draw a map of country-level data, allowing countries to be coloured, from an object created in joinCountryData2Map().
绘制图的国家一级的数据，从而使国家到彩色，从创建的对象在joinCountryData2Map（）。


用法----------Usage----------


mapCountryData(
                mapToPlot =         ""
              , nameColumnToPlot =  ""
              , numCats =           7
              , xlim =              c(-180,180)
              , ylim =              c(-80,90)
              , mapRegion =         "world"
              , catMethod =         "quantiles"
              , colourPalette =     "heat"
              , addLegend =         TRUE
              , borderCol =         'grey'
              , mapTitle =          'columnName'
              , oceanCol =          NA
              , aspect =            1
              , missingCountryCol = NA
              , add =               FALSE
              , nameColumnToHatch = ""
              )   



参数----------Arguments----------

参数：mapToPlot
a spatial polygons dataframe from joinCountryData2Map() containing country polygons and data, if none specified an internal example data is used  
使用空间的多边形数据框从joinCountryData2Map（），其中包含国家的多边形和数据，如果没有指定一个内部的示例数据


参数：nameColumnToPlot
name of column containing the data you want to plot  
列名包含要绘制的数据


参数：numCats
number of categories to put the data in, may be modified if this number is incompatible with the catMethod chosen
类别中的数据，可能会被修改，如果这个数字是不符合catMethod选择


参数：xlim
map extents c(west,east), can be overidden by mapRegion  
图数据区C区（西部，东部），可以凌驾通过的MapRegion


参数：ylim
map extents c(south,north), can be overidden by mapRegion  
图范围是C（南，北），可以凌驾通过的MapRegion


参数：mapRegion
a country name from getMap()[['NAME']] or 'world','africa','oceania','eurasia','uk' sets map extents, overrides xlim,ylim  
国家名称的GetMap（）[“NAME”或“世界”，“非洲”，“大洋洲”，“欧亚”，“英国将图的程度，覆盖作适当调整，ylim


参数：catMethod
method for categorisation of data "pretty", "fixedWidth", "diverging", "logfixedWidth","quantiles","categorical", or a numeric vector defining breaks  
“漂亮”，“固定宽度”，“分歧”，“logfixedWidth”，“位数”，“分类”，或一个数值向量定义中断的数据进行分类方法


参数：colourPalette
string describing the colour palette to use, choice of:   <ol> "palette" for the current palette   
当前调色板的字符串，用于描述使用的调色板，选择：<OL>的“调色板”

a vector of valid colours, e.g. =c('red','white','blue') or output from RColourBrewer   
一个向量的有效的颜色，例如= C（红，白，蓝）或RColourBrewer输出

one of "heat","diverging","white2Black","black2White","topo","rainbow","terrain","negpos8","negpos9"  </ol>
之一</ OL>


参数：addLegend
whether to add a legend or not  
是否添加图例或


参数：borderCol
the colour for country borders   
国家边界的颜色


参数：mapTitle
title to add to the map, any string or 'columnName' to set it to the name of the data column   
标题添加到图，任何的字符串或COLUMNNAME“的，将其设置为数据列的名称


参数：oceanCol
a colour for the ocean
海洋的颜色


参数：aspect
aspect for the map, defaults to 1, if set to 'variable' uses same method as plot.Spatial in sp  
图方面，默认为1，如果设置为“变量”SP使用相同的方法plot.Spatial


参数：missingCountryCol
a colour for missing countries
缺少国家的颜色


参数：add
whether to add this map on top of an existing map, TRUE/FALSE
是否要添加现有的图，图上TRUE / FALSE


参数：nameColumnToHatch
allows hatching of country fills (e.g. to represent uncertainty) , specify a column containing numeric data , highest values will be solid and lower values will have a decreasing density of hatching , new feature more documentation will be added soon     
允许国家孵化填充（如代表不确定性），指定一个列包含数值数据，最高值是固体，较低的值将有一个孵化密度降低，新的功能更多的文档将增加一


Details

详细信息----------Details----------

Certain catMethod and colourPalette options go well together. e.g. "diverging" and "diverging",  "categorical" and "rainbow"
某些catMethod和colourPalette可以融洽相处。例如“分流”和“分流”，“类别”和“彩虹”

There are two styles of legend available.  If catMethod='categorical' or the packages fields and spam are not installed a simple legend with coloured boxes is created. Otherwise a colour bar legend is created. Finer control can be achieved by addMapLegendBoxes  or addMapLegend repectively.
有两种风格的传奇。如果catMethod =分类或者其包装领域和垃圾邮件的未安装一个简单的传说与彩色框被创建。否则，彩条传说被创建。可以实现更好的控制。addMapLegendBoxes或addMapLegend捣破五个。


值----------Value----------

invisibly returns a list containing the data and main options used for the map,  the list can be passed to addMapLegend or addMapLegendBoxes along with additional options to allow greater flexibility in legend creation.
无形地返回一个列表，其中包含的数据，主要用于图的选项，这个列表可以通过addMapLegend或addMapLegendBoxes传说中的创造额外的选项允许更大的灵活性。


警告----------Warning----------

will generate unhelpful errors in data categorisation if inappropriate  options are chosen, e.g. with catMethoduantiles if numCats too high so that unique breaks cannot be defined.
会产生无用的数据分类中的错误如果选择了不恰当的选项，例如： catMethod：位数如果numCats过高，所以不能被定义，独特的截断。


（作者）----------Author(s)----------


andy south



参见----------See Also----------

classInt, RColorBrewer
classInt，RColorBrewer


实例----------Examples----------


mapCountryData()
data("countryExData",envir=environment(),package="rworldmap")
sPDF <- joinCountryData2Map(countryExData
              , joinCode = "ISO3"
              , nameJoinColumn = "ISO3V10"
              , projection = "none"
              )
mapCountryData( sPDF
              , nameColumnToPlot="BIODIVERSITY"
              )
              
#user defined map colour scheme for categorical data              [分类数据的用户自定义图的配色方案]
mapParams <- mapCountryData(nameColumnToPlot='REGION'
              , catMethod='categorical'
              , addLegend='FALSE'
              , colourPalette=c('white','green','red','yellow','blue','black')
              )
#changing legendText[改变legendText]
mapParams$legendText <- c('antarctic','africa','oceania','americas','s.asia','eurasia')              
do.call( addMapLegendBoxes, c(mapParams,x='bottom',title="Region",horiz=TRUE))

##showing how rworldmap can be used with the classInt and RColorBrewer packages[＃表示如何可用于rworldmap的classInt和RColorBrewer软件包]
library(classInt)
library(RColorBrewer)
#getting example data and joining to a map[获得示例数据，并加入到图]
data("countryExData",envir=environment(),package="rworldmap")
sPDF <- joinCountryData2Map(countryExData,joinCode = "ISO3"
                           ,nameJoinColumn = "ISO3V10")
#getting class intervals using a 'jenks' classification in classInt package[获得类使用“詹克斯”分类中classInt包的时间间隔]
classInt <- classIntervals( sPDF$EPI, n=5, style="jenks")
catMethod = classInt$brks
#getting a colour scheme from the RColorBrewer package[得到的配色方案从RColorBrewer包]
colourPalette <- brewer.pal(5,'RdPu')
#calling mapCountryData with the parameters from classInt and RColorBrewer[调用的参数从classInt和RColorBrewer的mapCountryData]
mapParams <- mapCountryData( sPDF, nameColumnToPlot="EPI", addLegend=FALSE
                           , catMethod = catMethod, colourPalette=colourPalette )
do.call(addMapLegend, c(mapParams
                       ,legendLabels="all"
                       ,legendWidth=0.5
                       ,legendIntervals="data"))

              


转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。