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

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

[复制链接]
发表于 2012-10-2 07:26:33 | 显示全部楼层 |阅读模式
first(xts)
first()所属R语言包:xts

                                         Return First or Last n Elements of A Data Object
                                         返回第一个或最后n个元素的一个数据对象

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

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

A generic function to return the first or last elements or rows of a vector or two-dimensional data object.
一个通用的函数返回的第一个或最后一个元素或行向量或二维数据对象。

A more advanced subsetting is available for zoo objects with indexes inheriting from POSIXt or Date classes.
一个更高级的子集是可动物园对象的索引继承从POSIXt“或”日期“类。


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


first(x,...)
last(x,...)

## Default S3 method:[默认方法]
first(x,n=1,keep=FALSE,...)

## Default S3 method:[默认方法]
last(x,n=1,keep=FALSE,...)

## S3 method for class 'xts'
first(x,n=1,keep=FALSE,...)

## S3 method for class 'xts'
last(x,n=1,keep=FALSE,...)



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

参数:x
1 or 2 dimensional data object  
1维或2维的数据对象


参数:n
number of periods to return  
的周期数,以返回


参数:keep
should removed values be kept?  
要删除的值保存?


参数:...
additional args - unused  
- 未使用的额外的参数


Details

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

Provides the ability to identify the first or last n rows or observations of a data set.  The generic method behaves much like head and tail from base, except by default only the first or last observation will be returned.
提供的第一个或最后一个n行或观测的数据集的识别能力。通用的方法的行为很像head和tailbase,除了默认情况下,只有第一个或最后一个观察将返回。

The more useful method for the xts class allows for time based subsetting, given an xtsible object.
更有用的方法的XTS类允许基于时间的子集,给予xtsible对象。

n may be either a numeric value, indicating the number of observations to return - forward from first, or backwards from last, or it may be a character string describing the number and type of periods to return.
n可能是一个数值,表示返回的若干意见 - 向前first,或向后last,或者它可能是一个字符串描述的数量和类型期间返回。

n may be positive or negative, in either numeric or character contexts. When positive it will return the result expected - e.g. last(X,'1 month') will return the last month's data. If negative, all data will be returned except for the last month. It is important to note that this is not the same as calling first(X,'1 month') or first(X,'-1 month'). All 4 variations return different subsets of data and have distinct purposes.
n可以是正的或负的,在任一数字或字符的上下文。当积极的,它会返回预期的结果 - 例如, last(X,'1 month')将返回最后一个月的数据。如果为负,所有数据都将返回的最后一个月除外。重要的是要注意,这是不一样的调用first(X,'1 month')或first(X,'-1 month')。所有4个变化返回不同的数据子集,具有不同的目的。

If n is a character string, it must be of the form "n period.type" or "period.type", where n is a numeric value (defaults to 1 if not provided) describing the number of period.types to move forward (first) or back (last).
如果n是一个字符串,它必须是形式“period.type”或“period.type,这里n是一个数值(默认为1,如果不提供)描述period.types向前移动(第一)或向后(上)。

For example, to return the last 3 weeks of a time oriented zoo object, one could call last(X,'3 weeks'). Valid period.types are: secs, seconds, mins, minutes, hours, days, weeks, months, quarters, and years.
例如,要回到过去的3周的时间面向动物园对象,可以调用“last(X,'3 weeks')。有效的period.types是:秒,秒,分钟,分钟,小时,天,周,月,季,年等。

It is possible to use any frequency specification (secs, mins, days, ...) for the period.type portion of the string, even if the original data is in a higher frequency. This makes it possible to return the last "2 months" of data from an oject that has a daily periodicity.
它可以使用任何频率规范(以秒,分钟,天,...)为period.type的字符串部分,即使原始数据是在一个较高的频率。这使得有可能返回最后2个月从oject具有每日周期性的数据。

It should be noted that it is only possible to extract data with methods equal to or less than the frequency of the original data set. Attempting otherwise will result in error.
应当指出,这仅仅是可能等于或小于原始数据集的频率的方法来提取数据。试图否则将导致错误。

Requesting more data than is in the original data object will produce a warning advising as such, and the object returned will simply be the original data.
要求更多的数据比原始数据中的对象,就这样会产生一个警告,并返回的对象将简单地是原始数据。


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

A subset of elements/rows of the original data.
元素/行的原始数据的一个子集。


(作者)----------Author(s)----------


Jeffrey A. Ryan



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


first(1:100)
last(1:100)

data(LakeHuron)
first(LakeHuron,10)
last(LakeHuron)

x <- xts(1:100, Sys.Date()+1:100)
first(x, 10)
first(x, '1 day')
first(x, '4 days')
first(x, 'month')
last(x, '2 months')
last(x, '6 weeks')

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


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

使用道具 举报

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

本版积分规则

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

GMT+8, 2024-11-24 10:01 , Processed in 0.032331 second(s), 16 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

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