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

R语言 trackObjs包 track.rebuild()函数中文帮助文档(中英文对照)

[复制链接]
发表于 2012-10-1 11:17:59 | 显示全部楼层 |阅读模式
track.rebuild(trackObjs)
track.rebuild()所属R语言包:trackObjs

                                        Rebuild database information for tracked objects
                                         重建跟踪对象的数据库信息

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

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

Rebuild database information (the file map, and/or the object summary) for objects in an active tracking environment, or for saved objects in a tracking directory.
重新生成的数据库信息(文件图,和/或对象摘要)为主动跟踪环境中的对象,或者用于跟踪目录中保存的对象。


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


track.rebuild(pos = 1, envir = as.environment(pos), dir = NULL,
        fix = FALSE, level=c("missing", "all"), trust=c("unspecified", "environment", "db"),
        verbose=1, RDataSuffix=NULL, dry.run=TRUE, replace.wd=TRUE,
        use.file.times=TRUE)



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

参数:pos
The position of the environment to which the tracking database to rebuild is linked (for active tracking databases.
的位置的环境,重建跟踪数据库连接(主动跟踪数据库。


参数:envir
The tracked environment for which to rebuild the tracking database (for active tracking databases.
被监视的环境重建的跟踪数据库(主动跟踪数据库。


参数:dir
The directory where the tracking database is stored (for tracking databases not currently active.
跟踪数据库中存储的目录(用于跟踪当前未处于活动状态的数据库。


参数:fix
If TRUE, try to fix various problems such as illegal file names by renaming files or moving unusable RData files to a 'quarantine' directory.  If fix=TRUE and dry.run=TRUE, changes will be reported but not made.  
如果TRUE,尝试解决各种问题,如非法文件名,文件名或不可用的的RDATA文件到“隔离”目录。如果fix=TRUE和dry.run=TRUE,更改将被报道,但没有作出。


参数:level
If "missing", rebuild only missing information, if "all", rebuild information for all objects.
如果"missing",重建丢失的信息,如果"all"。,重建所有对象的信息。


参数:trust
When rebuilding an active tracking database, and there are conflicts between the data in the environment versus that in files, which should be trusted?
重建积极跟踪数据库,当环境中的数据之间存在冲突,相对于在文件中,这应该是值得信赖的呢?


参数:verbose
Controls number of messages about progress
控制方面的进展的消息的数量


参数:RDataSuffix
What suffix should be used for RData files? (Usually worked out automatically.)
RDATA文件应该使用什么样的后缀? (一般自动退出。)


参数:dry.run
If TRUE, no data objects in R or files on disk are changed: the return value is a list containing the rebuilt file map and the rebuilt object summary.  If FALSE, objects in R environments and files on disk can be changed.  The default is TRUE to guard against changing things when it would have been better not to have changed things, but this default may change in future.
如果TRUE,没有R或磁盘上的文件中的数据对象的改变:返回值是一个列表,其中包含重建的文件映射和重建的对象总结。如果FALSE,在R的环境和磁盘上的文件的对象是可以改变的。默认为TRUE防范改变的事情时,那将是最好不要有改变的话,但将来可能会改变这个默认。


参数:replace.wd
If TRUE, file paths in diagnostic output are printed starting with "./" where possible – this makes comparisons of test output more portable.
如果TRUE,诊断输出的文件路径印刷开始“/”在可能的情况下 - 这使得比较测试输出更便于携带。


参数:use.file.times
If TRUE, file creation, modification and access times are used for objects that were not found in existing summary objects.  If FALSE, the current time is used, which can be useful for testing purposes.
如果TRUE,文件的创建,修改和访问时间,并没有发现在现有摘要对象的对象。如果FALSE,当前的时间,这可能是有用的用于测试目的。


Details

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

The file map and/or the object summary are rebuilt.  If level=="all", all RData files will be read, which could take a long time if there are many files.  If level=="missing", RData files will be read only where there is missing information.
的文件的图和/或对象摘要被重建。如果level=="all",所有的的RDATA文件将被读取,这可能需要很长的时间,如果有很多文件。如果level=="missing",RDATA文件将只读哪里有丢失的信息。

If there are incompatible RData files in the directory (e.g., illegal or duplicated object names, or multiple objects), track.rebuild will stop with an error unless fix==TRUE, in which case the incompatible RData files will either be renamed or moved to a quarantine subdirectory.  In the case of duplicated object names, the second object encountered will be moved.
如果有不兼容的的RDATA文件的目录(例如,非法的或复制的对象的名称,或多个对象),track.rebuild将停止除非fix==TRUE,在这种情况下,不兼容的RDATA文件是一个错误重命名或移动到quarantine子目录。在重复的对象的名称的情况下,所遇到的第二个目的将被移动。


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

The value returned is a list with between two and four components: <table summary="R valueblock"> <tr valign="top"><td>fileMap</td> <td> The mapping from object names to files (excluding the suffix)</td></tr> <tr valign="top"><td>summary</td> <td> The dataframe that summarizes objects</td></tr> <tr valign="top"><td>unsaved</td> <td> (optional) The names of variables that are not saved to disk.  This component is only present if it is non-empty.</td></tr> <tr valign="top"><td>masked</td> <td> (optinal) The names of tracked variables that are masked by other variables in the tracked environment. This component is only present if it is non-empty.</td></tr> </table> The returned value is visible if dry.run=TRUE and invisible otherwise.
返回的值是一个两到四个组成部分:<table summary="R valueblock"> <tr valign="top"> <TD>fileMap </ TD> <TD>的映射对象的名称文件(不包括后缀)</ TD> </ TR> <tr valign="top"> <TD>summary </ TD> <TD>,总结对象的数据框</ TD> </ TR > <tr valign="top"> <TD> unsaved </ TD> <TD>变量,不保存到磁盘的名称(可选)。该组件是目前唯一的,如果它不为空。</ TD> </ TR> <tr valign="top"> <TD>masked </ TD> <TD>(optinal)的名称的跟踪被屏蔽的跟踪的环境中的其他变量的变量。如果该组件是目前唯一非空。</ TD> </ TR> </表>返回的值是可见的,如果dry.run=TRUE和无形的,否则。


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


Tony Plate &lt;tplate@acm.org&gt;



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

Overview and design of the trackObjs package.
trackObjs包的概述和设计。


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


# Rebuild a damaged tracking database[重建受损的跟踪资料库]
library(trackObjs)
unlink("tmp1", recursive=TRUE)
# build a tracking dir populated with some variables[建立一个跟踪目录填充的一些变量]
track.start("tmp1")
track(x <- 33)
track(X <- array(1:24, dim=2:4))
track(Y <- list(a=1:3,b=2))
X[2] <- -1
track(abc <- "def")
track(def <- list(1,2,3))
invisible(Y); invisible(abc); invisible(abc); invisible(abc)
track.summary()
track.stop()
# damage the database (remove the filemap)[损坏数据库(删除filemap)]
unlink("tmp1/filemap.txt")
# and rebuild[和重建]
track.rebuild(dir="tmp1", verbose=2, dry.run=FALSE, fix=TRUE)
track.start("tmp1")
track.summary()
track.status()
track.stop()
unlink("tmp1", recursive=TRUE)

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


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

使用道具 举报

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

本版积分规则

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

GMT+8, 2024-11-30 12:52 , Processed in 0.023205 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

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