getPlotRegionNodes(SVGAnnotation)
getPlotRegionNodes()所属R语言包：SVGAnnotation
Get the nodes within an SVG document which contain different sub-components
获取SVG文档内的节点，其中包含不同的子组件
译者：生物统计家园网 机器人LoveR
描述----------Description----------
getPlotRegionNodes gets the XML/SVG nodes within the document which house the contents of the data regions of the sub-plots within the R graphic. This works for traditional and lattice plots, and also for histograms and boxplots.
getPlotRegionNodes得到房子子图内的R图形数据区域的内容在文档的XML / SVG的节点。此作品为传统和晶格图，也可用于直方图和盒形图。
getStripNodes gets the nodes in a lattice plot that represent the strips above each panel. Currently doesn't do anything!
getStripNodes得到的节点表示上述每个小组的带格子图。目前没有做任何事情！
getPlotPoints is intended to get the elements in the SVG document that correspond to regular data points in the data region of the plots/sub-plots.
getPlotPoints是为了获取SVG文档中的元素，符合常规的数据，在数据区域的图/分图点。
用法----------Usage----------
getPlotRegionNodes(doc, lattice = FALSE,
hasAnnotations = lattice, addTypes = TRUE,
isRegion = isPlotRegionNew, ...)
getTextPoints(doc, ...)
getPlotPoints(doc, simplify = TRUE, addTypes = TRUE, ...)
参数----------Arguments----------
参数：doc
the parsed SVG document
解析SVG文件
参数：lattice
a logical value indicating whether the plot is a trellis/lattice plot.
一个逻辑值，指示是否该图是一个网格/格图。
参数：hasAnnotations
whether to use a heuristic which will recognize/permit the presence of additional R-level elements (e.g. text, lines) annotations within the plot region children.
是否使用启发式识别/允许存在额外的R级元素（如文字，线条）内积区域儿童的注释。
参数：...
any additional parameters
任何额外的参数
参数：simplify
a logical value. If this is TRUE, then if the SVG document only contains a single plot region, the points in that plot region are returned as a list. However, if this is FALSE, then the return value is a list with as many elements as there are plot regions in the SVG document. Each element is a list of the SVG nodes corresponding to those points. So, in short, TRUE is useful for interactive use as it strips away the outer list that contains a single point. But for programmatic use, when we don't know how many plot regions there are, it is best to get back a the structured list.
一个逻辑值。如果这是TRUE，那么SVG文件只包含一个单一的图区域，在该小区区域点作为一个列表返回。但是，如果这是FALSE，则返回值是一个有SVG文档中的图区域的许多元素的列表。每个元素是这些点对应的SVG节点列表。因此，在短，TRUE是交互使用的有用，因为它除掉外层的列表，其中包含一个点。但为纲领性使用，当我们不知道有多少图区域，它是最好的结构性列表。
参数：addTypes
a logical value which if TRUE causes the function to add a type attribute to the SVG elements it returns that identifies the high-level nature or type of the node, e.g. 'plot-point', 'plot-region', 'strip', ...
一个逻辑值，如果TRUE导致功能添加type属性，SVG元素，它返回，确定了高层次的性质或类型的节点，例如“积点”，“图区域，”带“，...
参数：isRegion
the function that is used to determing if a <g> element is an actual plotting region.
功能所使用的决定，如果一个<g>元素是一个实际的绘图区域。
值----------Value----------
getPlotRegionNodes returns a list of the group (g) nodes which have only path children and discards those that are the entire device region.
getPlotRegionNodes返回组（G组）节点有唯一途径儿童并丢弃那些是整个设备的区域名单。
getStripNodes returns a list of nodes.
getStripNodes返回一个节点列表。
作者（S）----------Author(s)----------
Duncan Temple Lang
参见----------See Also----------
svgPlot
svgPlot
举例----------Examples----------
doc = svgPlot({
par(mfrow = c(3, 1))
plot(mpg ~ wt, mtcars)
hist(mtcars$mpg)
plot(mpg ~ disp, mtcars)
})
plots = getPlotRegionNodes(doc)
length(plots)
doc = svgPlot(pairs(mtcars))
rr = getPlotRegionNodes(doc)
length(rr)
sapply(rr, xmlSize)
# Using layout() with 2 plots and the second as an inset in the first.[使用布局（）2图和一个嵌在第一第二。]
doc = svgPlot({
layout(matrix(c(1, 1, 1, 1, 1, 1, 1, 2, 1, 1, 1, 1), 3, ))
plot(1:100)
plot(10:1)
})
rr = getPlotRegionNodes(doc)
length(rr)
sapply(rr, xmlSize)
library(lattice)
pp = svgPlot(xyplot( mpg ~ wt | am + cyl, mtcars, group = carb,
auto.key = list(columns = 4, space ="right")))
# Note that the order of the plot regions is different from that in[注意，图区域的顺序是从那个不同]
# the lattice/trellis object $panel.args[点阵/网格对象$ panel.args]
a = getPlotRegionNodes(pp)
lapply(a, getPlotPoints)
getPlotPoints(pp)
nodes = getLatticeLegendNodes(pp)
sapply(nodes, xmlGetAttr, "type")
# Draw a series of line segments. Note that this only appears as a[绘制了一系列线段。请注意，这只是作为一个出现]
# single observation.[单观察。]
dd = svgPlot(plot(1:10, type = "l"))
rr = getPlotRegionNodes(dd)
xmlSApply(rr[[1]], guessSVGShape)
# Here we draw both lines and the points.[在这里，我们得出两条线和点。]
# We end up with 10 points and 10 lines all inside the same <g>[我们结束了10分和10条线内的所有相同<G>]
dd = svgPlot(plot(1:10, type = "b"))
rr = getPlotRegionNodes(dd)
xmlSize(rr[[1]])
xmlSApply(rr[[1]], guessSVGShape)
# Here we draw both lines and the points but separately.[在这里，我们画线和点，但分开。]
# We end up with 2 "plotting regions", i.e. <g> nodes and the lines[我们结束了2“绘图区”，即<G>节点和线路]
# are in the second one.[在第二个。]
# This plot is slightly different with the lines running through the points.[此图是通过点运行线路略有不同。]
dd = svgPlot({ plot(1:10)
lines(1:10, 1:10)
})
rr = getPlotRegionNodes(dd)
length(rr)
xmlSize(rr[[1]])
xmlSize(rr[[2]])
isInside(rr[[2]], rr[[1]])
xmlSApply(rr[[2]], guessSVGShape)
# a Polyline.[折线。]
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-2-22 20:55:16
