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

loveR

track.setup(trackObjs)
track.setup()所属R语言包：trackObjs

                                        Setup and stop tracking
                                         设置和停止跟踪

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

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

Functions to setup and stop tracking.
功能设置和停止跟踪。


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


track.start(dir, pos = 1, envir = as.environment(pos), create = TRUE,
        clobber = c("no", "files", "variables"), cache=NULL, options=NULL,
        RDataSuffix=NULL)
track.stop(pos = 1, envir = as.environment(pos), all=FALSE, stop.on.error=FALSE)
env.is.tracked(pos = 1, envir = as.environment(pos))
tracked.envs(envirs=search())
track.restart(pos = 1, envir = as.environment(pos), forget.modified = FALSE)



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

参数：dir
The directory where tracking data is stored
跟踪数据存储的目录


参数：pos
The search path position of the environment being tracked (default is 1 for the global environment)
被跟踪的路径中的位置的环境（默认值是1对全球环境）


参数：envir
The environment being tracked.  This is an alternate way (to the use of pos=) of specifying the environment being tracked, but should be rarely needed.
被跟踪的环境。这是一种备选的方式（使用pos=）被跟踪指定的环境，但应很少需要。


参数：create
If TRUE, create the tracking directory if it doesn't exist
如果TRUE，创建跟踪目录，如果它不存在，


参数：clobber
Controls action taken when there are objects of the same name in the tracking directory and in envir: "no" means stop; "files" means use the version from the tracking directory; and "variables" means use the version in envir (and overwrite the version in the tracking directory)
控制时应采取的行动有相同的名称在跟踪目录和对象的envir："no"是指停止，“"files"是指从跟踪目录使用的版本;和"variables"的envir（覆盖跟踪目录中的版本）中使用的版本


参数：cache
Should objects be keep cached in memory?  Default is FALSE.  This option is a shorthand way of supplying options=list(cache=TRUE).
如果对象保持在内存中缓存？默认是FALSE。此选项的简写方式提供options=list(cache=TRUE)。


参数：options
Option values (as a list) to be used for this tracking database.  See track.options().
选项值（作为一个列表）被用于此跟踪数据库。见track.options()。


参数：all
If TRUE, all tracked environment are unlinked
如果TRUE，所有跟踪的环境是未链接


参数：stop.on.error
If FALSE, failures to unlink a tracking environment are ignored, though a warning message is printed
如果FALSE，故障到取消链接跟踪环境的忽视，虽然一个警告消息，


参数：envirs
A list or vector of objects that can be interpreted as environments by as.environment
列表或矢量对象，可以理解为环境，as.environment


参数：forget.modified
If TRUE, discard copies that are modified and in memory
如果TRUE，放弃副本的修改和内存中


参数：RDataSuffix
The suffix to use for RData files.  This should not normally need to be specified.
后缀使用为RData文件。这是不应该，通常需要作出具体规定。


Details

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

  


track.start: start tracking envir.  If the tracking directory already exists, objects in it will be made accessible, otherwise it will be created (unless create=FALSE).
track.start：开始跟踪envir。如果跟踪目录已经存在，在它的对象进行访问，否则将被创建（除非create=FALSE“）。

track.stop: stop tracking envir.  Tracked variables will become unavailable (any unsaved values will be saved to files first.)
track.stop：停止跟踪envir。履带变量将变得不可用（任何未保存的值将被保存到文件第一）。

track.restart: Rescan the tracking dir, so that if anything has changed there, the current variables on file will be used instead of any cached in memory. If we have some modified variables cached in memory but not saved to disk, this function will stop with an error unless forget.modified==TRUE. Variables that have disappeared from the tracking dir will disappear from visibility, and variables added to the tracking dir will become available.   
track.restart：重新扫描跟踪目录，所以，如果有什么已经改变，目前的变量文件将被使用，而不是任何缓存在内存中。如果我们有一些修改的变量在内存中缓存，但不保存到磁盘，此功能将停止错误，除非forget.modified==TRUE。跟踪目录已经消失的变量将会消失知名度，并，跟踪变量添加到目录将成为可用的。


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

<table summary="R valueblock"> <tr valign="top"><td>track.start, track.stop, track.restart:</td> <td> all return invisible(NULL) (this may change if it becomes clear what useful return values would be)</td></tr> <tr valign="top"><td>env.is.tracked:</td> <td> returns TRUE or FALSE</td></tr> <tr valign="top"><td>tracked.envs:</td> <td> with no arguments, it returns the names of tracked environment that are on the search list.  If given an argument that is a vector of environments (or environment names), it returns the subset of that vector that are tracked environments.</td></tr> </table>
<table summary="R valueblock"> <tr valign="top"> <TD> track.start, track.stop, track.restart:</ TD> <TD>所有返回invisible(NULL)（如果它变得清晰，这可能会改变什么有用的回报值会）</ TD> </ TR> <tr valign="top"> <TD> env.is.tracked: </ TD> <TD>返回TRUE或FALSE</ TD > </ TR> <tr valign="top"> <TD> tracked.envs: </ TD> <TD>不带任何参数，则返回跟踪的环境，在搜索列表的名称。如果给定一个参数，它是一个矢量的环境（环境名称），它返回的子集，矢量跟踪环境。</ TD> </ TR> </表>


（作者）----------Author(s)----------


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



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

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


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


library(trackObjs)
unlink("tmp1", recursive=TRUE)
track.start("tmp1")
track(x <- 33)
X <- array(1:24, dim=2:4)
track(X)
track(Y <- list(a=1:3,b=2))
X[2] <- -1
track.summary(time=0, access=1, size=FALSE)
env.is.tracked(pos=1)
env.is.tracked(pos=2)
ls(all=TRUE)
track.stop()
ls(all=TRUE)
track.start("tmp1")
ls(all=TRUE)
track.summary(time=0, access=1, size=FALSE)
track.stop()
unlink("tmp1", recursive=TRUE)

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


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