R语言:Rprof()函数中文帮助文档(中英文对照)

loveR

Rprof(utils)
Rprof()所属R语言包：utils

                                        Enable Profiling of R's Execution
                                         启用R的执行剖析

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

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

Enable or disable profiling of the execution of R expressions.
启用或禁用的研发表达式执行的分析。


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


Rprof(filename = "Rprof.out", append = FALSE, interval = 0.02,
       memory.profiling=FALSE)



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

参数：filename
The file to be used for recording the profiling results. Set to NULL or "" to disable profiling.  
该文件将用于记录的分析结果。设置NULL或""禁用分析的。


参数：append
logical: should the file be over-written or appended to?  
逻辑：文件应过度书面或追加？


参数：interval
real: time interval between samples.  
真实：样本之间的时间间隔。


参数：memory.profiling
logical: write memory use information to the file?
逻辑：写内存使用信息的文件？


Details

详情----------Details----------

Enabling profiling automatically disables any existing profiling to another or the same file.
启用分析自动禁用任何现有的分析到另一个或相同的文件。

Profiling works by writing out the call stack every interval seconds, to the file specified.  Either the summaryRprof function or the wrapper script R CMD Rprof can be used to process the output file to produce a summary of the usage; use R CMD Rprof --help for usage information.
分析作品写出调用堆栈的每interval秒，到指定的文件。要么summaryRprof功能或包装脚本R CMD Rprof可以用来处理输出文件产生的用法总结;使用R CMD Rprof --help使用情况的信息。

Exactly what the time interval measures is subtle: it is time that the R process is running and executing an R command.  It is not however just CPU time, for if readline() is waiting for input, that counts (on Windows, but not on a Unix-alike).
什么时间间隔的措施是很微妙的：它是时间的R进程正在运行和执行R命令。这不是不过只是CPU时间，如果readline()等待输入，计数（在Windows上，而不是一个Unix相似）。

Note that the timing interval cannot be too small, for the time spent in each profiling step is added to the interval.  What is feasible is machine-dependent, but 10ms seemed as small as advisable on a 1GHz machine.
注意，时间间隔不能太小，在每个分析步骤所花费的时间间隔。什么是可行的，是依赖于机器的，但10ms的似乎只要1GHz的机器上最好的小。

Functions will only be recorded in the profile log if they put a context on the call stack (see sys.calls).  Some primitive functions do not do so: specifically those which are of type "special" (see the "R Internals" manual for more details).
功能将只能在配置日志记录，如果他们把调用堆栈上下文（见sys.calls）。一些原始功能不这样做，特别是那些类型的"special"（见“R内部的详细信息手册）。


注意----------Note----------

filename can be a UTF-8-encoded filepath that cannot be translated to the current locale.
filename可以是UTF-8编码文件路径不能转换为当前的语言环境。


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

The chapter on “Tidying and profiling R code” in “Writing R Extensions” (see the "doc/manual" subdirectory of the R source tree).
章“整理和分析R代码”中的“写R扩展”（见doc/manual的R源代码树的子目录）。

summaryRprof
summaryRprof

tracemem, Rprofmem for other ways to track memory use.
tracemem，Rprofmem其他的方法来跟踪内存使用。


举例----------Examples----------


## Not run: Rprof()[＃不运行：Rprof（）]
## some code to be profiled[一些异形代码＃]
Rprof(NULL)
## some code NOT to be profiled[＃一些代码进行分析]
Rprof(append=TRUE)
## some code to be profiled[一些异形代码＃]
Rprof(NULL)
\dots
## Now post-process the output as described in Details[＃现在处理后输出的详细描述]


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


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