\usepackage{booktabs}\r
\usepackage{longtable}\r
\usepackage{rotating}\r
+\usepackage{array}\r
\usepackage{tabularx}\r
-\newcommand\code[1]{\texttt{#1}}\r
\newcommand\p{\vspace{2ex}}\r
\setcounter{tocdepth}{2}\r
+%% Define \code \proglang and \pkg commands\r
+\newcommand\code[1]{\texttt{#1}}\r
+\newcommand\pkg[1]{\textbf{#1}}\r
+\newcommand\R{\textsf{R}}\r
+%% url and hyperref\r
+\usepackage[hyphens]{url}\r
+\usepackage{hyperref}\r
\begin{document}\r
\r
-\title{The xtable Gallery}\r
+\title{The \pkg{xtable} Gallery}\r
\author{Jonathan Swinton and others}\r
\maketitle\r
\r
\r
\newpage\r
\r
+\section{Introduction}\r
+\label{sec:introduction}\r
+\r
+This document gives a gallery of tables which can be made using the\r
+\pkg{xtable} package to create \LaTeX\ output. It doubles as a\r
+regression check for the package.\r
+\r
<<include=FALSE>>=\r
library(knitr)\r
opts_chunk$set(fig.path='figdir/fig', debug=TRUE, echo=TRUE)\r
@\r
\r
-\section{Gallery}\r
-\subsection{Data frame}\r
+The first step is to load the package and set an option for this document.\r
<<results='asis'>>=\r
library(xtable)\r
options(xtable.floating = FALSE)\r
+@\r
+\r
+\section{Gallery}\r
+\subsection{Data frame}\r
+<<results='asis'>>=\r
data(tli)\r
xtable(tli[1:10, ])\r
@\r
xtable(design.matrix, digits = 0)\r
@\r
\r
+\newpage\r
\subsection{aov}\r
<<results='asis'>>=\r
fm1 <- aov(tlimth ~ sex + ethnicty + grade + disadvg, data = tli)\r
xtable(fm1)\r
@\r
\r
-\newpage\r
-\r
\subsection{lm}\r
<<results='asis'>>=\r
fm2 <- lm(tlimth ~ sex*ethnicty, data = tli)\r
xtable(anova(fm2b, fm2))\r
@\r
\r
+\newpage\r
\subsection{glm}\r
<<results='asis'>>=\r
fm3 <- glm(disadvg ~ ethnicty*grade, data = tli, family = binomial)\r
xtable(fm3)\r
@\r
\r
-\p\r
+\subsubsection{Analysis of deviance}\r
<<results='asis'>>=\r
xtable(anova(fm3))\r
@\r
temp.table\r
@\r
\r
+\newpage\r
+\r
<<include=FALSE>>=\r
# ## Demonstrate saving to file\r
# for(i in c("latex", "html")) {\r
# }\r
@\r
\r
-\newpage\r
-\r
\section{Helper functions for formatting}\r
The functions \code{xalign}, \code{xdigits}, and \code{xdisplay} are useful for\r
formatting tables in a sensible way. Consider the output produced by the default\r
function(str) gsub("_", "\\_", str, fixed = TRUE))\r
@\r
\r
-\newpage\r
-\r
\subsection{Markup in tables}\r
Markup can be included in tables, including in column and row names, by using\r
a custom \code{sanitize.text.function}.\r
print(mat, sanitize.text.function = function(x) {x})\r
@\r
\r
+\newpage\r
% By David Dahl to demonstrate contribution from David Whitting, 2007-10-09.\r
-\p\r
+\r
You can also have sanitize functions that are specific to column or\r
row names. In the table below, the row name is not sanitized but\r
column names and table elements are.\r
\r
<<results='asis'>>=\r
x <- matrix(rnorm(1000), ncol = 10)\r
-x.big <- xtable(x, caption = 'A \\code{longtable} spanning several pages')\r
-print(x.big, hline.after=c(-1, 0), tabular.environment = 'longtable')\r
+x.big <- xtable(x, caption = "A \\code{longtable} spanning several pages")\r
+print(x.big, hline.after=c(-1, 0), tabular.environment = "longtable")\r
@\r
\r
%% The column name alignment is off in the following example.\r
%% It needs some revision before exposing it. - CR, 7/2/2012\r
%\r
-%\subsubsection{Long tables with the header on each page}\r
-%The \code{add.to.row} argument can be used to display the header\r
-%for a long table on each page, and to add a "continued" footer\r
-%on all pages except the last page.\r
-%\r
-%<<results=tex>>=\r
-%library(xtable)\r
-%x<-matrix(rnorm(1000), ncol = 10)\r
-%addtorow<-list()\r
-%addtorow$pos<-list()\r
-%addtorow$pos[[1]]<-c(0)\r
-%addtorow$command<-c(paste(\r
-% "\\hline \n",\r
-% " \\endhead \n",\r
-% " \\hline \n",\r
-% " {\\footnotesize Continued on next page} \n",\r
-% " \\endfoot \n",\r
-% " \\endlastfoot \n", sep = ""))\r
-%x.big2 <- xtable(x, label = "tabbig2",\r
-% caption = "Example of longtable with the header on each page")\r
-%print(x.big2, tabular.environment = "longtable",\r
-%include.rownames = FALSE, add.to.row = addtorow, hline.after = c(-1))\r
-%@\r
+%% Tried to fix this and got some of the way, but \hlines are wrong\r
+%% and first column is too wide. - DJS 4/10/2014\r
+%% \subsubsection{Long tables with the header on each page}\r
+%% The \code{add.to.row} argument can be used to display the header\r
+%% for a long table on each page, and to add a "continued" footer\r
+%% on all pages except the last page.\r
+\r
+%% \newcommand{\head}[1]{\centercell{\bfseries#1}}\r
+\r
+%% <<results='asis'>>=\r
+%% x <- matrix(rnorm(1000), ncol = 10)\r
+%% hdr <- paste(paste("\\multicolumn{1}{c}{",1:9,"} & ", collapse = ""),\r
+%% "\\multicolumn{1}{c}{10}\\\\")\r
+%% addtorow <- list()\r
+%% addtorow$pos <- list()\r
+%% addtorow$pos[[1]] <- c(0)\r
+%% addtorow$command <- c(paste(\r
+%% hdr,\r
+%% " \\hline \n",\r
+%% " \\endhead \n",\r
+%% " \\hline \n",\r
+%% " {\\footnotesize Continued on next page} \n",\r
+%% " \\endfoot \n",\r
+%% " \\endlastfoot \n", sep = ""))\r
+%% x.big2 <- xtable(x, label = "tabbig2", align = "lrrrrrrrrrr",\r
+%% caption = "Example of longtable with the header on each page")\r
+%% print(x.big2, tabular.environment = "longtable",\r
+%% include.rownames = FALSE, include.colnames = FALSE,\r
+%% add.to.row = addtorow)\r
+%% @\r
+\r
+\newpage\r
+\r
+\subsection{Use of \code{add.to.row} argument}\r
+The following frequency table has outer dimnames: \code{Grade3} and\r
+\code{Grade6}.\r
+\r
+<<>>=\r
+Grade3 <- c("A","B","B","A","B","C","C","D","A","B",\r
+ "C","C","C","D","B","B","D","C","C","D")\r
+Grade6 <- c("A","A","A","B","B","B","B","B","C","C",\r
+ "A","C","C","C","D","D","D","D","D","D")\r
+Cohort <- table(Grade3, Grade6)\r
+Cohort\r
+@\r
+\r
+\p\r
+The default behavior of \code{print.xtable} is to strip outer dimnames.\r
+<<results='asis'>>=\r
+xtable(Cohort)\r
+@\r
+\r
+\p\r
+The desired column labels can be created using \code{add.to.row}, in this case\r
+applying two commands to ``row number zero'' while suppressing the basic column\r
+names.\r
+\r
+<<results='asis'>>=\r
+addtorow <- list()\r
+addtorow$pos <- list(0, 0)\r
+addtorow$command <- c("& \\multicolumn{4}{c}{Grade 6} \\\\\n",\r
+ "Grade 3 & A & B & C & D \\\\\n")\r
+print(xtable(Cohort), add.to.row = addtorow, include.colnames = FALSE)\r
+@\r
\r
\subsection{Sideways tables}\r
Requires \verb|\usepackage{rotating}| in the LaTeX\r
\r
<<results='asis'>>=\r
x <- x[1:30, ]\r
-x.side <- xtable(x, caption = 'A sideways table')\r
-print(x.side, floating = TRUE, floating.environment = 'sidewaystable')\r
+x.side <- xtable(x, caption = "A sideways table")\r
+print(x.side, floating = TRUE, floating.environment = "sidewaystable")\r
@\r
\clearpage\r
\r
print(x.rescale, scalebox = 0.7)\r
@\r
\r
+\newpage\r
+\r
+\subsection{Aligning fixed width columns}\r
+Note that using specifications such as \verb|p{2cm}| always\r
+produces a \textbf{left aligned} column. What if some other alignment\r
+is desired?\r
+\r
+This is not really a problem with \pkg{xtable} but with the formatting\r
+of tables with fixed width columns and different alignments using\r
+standard \LaTeX.\r
+\r
+One solution is to use the \verb|array| package, defining new\r
+column formats.\r
+\r
+\begin{verbatim}\r
+\newcolumntype{L}[1]{>{\raggedright\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{C}[1]{>{\centering\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{R}[1]{>{\raggedleft\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{P}[1]{>{\raggedright\tabularxbackslash}p{#1}}\r
+\end{verbatim}\r
+\r
+These allow for very sophisticated cell formatting, namely\r
+left-aligned, centred, or right-aligned text, with recognition of line\r
+breaks for the first three new column types. If these lines are\r
+included along with \verb|\usepackage{array}|, then the following\r
+is possible.\r
+\r
+\newcolumntype{L}[1]{>{\raggedright\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{C}[1]{>{\centering\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{R}[1]{>{\raggedleft\let\newline\\\r
+ \arraybackslash\hspace{0pt}}m{#1}}\r
+\newcolumntype{P}[1]{>{\raggedright\tabularxbackslash}p{#1}}\r
+\r
+<<results='asis'>>=\r
+df <- data.frame(name = c("A","B"), right = c(1.4, 34.6),\r
+ left = c(1.4, 34.6), text = c("txt1","txt2"))\r
+print(xtable(df, align = c("l", "|c", "|R{3cm}", "|L{3cm}", "| p{3cm}|")),\r
+ floating = FALSE, include.rownames = FALSE)\r
+@\r
+\r
\subsection{Table width}\r
The \code{tabularx} environment is for typesetting tables whose overall width is\r
fixed. The column alignment code \code{X} denotes columns that will be stretched\r
@\r
\r
\section{Acknowledgements}\r
-Most of the examples in this gallery are taken from the \code{xtable}\r
-documentation.\r
+Most of the examples in this gallery are taken from the \pkg{xtable}\r
+documentation. Two examples (\code{add.to.row} and `Aligning fixed width\r
+columns') are from Stack Exchange.\r
\r
-\section{R session information}\r
+\section{\R\ session information}\r
<<results='asis'>>=\r
toLatex(sessionInfo())\r
@\r
projects / xtable.git / blobdiff