找回密码
 注册
查看: 464|回复: 0

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

[复制链接]
发表于 2012-10-1 10:39:50 | 显示全部楼层 |阅读模式
tierChart(tis)
tierChart()所属R语言包:tis

                                         Create tier charts
                                         创建层图

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

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

A tier chart plots several years' observations of a series against the times of year in which they were observed.  Useful for seeing seasonal patterns in daily, weekly and irregularly-spaced data.
层图绘制的时代,这一年中他们观察到了一系列针对几年的观察。可看到每日,每周和不规则分布数据的季节性模式。


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


tierChart(x,
          startMonth = latestJanuary(end(x)),
          nMonths = 4,
          nYears = 7,
          offsets = 0,
          padDays = 6,
          pch = "year",
          lty = "solid",
          lwd = 1.5,
          col = 1 + (n.y:1),
          type = "b",
          ylim = NULL,
          outlier.trim = 0,
          noTrimLastYear = TRUE,
          extendHorizontalTicks = TRUE,
          circles.ymd = NULL,
          circles.col = 6,
          circles.inches = 0.1,
          vlines.ymd = NULL,
          vlines.col = 2,
          vlines.lty = 4,
          vlines.lwd = 1.5,
          vlines2.ymd = NULL,
          vlines2.col = 3,
          vlines2.lty = "solid",
          vlines2.lwd = 2,
          hlines = NULL,
          hlines.col = 1,
          hlines.lty = 1,
          hlines.lwd = 1,
          tiPoints.1 = NULL,
          tiPoints.2 = NULL,
          pch.1 = "*",
          pch.2 = "+",
          col.1 = 2,
          col.2 = 3,
          nolegend = FALSE,
          main = deparse(substitute(x)),
          topleft.labels = NULL,
          topright.labels = NULL,
          legend.ncol = length(years),
          legend.bg = 0,
          timestamp = TRUE,
          topline = TRUE,
          vlines.periodEnd = TRUE,
          vlines.month = TRUE,
          midperiod = FALSE,
          lwdLastYear = 1.5,
          cex = 1.5,
          boxes = TRUE,
          ...)

adjustableTierChart(x,
                    ...,
                    edit = TRUE,
                    changes = numeric(0),
                    verbose = FALSE)



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

参数:x
A monhly or higher frequency (such as weekly or daily) time indexed series (a tis object) or something that as.tis can convert to one.  
一个monhly或更高的频率(如每周或每天)时间索引的的系列(tis对象)或as.tis可以转换为1。


参数:startMonth
a monthly time index (ti) object indicating first month to show on plot.   
每月一次指数(ti)表示第一个月的对象上显示图。


参数:nMonths
number of months to show on plot.  
数个月,图上显示。


参数:nYears
number of years to include in the plot.  
数年,包括在图中。


参数:offsets
vector of day offsets for the years in descending order.  If offsets[2] is 3, for example, the points for the second-to-last year will be shifted forward 3 days on the plot. Negative numbers shift points back. If length(offsets) < nYears, zeroes will be appended to offsets to make it nYears long.   
矢量一天的偏移量的降序排列。 ,如果offsets[2]是3,例如,点第二次到去年前移,3天的图。负数的换档点。如果length(offsets) < nYears,零将被追加到offsets,使其nYears长。


参数:padDays
number of extra days to plot before and after the requested months.  
额外的天数来绘制请求的月之前和之后。


参数:pch
plotting symbols to be drawn when plotting points.  If pch is a character string, such as "a1b2", the first year's points will be labeled "a", the second year's with "1", the third with "b", and so on.  Alternatively, pch can be a numeric vector giving the numbers of plotting symbols to use, as detailed in the documentation for lines.  The default string "year" uses the last digit of the year number for each point in that year.  
绘制符号时,要绘制的绘制点。如果PCH是一个字符串,如“A1B2”,第一年的积分将被标记为“A”,第二年的“1”,“B”第三,等等。此外,PCH可以给一个数值向量绘制的符号使用的数量,详细的文档中的lines。默认字符串“年”的使用年数的最后一位数字,在这一年中的每个点。


参数:lty
vector of line types.  The first element is for the first year, the second element for the second year, etc., even if lines are not plotted for all years. Line types will be used cyclically until all years are drawn.   
矢量线的类型。第一个元素是第二个元素的第一年,第二年,等,即使线不绘制的所有年份。线路类型都将被循环使用,直到所有的年份得出。


