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

loveR

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

                                        Automatic Generation of Reports
                                         自动生成报告

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

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

Sweave provides a flexible framework for mixing text and R/S code for automatic report generation.  The basic idea is to replace the code with its output, such that the final document only contains the text and the output of the statistical analysis: however, the source code can also be included.
Sweave混合文本和R / S分析报告的自动生成代码提供了一个灵活的框架。其基本思路是，以取代其输出的代码，这样最后文件只包含文本和统计分析的输出：然而，源代码也可以包括。


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


Sweave(file, driver = RweaveLatex(),
       syntax = getOption("SweaveSyntax"), encoding = "", ...)

Stangle(file, driver = Rtangle(),
        syntax = getOption("SweaveSyntax"), encoding = "", ...)



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

参数：file
Path to Sweave source file.  Note that this can be supplied without the extension, but the function will only proceed if there is exactly one Sweave file in the directory whose basename matches file.  
Sweave源文件的路径。请注意，这可以提供不带扩展名，但如果有一个目录中的基本名匹配fileSweave文件，函数将只进行。


参数：driver
The actual workhorse, see "Details".
实际的主力，看到“详细资料”。


参数：syntax
NULL or an object of class SweaveSyntax or a character string with its name. See the section "Syntax Definition".
NULL类SweaveSyntax或与它的名字的字符串对象。见节的语法定义“。


参数：encoding
The default encoding to assume for file.
承担file默认编码。


参数：...
Further arguments passed to the driver's setup function: see section "Drivers", RweaveLatex and Rtangle.
进一步传递给驱动程序的设置功能参数：见节司机，RweaveLatex和Rtangle。


Details

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

Automatic generation of reports by mixing word processing markup (like latex) and S code.  The S code gets replaced by its output (text or graphs) in the final markup file.  This allows a report to be re-generated if the input data change and documents the code to reproduce the analysis in the same file that also produces the report.
混合字处理标记（如乳胶）和S代码自动生成报告。 S代码被替换其输出在最后的标记文件（文本或图形）。这使得重新生成一份报告，如果输入数据的变化和文件的代码重现也产生报告分析认为，在同一个文件。

Sweave combines the documentation and code chunks together (or their output) into a single document.  Stangle extracts only the code from the Sweave file creating an S source file that can be run using source.  (Code inside \Sexpr{} statements is ignored by Stangle.)
Sweave结合成一个单一的文件，文档和代码块（或他们的输出）。 Stangle提取只从Sweave文件的代码创建一个S源文件，可以使用source运行。 （里面\Sexpr{}报表的代码将被忽略Stangle）。

Stangle is just a wrapper to Sweave specifying a different default driver.  Alternative drivers can be used: the CRAN package cacheSweave and the Bioconductor package weaver both provide drivers based on the default driver RweaveLatex which incorporate ideas of caching the results of computations on code chunks.
Stangle仅仅是一个包装Sweave指定一个不同的默认驱动程序中。可用于替代司机：CRAN的包cacheSweave和Bioconductor包weaver基于默认的驱动程序都提供司机RweaveLatex其中包括代码块缓存计算结果的想法。

Environment variable SWEAVE_OPTIONS can be used to override the initial options set by the driver: it should be a comma-separated set of key=value items, as would be used in a \SweaveOpts statement in a document.
环境变量SWEAVE_OPTIONS可用于覆盖由驱动程序设置的初步方案：它应该是一个逗号分隔key=value项目设置，将使用在一份声明\SweaveOpts文件。

Non-ASCII source files should contain a line of the form
非ASCII源文件应该包含一个行的形式


语法定义----------Syntax Definition----------

Sweave allows a flexible syntax framework for marking documentation and text chunks. The default is a noweb-style syntax, as alternative a latex-style syntax can be used.  (See the user manual for further details.)
sweave允许灵活的语法框架，用于标记文档和文本块。默认是noweb风格的语法，可以用来作为替代乳胶风格的语法。 （进一步的细节，请参阅用户手册）。

If syntax = NULL (the default) then the available syntax objects are consulted in turn, and selected if their extension component matches (as a regexp) the file name.  Objects SweaveSyntaxNoweb (with extension = "\\.[rsRS]nw$") and SweaveSyntaxLatex (with extension = "\\.[rsRS]tex$") are supplied, but users or packages can supply others with names matching the pattern SweaveSyntax.*.
如果syntax = NULL（默认），那么可用的语法对象的意见反过来，如果他们的extension组件匹配（正则表达式）的文件名选择。对象SweaveSyntaxNoweb（与extension = "\\.[rsRS]nw$"）SweaveSyntaxLatex（用extension = "\\.[rsRS]tex$"）提供，但用户或包可以提供其他名称匹配模式SweaveSyntax.*。


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



Friedrich Leisch and R-core.




参考文献----------References----------

Dynamic generation of statistical reports using literate data analysis. In W. H鋜dle and B. R鰊z, editors, Compstat 2002 - Proceedings in Computational Statistics, pages 575–580. Physika Verlag, Heidelberg, Germany, ISBN 3-7908-1517-9.

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

"Sweave User Manual", a vignette in the utils package.
“Sweave用户手册”，utils包中的小插曲。

RweaveLatex, Rtangle.
RweaveLatex，Rtangle。

Packages cacheSweave, weaver (Bioconductor) and SweaveListingUtils.
软件包cacheSweave，weaver（Bioconductor）和SweaveListingUtils。

Further Sweave drivers are in, for example, packages R2HTML, ascii, odfWeave and pgfSweave.
进一步Sweave驱动程序，例如，包R2HTML，ascii，odfWeave和pgfSweave。


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


testfile <- system.file("Sweave", "Sweave-test-1.Rnw", package = "utils")

## enforce par(ask=FALSE)[＃执行标准杆（问= FALSE）]
options(device.ask.default=FALSE)

## create a LaTeX file[＃创建一个LaTeX文件]
Sweave(testfile)

## This can be compiled to PDF by[＃这可以被编译成PDF]
## tools::texi2pdf("Sweave-test-1.tex")[＃工具:: texi2pdf（“Sweave测试1.tex的”）]
## or outside R by[＃R的外]
## Rcmd texify --pdf Sweave-test-1.tex[＃RCMD texify  -  PDF Sweave测试1.tex]
## if MiKTeX is available.[＃如果MiKTeX是可用的。]

## create an R source file from the code chunks[＃从代码块创建一个R源文件]
Stangle(testfile)
## which can be sourced, e.g.[＃可源，例如]
source("Sweave-test-1.R")



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


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