sparklines(YaleToolkit)
sparklines()所属R语言包：YaleToolkit
Draws a panel of vertically stacked sparklines
绘制面板的垂直堆叠走势图
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Draws a panel of vertically stacked, aligned sparklines, or time series.
绘制面板垂直堆叠排列走势图，或时间序列。
用法----------Usage----------
sparklines(ss, times = NULL, overlap = FALSE, yscale = NULL,
buffer = unit(0, "lines"), buffer.pars = NULL, IQR = NULL,
ptopts = NULL, yaxis = TRUE, xaxis = "exterior",
labeled.points = NULL, point.labels = NULL,
label.just = c(1.2, 0.5), frame.pars = NULL,
line.pars = gpar(lwd = 1),
outer.margin = unit(c(5, 4, 4, 2), "lines"),
outer.margin.pars = NULL, main = NULL, sub = NULL,
xlab = NULL, ylab = NULL, lcol = NULL, new = TRUE)
参数----------Arguments----------
参数：ss
a data frame whose columns give the time series to be plotted
一个数据框的列的时间序列绘制的
参数：overlap
FALSE for stacked sparklines; TRUE for all plotted on the same y-axis.
FALSE堆叠走势图，“TRUE上绘制相同的Y轴。
参数：times
the times at which to plot the data; if NULL (the default), equal spacing is assumed. All the sparklines must share the same times argument. If unaligned time series must be plotted, multiple calls to sparklines() are required.
时代在绘制数据，如果NULL（默认值），间距相等的假设。所有的迷你必须共享相同的times参数。如果未对齐的时间序列必须绘制，多次调用sparklines()是必需的。
参数：yscale
either a vector of length 2 giving the y-limits for all sparklines, or a list having the same length as the number of columns in ss (each component of which is a 2-vector giving the associated sparkline scales). Defaults to NULL, in which case the scales for each sparkline are set to the sparkline's minimum and maximum values.
无论是矢量长度为2的y-限制可用于所有迷你，或具有相同的长度的列表中的列数作为ss（其中每个组件是一个2 - 矢量给相关联的迷你图尺度）。默认NULL，在这种情况下，每个迷你图的尺度迷你图的最小值和最大值设置为。
参数：buffer
a buffer above the maximum and below the minimum values attained by the sparkline. Defaults to unit(0, 'lines').
以上的缓冲器的最大和低于最低值达到由迷你图。默认为unit(0, 'lines')的。
参数：buffer.pars
a list of graphics parameters describing the buffer area. See Details for more information.
图形参数描述的缓冲区域的列表。见Details更多信息。
参数：IQR
a list of graphics parameters to shade or otherwise delineate the interquartile range of the sparkline. Defaults to NULL, in which case the IQR is not shown. See Details for more information.
一个阴影或以其他方式划定的四分位距的迷你图的图形参数列表。默认为NULL，在这种情况下，IQR未显示。见Details更多信息。
参数：ptopts
a list of graphics parameters describing the points on the sparkline that are plotted and labelled. In particular the first and last or minimum and maximum points are labeled if ptopts\$labels is 'first.last' or 'min.max'.
图形参数的列表描述的迷你图，绘制和标记点。尤其是第一个和最后或最低点和最高点被标记为ptopts\$labels如果是'first.last'或'min.max'。
参数：yaxis
draws a vertical axis if TRUE; defaults to FALSE, in which case no axis is drawn.
如果TRUE默认FALSE，在这种情况下，无轴绘制，绘制一条垂直的轴。
参数：xaxis
'interior' draws horizontal axes inside the plotting frame (for each sparkline); 'exterior' draws the common axis for all the sparklines outside the plotting frame; defaults to FALSE (no axis).
'interior'绘制水平轴的绘图框架内（每个迷你图），“'exterior'绘制的共同轴的绘图框外的所有迷你默认为FALSE（无轴）。
参数：labeled.points
not implemented. See ptopts.
没有实现。见ptopts。
参数：point.labels
not implemented. See ptopts.
没有实现。见ptopts。
参数：label.just
not implemented. See ptopts.
没有实现。见ptopts。
参数：frame.pars
a list of graphics parameters describing the exact area taken up by the plotted sparkline. See Details for more information.
图形参数的确切面积绘制的迷你图的列表。见Details更多信息。
参数：line.pars
a list of graphics parameters describing the sparkline. See Details for more information.
图形参数的列表描述了迷你图。见Details更多信息。
参数：outer.margin
a vector of 4 units (bottom, left, top, right) giving the outer margin sizes in order (around the entire panel of sparklines). Defaults to unit(c(0,0,0,0), 'lines').
的矢量为4个单位（底部，左，上，右），得到的外边缘尺寸，以便（围绕整个面板迷你）。默认为unit(c(0,0,0,0), 'lines')的。
参数：outer.margin.pars
a list of graphics parameters describing the outer margin. See Details for more information.
一个列表的图形参数外缘。见Details更多信息。
参数：main
a main title, above the stack of sparklines.
一个主标题，以上的堆栈迷你。
参数：sub
a character vector the length of length(ss) providing titles for the individual sparklines, printed to the right of the sparklines.
一个字符矢量长度length(ss)提供个别迷你图，打印到右边的迷你的产品。
参数：xlab
a string providing the label for the common x-axis or (probably a useless feature) a character vector the length of length(ss) providing x-axis labels for the individual sparklines.
提供共同的x轴或（可能是一个无用的功能）将一个字符矢量length(ss)提供x-轴个别迷你标签的长度的标签的字符串。
参数：ylab
a character vector the length of length(ss) providing y-axis labels for the individual sparklines.
length(ss)Y轴标签的个人迷你字符向量的长度。
参数：lcol
a vector of colors the same length as the number of columns in ss to color the line. As in base graphics, can be either a vector of strings giving the color names, a numeric vector referring to the current pallette, or the output of functions like hsv or rgb
的颜色相同的长度，在SS的列的数量，颜色线的矢量。在基础的图形，可以是一个矢量给出的颜色名称，参照当前帕莱特一个数值向量，或输出功能，如hsv或rgb的字符串
参数：new
defaults to TRUE, which creates a new, empty page; otherwise adds the sparkline to the existing plot.
默认的TRUE，这将创建一个新的空页;否则的迷你图添加到现有的图。
Details
详细信息----------Details----------
In all the cases where a list of graphics parameters is needed, the valid parameter names are the same as would be valid when passed to gpar in the appropriate call. That is, passing list(fill = 'blue', col = 'red') to margin gives a margin that is blue with a red border; but adding fontface = 'bold' will have no effect, just as it would have no effect in a call to grid.rect.
在所有的情况下，一个图形参数列表是必要的，有效的参数名称是一样的将是有效的传递给gpar：在适当的呼叫。也就是说，通过list(fill = 'blue', col = 'red')margin给出了边缘地带，那是蓝色与红色的边框，但加上fontface = 'bold'不会有任何效果，只是因为它不会产生任何影响，打检测给grid.rect。
注意----------Note----------
We do not support non-aligned time series plots such as ts.plot(airmiles, Nile, nhtemp).
我们不支持，如ts.plot(airmiles, Nile, nhtemp)的不结盟时间序列图。
（作者）----------Author(s)----------
John W. Emerson, Walton Green
参考文献----------References----------
<h3>See Also</h3>
实例----------Examples----------
### sparkline examples[＃＃迷你图的例子]
data(beaver1)
## The default behaviour of sparklines[＃走势图的默认行为]
sparklines(beaver1)
sparklines(beaver1,
outer.margin = unit(c(2,4,4,5), 'lines'),
outer.margin.pars = gpar(fill = 'lightblue'),
buffer = unit(1, "lines"),
frame.pars = gpar(fill = 'lightyellow'),
buffer.pars = gpar(fill = 'lightgreen'),
yaxis = TRUE, xaxis=FALSE,
IQR = gpar(fill = 'grey', col = 'grey'),
main = 'Beaver 1')
data(YaleEnergy)
y <- YaleEnergy[YaleEnergy$name==YaleEnergy$name[2],]
sparklines(y[,c("ELSQFT", "STEAM")], times=y$year+y$month/12,
main="Branford Electric and Steam Consumption")
## Adding a pair of sparklines to an existing plot[＃添加对迷你现有的图]
grid.newpage()
pushViewport(viewport(w = 0.8, h = 0.8))
sparklines(data.frame(x = rnorm(10), y = rnorm(10, mean=5)), new = FALSE)
popViewport()
grid.newpage()
pushViewport(viewport(w = 0.8, h = 0.8))
sparklines(data.frame(x = rnorm(10), y = rnorm(10, mean=2)),
buffer = unit(1, "lines"),
frame.pars = gpar(fill = 'lightyellow'),
yaxis = TRUE, xaxis=FALSE,
IQR = gpar(fill = 'grey', col = 'grey'), new = FALSE)
popViewport()
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-10-2 07:31:54