参数:lwd
number specifying line width  
数字,指定线的宽度


参数:col
vector of colors for the years, specified as numbers or color names.  
这些年来的颜色,矢量指定的数字或颜色名称。


参数:type
character string, telling which type of plot ("p", points; "l", lines; "b", both; "n", none; or "h", high-density) should be done for each year.  The first character of type defines the first year, the second character the second, etc. Characters in type are cycled through; e.g., "pl" alternately plots points and lines.  The default is "b".   
字符串,告诉哪种类型的图("p"点;"l",线,“"b",都,”"n",没有;或"h",高密度)应每年完成。 type的第一个字符定义的第一年,第二个字符,字符type循环通过,例如,"pl"交替图点和线。默认值是“B”。


参数:ylim
ylim is a vector of 2 numbers giving desired y-axis limits.  The actual limits on the plot will be the result of pretty(ylim). If ylim is not set explicitly, the value of outlier.trim is used to calculate it such that the c(outlier.trim, 1 - outlier.trim) quantiles of the plotted points fall within the calculated ylim before it is "prettied".   
ylim是一个向量,2号,给需要的y轴的限制。图的实际限制的结果pretty(ylim)。如果ylim不显式设置,outlier.trimc(outlier.trim, 1 - outlier.trim)绘制的点位数的范围内计算的ylim之前是被用来计算“ ; prettied“。


参数:outlier.trim
see ylim above  
ylim以上


参数:noTrimLastYear
if TRUE (the default), outlier.trim is effectively set to zero for the most recent year, i.e., the y-axis limits will be expanded, if necessary, to insure that all of the points plotted for the most recent year fit on the plot.  
如果TRUE(默认值),outlier.trim有效地为最近一年,即设置为0,y轴的限制将扩大,如果有必要,以确保所有的点绘制最近一年适合的图。


参数:extendHorizontalTicks
if TRUE (the default), extend the horizontal ticks with a dotted line all the        way across the chart.  
如果TRUE(默认值),延长的水平虚线刻度线一路之隔的图。


参数:circles.ymd
draws circles around the plotted points corresponding to these ymd dates. The colors and sizes of the circles are given by circles.col and circles.inches.   
吸引各界周围绘制点对应的这些年 - 月 - 日。给出circles.col和circles.inches颜色和大小的圆圈。


参数:circles.col
see circles.ymd above.  
看到circles.ymd以上。


参数:circles.inches
see circles.ymd above.  
看到circles.ymd以上。


参数:vlines.ymd
numeric vector of yyyymmdd dates, draws vertical lines of type vlines.lty width vlines.lwd and colors vlines.col at the dates given.  
yyyymmdd的日期,数字矢量绘制垂直线类型vlines.lty宽度vlines.lwd和颜色vlines.col日期。


参数:vlines.col
see vlines.ymd above  
vlines.ymd以上


参数:vlines.lty
see vlines.ymd above  
vlines.ymd以上


参数:vlines.lwd
see vlines.ymd above  
vlines.ymd以上


参数:vlines2.ymd
numeric vector of yyyymmdd dates, draws vertical lines of type vlines2.lty width vlines2.lwd and colors vlines2.col at the dates given.   
yyyymmdd的日期,数字矢量绘制垂直线类型vlines2.lty宽度vlines2.lwd和颜色vlines2.col日期。


参数:vlines2.col
see vlines2.ymd above  
vlines2.ymd以上


参数:vlines2.lty
see vlines2.ymd above  
vlines2.ymd以上


参数:vlines2.lwd
see vlines2.ymd above  
vlines2.ymd以上


参数:hlines
numeric vector, draws horizontal lines of type hlines.lty width hlines.lwd and colors hlines.col at the locations given.  
数值向量,绘制水平线的类型hlines.lty宽度hlines.lwd和颜色hlines.col的位置。


参数:hlines.col
see hlines above  
hlines以上


参数:hlines.lty
see hlines above  
hlines以上


参数:hlines.lwd
see hlines above  
hlines以上


参数:tiPoints.1
a ti object specifying dates for which the corresponding points will be marked with the characters in pch.1 in  colors col.1.  
一个ti对象指定日期的相应的积分将被标记的字符pch.1颜色col.1。


