RweaveLatex {utils} | R Documentation |
A driver for Sweave
that translates R code chunks in
LaTeX files.
RweaveLatex()
RweaveLatexSetup(file, syntax, output = NULL, quiet = FALSE,
debug = FALSE, stylepath, ...)
file |
Name of Sweave source file. |
syntax |
An object of class |
output |
Name of output file, default is to remove extension
‘.nw’, ‘.Rnw’ or ‘.Snw’ and to add extension
‘.tex’. Any
directory names in |
quiet |
If |
debug |
If |
stylepath |
See ‘Details’. |
... |
named values for the options listed in ‘Supported Options’. |
The LaTeX file generated needs to contain
\usepackage{Sweave}
, and if this is not present in the
Sweave source file, it is inserted by the RweaveLatex
driver.
If stylepath = TRUE
, a hard-coded path to the file
‘Sweave.sty’ in the R installation is set in place of Sweave
.
The hard-coded path makes the TeX file less portable, but avoids the
problem of installing the current version of ‘Sweave.sty’ to some
place in your TeX input path. However, TeX may not be able to
process the hard-coded path if it contains spaces (as it often will
under Windows) or TeX special characters.
The default in R prior to 2.7.0 was stylepath = TRUE
. It is
now taken from the environment variable
SWEAVE_STYLEPATH_DEFAULT, or is FALSE
it that is unset or
empty. If set, it should be exactly TRUE
or FALSE
: any
other values are taken as FALSE
.
RweaveLatex
supports the following options for code chunks (the values
in parentheses show the default values):
logical (TRUE
). Include S code in the
output file?
logical (FALSE
). When echoing, if
keep.source == TRUE
the original source is copied to the file.
Otherwise, deparsed source is echoed.
logical (TRUE
). If FALSE
, the code chunk is not
evaluated, and hence no text or graphical output produced.
character string (verbatim
).
If verbatim
, the output of S commands is
included in the verbatim-like Soutput environment. If
tex
, the output is taken to be already proper latex markup
and included as is. If hide
then all output is
completely suppressed (but the code executed during the weave).
logical (FALSE
)
If TRUE
, each expression in the
code chunk is wrapped into a print()
statement before evaluation,
such that the values of all expressions become visible.
logical (TRUE
). If TRUE
, visibility of values
emulates an interactive R session: values of assignments are not
printed, values of single objects are printed. If FALSE
,
output comes only from explicit print
or
cat
statements.
logical (FALSE
). If TRUE
, text output is
written to separate files
for each code chunk.
character string (false
). If true
, blank
lines at the beginning and end of output are removed. If
all
, then all blank lines are removed from the output.
logical (TRUE
). If TRUE
generated filenames of
figures and output have a common prefix.
a character string, default is the name of the ‘.Snw’ source file.
logical (TRUE
), indicating whether input
statements for text output and includegraphics statements
for figures should be auto-generated. Use include = FALSE
if
the output should appear in a different place than the code chunk
(by placing the input line manually).
logical (FALSE
), indicating whether the code
chunk produces
graphical output. Note that only one figure per code chunk can be
processed this way.
logical (TRUE
), indicating whether EPS figures should be
generated. Ignored if fig = FALSE
.
logical (TRUE
), indicating whether PDF figures should be
generated. Ignored if fig = FALSE
.
passed to pdf
to set
the version and encoding. Defaults taken fron pdf.options()
.
numeric (6), width of figures in inches.
numeric (6), height of figures in inches.
logical (TRUE
). Expand references to other chunks
so that only R code appears in the output file. If FALSE
, the
chunk reference (e.g. <<chunkname>>
) will appear. The
expand=FALSE
option requires keep.source = TRUE
or it
will have no effect.
logical (FALSE
). Write a concordance file
to link the input line numbers to the output line numbers. This is
an experimental feature; see the source code for the output format,
which is subject to change in future releases.
Friedrich Leisch
Friedrich Leisch: Sweave User Manual, 2008
http://www.stat.uni-muenchen.de/~leisch/Sweave
Sweave
, Rtangle