Sweave and LaTeX

Introduction and Helpful Templates:

• An introductory lecture to 'Reproducible Research with R, LaTeX, & Sweave' can be found here
• An extended example of a Sweave source file (extended.example.nw) and its output (extended.example.pdf)
• An extended example of the LaTeX "preamble" to use in your .nw file: Sweave.Template.nw
• The Sweave Manual and example .nw Sweave files used in the Sweave manual can be found here.
• Not So Short Intro to LaTeX can be found here.
• A template in which everyone can edit their latest ideas
• Template for Presentations and Handouts using LaTeX, Beamer, and a PDF Viewer
• How to run Sweave from within Emacs
• Customizing Sweave
• Charles Geyer's excellent page on Sweave

Some Helpful Tips:

1. You need to add a blank line (with no extra spaces) after the \end{document} expression if you get the following error from Sweave:
   Warning message:
incomplete final line found by readLines on `blah.nw'
2. Commenting in your .nw file:
   • Use % (percent) signs (the LaTeX comment symbol) to comment out lines of text and whole R code chunks (i.e., from the <<>>= to the @ headers).
   • Use # (number) signs (the R comment symbol) to comment out lines of R code within an R code chunk (i.e., between the <<>>= to the @ headers).
3. To run Sweave as a batch process outside of R (i.e., from a konsole command prompt), run this command: R CMD Sweave foo.Rnw , replacing .Rnw with .nw or whatever you use for the file suffix. You may want to run this command after R finishes if you have set up to use a directory graphics and forgot to tell Sweave not to create .eps files when you are using pdflatex : rm -f Rplots.ps graphics/*.eps
4. Converting Sweave files (Frank's 7/26/06 email):
   • Some of you have needed to give reports created using Sweave to collaborators so they can extract tables and other components into a manuscript. The best approach I've found is to use tth to convert from LaTeX to html. The resulting file can be opened in Word or viewed with a web browser, as long as all the graphics files are available. The following twiki page shows how to do this in linux (click here). You can also view the output in a browser such as konqueror and copy and paste it into an OpenOffice document and save in a variety of formats including Word.
5. See the following pdf file to learn how to incorporate the proper R citation into your Sweave documents.
   • The raw .nw file used to create the linked pdf file: RCitation.nw
   • The needed .bib file to create and reference: Rbiblioref.bib
6. The following code in an example of how to use an upData() function invocation to generate a long variable label that will automatically wrap in the LaTeX version of a summary.formula() (with reverse = TRUE) table. The strwrap() function width= argument will dictate how wide the label is.

x <- data.frame(var1 = sample(1:100, size = 250, replace = TRUE),
   group = sample(c("A", "B"), size = 250, replace = TRUE))
x <- upData(x,
  labels = c(var1 = paste(strwrap(paste("This is an extremely long and descriptive",
     "variable label that would normally run off the page.",
      "Our goal is to break this variable label over multiple lines so we won't have to",
      "truncate the variable label in any way."), width = 60), collapse = "\\\\")))
latex(summary(group ~ var1, method = "reverse", data = x, overall = TRUE,
   file = "", landscape = TRUE))