参数:pch.1
see tiPoints.1 above  
tiPoints.1以上


参数:col.1
see tiPoints.1 above  
tiPoints.1以上


参数:tiPoints.2
a ti object specifying dates for which the corresponding points will be marked with the characters in pch.2 in  colors col.2.  
一个ti对象指定日期的相应的积分将被标记的字符pch.2颜色col.2。


参数:pch.2
see tiPoints.2 above  
tiPoints.2以上


参数:col.2
see tiPoints.2 above  
tiPoints.2以上


参数:nolegend
if T do not plot a legend  
如果T不绘制一个传说


参数:main
character string giving main title for the chart.  
字符串主标题的图表。


参数:topleft.labels
strings to place in left corner of top margin  
字符串放置在左上角的页边距


参数:topright.labels
strings to place in right corner of top margin  
字符串放置在右上角的页边距


参数:legend.ncol
number of columns to use for legend.  Has no effect if nolegend is T.  
使用传说的列数。没有,如果nolegend是T。


参数:legend.bg
background color for legend  
背景颜色传说


参数:timestamp
if T put a timestamp in upper right corner of top margin  
如果T的时间戳右上角的“页边距


参数:topline
if T (the default) draw an axis line across the top of the plot  
如果T(默认值)绘制轴线的顶部的图


参数:vlines.periodEnd
if T (the default) draw a light vertical line at each period end of the most recent year plotted.  
如果T(默认值)画一条的光垂直线在各期末的最近一年的绘制。


参数:vlines.month
if T (the default) draw a light vertical line at month boundaries  
如果T(默认值),得出光在一个月边界的垂直线


参数:midperiod
if T draw the point for each period on the middle day of the period.  If F (the default) draw points on the last day of the period.  
如果T绘制点上的每个周期的周期中间的一天。如果F(默认值)上画点期间的最后一天。


参数:lwdLastYear
line width for the last year plotted.  
绘制线宽去年。


参数:boxes
if T (the default) add scroll arrow and PrintMe boxes to the plot for use by adjustableTierChart.  
如果T(默认)滚动箭头和PrintMe盒的图使用adjustableTierChart。


参数:cex
numeric character expansion factor for the characters denoting the points on the plot.  
数字字符的字符表示的图点的膨胀系数。


参数:...
for adjustableTierChart, arguments to be passed on to tierChart.  For tierChart, ... denote arguments to be passed to matplot, which does the actual plotting.   
adjustableTierChart,参数被传递给tierChart。对于tierChart,...表示要传递的matplot,它的实际绘图。


参数:edit
if T, the points on the plot are editable. Clicking above or below a point draws an arrow from the point to it desired new location.  
如果T,在图上的点是可编辑的。点击的点的上方或下方,从点到所需的新的位置绘制的箭头。


参数:changes
used internally by the function to remember what points have been moved thus far while scrolling.  This argument should never be set by the user.  
内部使用的功能,记得点迄今已被移动而滚动。这不应该由用户设置的参数。


参数:verbose
if T, adjustableTierChart is chattier about what it is doing.  
如果T,adjustableTierChart是chattier它是什么做的。


Details

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

A tier chart shows seasonal patterns in data by superimposing the data from the same months of several years onto a single plot.  Tier charts can be used both to present a view of a time series and to graphically edit its values by pointing and clicking.
一个层的图表显示数据的季节性模式,通过数年同月的数据叠加到一个单一的图。层的图表都可以使用的时间序列提出一个观点,并以图形化的编辑其价值观的指向和点击。

For most purposes, adjustableTierChart is preferred to tierChart, since the former presents a chart that can be edited, scrolled and printed via mouse clicks, while the latter simply draws a single chart and returns.  However, adjustableTierChart requires user interaction, which may make it unsuitable for some uses.
在大多数情况下,adjustableTierChart最好tierChart,因为前者提供了一个图表,可以编辑,滚动印,通过鼠标点击,而后者仅绘制一个图表及回报。然而,adjustableTierChart需要用户交互,这可能会使它不适合某些用途。

