ps.latex: PostScript/PDF Preview Device with Optional 'LaTeX' Touch

In sfsmisc: Utilities from 'Seminar fuer Statistik' ETH Zurich

PostScript/PDF Preview Device with Optional ‘LaTeX’ Touch

Description

All functions start a pseudo PostScript or Acrobat preview device, using postscript or pdf, and further registering the file name for subsequent calls to pdf.end() or ps.end().

Usage

pdf.do(file, paper = "default", width = -1, height = -1, onefile = FALSE,
       title = NULL, version = "1.4", quiet = FALSE, ...)

pdf.latex(file, height = 5 + main.space * 1.25,  width = 9.5,
          main.space=FALSE, lab.space = main.space,
          paper = "special", title = NULL,
          lab=c(10, 10, 7), mgp.lab=c(1.6, 0.7, 0), mar=c(4, 4, 0.9, 1.1), ...)

ps.do(file, width=-1, height=-1, onefile=FALSE, horizontal=FALSE,
      title = NULL, ...)

ps.latex(file, height = 5 + main.space * 1.25,  width = 9.5,
         main.space=FALSE, lab.space = main.space,
         paper = "special", title = NULL,
         lab=c(10, 10, 7), mgp.lab=c(1.6, 0.7, 0), mar=c(4, 4, 0.9, 1.1), ...)

Arguments

file	character giving the PostScript/PDF file name to be written.
height	device height in inches, height * 2.54 are cm. The default is 5 plus 1.25 iff main.space.
width	device width in inches; for this and height, see postscript.
onefile, horizontal	logicals passed to postscript(..) or pdf(..), most probably to be left alone.
title	PostScript/PDF (not plot!) title passed to postscript() or pdf(); by default use a title with R version and file in it.
version	a string describing the PDF version that will be required to view the output, see pdf; our (high) default ensures alpha-transparency.
quiet	logical specifying that some (informative/warning) messages should not be issued.
main.space	logical; if true, leave space for a main title (unusual for LaTeX figures!).
lab.space	logical; if true, leave space for x- and y- labels (by not subtracting from mar).
paper	character (or missing), typically "a4" or "a4r" in non-America, see postscript. Only if this is "special" (or missing) are your choices of width and height completely honored (and this may lead to files that cannot print on A4) with resizing.
lab	integer of length 3, lab[1:2] are desired number of tick marks on x- and y- axis, see par(lab=).
mgp.lab	three decreasing numbers determining space for axis labeling, see par(mgp=), the default is here smaller than usual.
mar	four numbers, indicating marginal space, see par(mar=), the default is here smaller than usual.
...	arguments passed to ps.do() or pdf.do() from ps.latex / pdf.latex and to ps.options from ps.do/pdf.do.

Details

ps.latex and pdf.latex have an additional LaTeX flavor, and just differ by some extra par settings from the *.do siblings: E.g., after ps.do(..) is called, the graphical parameters c("mar", "mgp", "lab") are reset (to values that typically are better than the defaults for LaTeX figures).

Whereas the defaults for paper, width, and height differ between pdf and postscript, they are set such as to provide very similar functionality, for the functions ps.do() and pdf.do(); e.g., by default, both use a full plot on portrait-oriented page of the default paper, as per getOption("papersize").
pdf.do() sets the default paper to "special" when both width and height are specified.

Value

A list with components

old.par	containing the old par values
new.par	containing the newly set par values

Author(s)

Martin Maechler

See Also

ps.end, pdf, postscript, dev.print.

Examples

if(interactive()) {

 ps.latex("ps.latex-ex.ps", main= TRUE)
  data(sunspots)
  plot(sunspots,main=paste("Sunspots Data, n=",length(sunspots)),col="red")
 ps.end()

 pdf.latex("pdf.latex-ex.pdf", main= TRUE)
  data(sunspots)
  plot(sunspots,main=paste("Sunspots Data, n=",length(sunspots)),col="red")
 pdf.end()

 ps.do("ps_do_ex.ps")
   example(plot.function)
 ps.end()

 pdf.do("pdf_do_ex.pdf", width=12, height=5)
   plot(sunspots, main="Monthly Sunspot numbers (in Zurich, then Tokyo)")
 pdf.end()
}

sfsmisc documentation built on Sept. 11, 2024, 6:53 p.m.