When adjustableTierChart is called, it draws on the current graphics device and then waits for mouse clicks to occur.  A left mouse button click on one of the scroll arrows changes the display to show adjacent months, while a left mouse click on the PrintMe box causes the current plot to be copied to the printer.  Left mouse clicks in the data area of the plot are used to edit the values of the time series.  Arrows are drawn from the current data points to the mouse location to show where the new data values will be.
当adjustableTierChart被调用时,它借鉴了当前的图形设备,然后等待鼠标点击发生。鼠标左键点击滚动箭头之一,改变了显示器显示相邻个月,同时单击鼠标左键的PrintMe框将导致目前的图被复制到打印机。点击鼠标左键用于编辑的值的时间序列的数据区域中的图。拔箭从目前的数据点鼠标的位置显示新的数据值会。

A middle mouse button click causes adjustableTierChart to return.  Closing the graphics window via the windowing system (e.g., clicking on the window's X button) has the same effect. Until adjustableTierChart is told to return, the entire R process will appear to be frozen. It isn't actually frozen, it's just waiting for mouse input. Use tierChart instead if no user interaction is desired.
单击鼠标中键使adjustableTierChart返回。关闭图形窗口,通过窗口系统(例如,点击窗口的X按钮)具有相同的效果。直到adjustableTierChart被告知要返回,整个R过程中会出现被冻结。实际上它不冻结,它只是在等待鼠标输入。使用tierChart,而是如果没有用户交互的需要。


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

tierChart invisibly returns a list with the following components:
tierChart无形地返回一个列表,以下组件:


参数:px
a matrix with nYears columns containing the x coordinates of the points for each year.  
一个矩阵,nYears列包含x坐标为每年之分。


参数:py
a matrix with nYears columns containing the y coordinates of the points for each year.  
矩阵nYears列,其中包含每年的点的Y坐标。


参数:ymd
matrix of yyyymmdd dates corresponding to x coordinates in px  
矩阵YYYYMMDD日期对应的x坐标px


参数:index
matrix giving positions of the elements of the y matrix in the original x series, that is, x[index[i,j]] == y[i,j]  
矩阵发出的原始x系列,即y矩阵的元素的位置中,x [指数[,j]的] ==值Y [i,j]的


参数:lBox
vector of 4 numbers giving the c(left, bottom, right, top) bounds of the scroll arrow box in the upper left corner of the plot.  
向量的4个数字,给C(左,下,右,顶)范围的滚动箭头框左上角的图。


参数:rBox
vector of 4 numbers giving the c(left, bottom, right, top) bounds of the scroll arrow box in the upper right corner of the plot.  
向量的4个数字,给C(左,下,右,顶)范围的滚动箭头框右上角的图。


参数:printBox
vector of 4 numbers giving the c(left, bottom, right, top) bounds of the print box in the adjoining the left scroll box.  
向量的4个数字,给C(左,下,右,顶)打印文件夹在相邻的左滚动框的范围。


参数:startMonth
the input argument of the same name  
输入参数相同的名称


参数:nMonths
number of months wide the plot is  
数个月的广泛的图是


参数:nYears
number of years plotted  
年数绘制

If the input argument codeboxes is F, the lBox, rBox and printBox elements of the list will not be present.
,如果输入参数codeboxes的是F,lBox,rBox和printBox列表中的元素不会存在。

adjustableTierChart returns the edited input series x as a tis object, with an additional startMonth attribute.
adjustableTierChart返回编辑输入系列xtis对象,一个额外的startMonth属性。


副作用----------Side Effects----------

a tier chart is drawn on the current graphics device.
层图上绘制当前图形设备。


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

monthplot for a nice way to look at seaonality in monthly data.
monthplot一个很好的方式月度数据看seaonality中。


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


## Not run: [#不运行:]
tierChart(m1.w)   ## January - April of 7 most recent years[#1月 -  4月7最近几年来]

tierChart(m1.w, startMonth=1, nMonths = 12)  ## Tier chart for entire year[#整整一年的层图]

tierChart(m1.w, type="l", lty=1)   ## same as first example, but with[#作为第一实例相同,但与]
                                   ## solid lines and no plotting symbols[#实线并没有绘制的符号]

xe &lt;- adjustableTierChart(x)    ## xe will be edited version of x[#XE将编辑过的版本的x]

## End(Not run)[#(不执行)]

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


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

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

手机版|小黑屋|生物统计家园 网站价格

GMT+8, 2024-12-1 00:32 , Processed in 0.024321 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表