diff --git a/404.html b/404.html
index bccedd3..59c6f70 100644
--- a/404.html
+++ b/404.html
@@ -24,7 +24,7 @@
     
     <a class="navbar-brand me-2" href="https://dmurdoch.github.io/tables/index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/HTML.html b/articles/HTML.html
index 6454847..36740e1 100644
--- a/articles/HTML.html
+++ b/articles/HTML.html
@@ -26,7 +26,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -575,12 +575,12 @@ <h2 id="fine-tuning">Fine tuning<a class="anchor" aria-label="anchor" href="#fin
 <span><span class="st">&lt;/style&gt;"</span>, doCSS <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span>
 <span><span class="va">tab</span></span></code></pre></div>
 <style>
-#table19ab508dce1b .center { 
+#table195b9ae2a49 .center { 
   text-align:center;
   background-color: aliceblue;
 }
 </style>
-<table id="table19ab508dce1b" class="table Rtable">
+<table id="table195b9ae2a49" class="table Rtable">
 <thead>
 <tr class="center">
 <th>
diff --git a/articles/index.html b/articles/index.html
index 9022f48..9521e53 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/knitrTables.pdf b/articles/knitrTables.pdf
index 93d62a7..2e22720 100644
Binary files a/articles/knitrTables.pdf and b/articles/knitrTables.pdf differ
diff --git a/authors.html b/authors.html
index a0b0a6d..3111de4 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -65,13 +65,13 @@ <h2 id="citation">Citation</h2>
 
       <p>Murdoch D (2024).
 <em>tables: Formula-Driven Table Generation</em>.
-R package version 0.9.27, <a href="https://dmurdoch.github.io/tables/">https://dmurdoch.github.io/tables/</a>. 
+R package version 0.9.28, <a href="https://dmurdoch.github.io/tables/">https://dmurdoch.github.io/tables/</a>. 
 </p>
       <pre>@Manual{,
   title = {tables: Formula-Driven Table Generation},
   author = {Duncan Murdoch},
   year = {2024},
-  note = {R package version 0.9.27},
+  note = {R package version 0.9.28},
   url = {https://dmurdoch.github.io/tables/},
 }</pre>
     </div>
diff --git a/index.html b/index.html
index 6651e52..b9096c8 100644
--- a/index.html
+++ b/index.html
@@ -26,7 +26,7 @@
     
     <a class="navbar-brand me-2" href="index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/news/index.html b/news/index.html
index fe272cb..2a8e47b 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -52,7 +52,7 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="0.9.27" id="tables-0927">tables 0.9.27<a class="anchor" aria-label="anchor" href="#tables-0927"></a></h2>
+<h2 class="pkg-version" data-toc-text="0.9.28" id="tables-0928">tables 0.9.28<a class="anchor" aria-label="anchor" href="#tables-0928"></a></h2>
 <ul><li>A factor level of <code>""</code> caused an error when displayed. It will now be changed to <code>" "</code> for display (issue <a href="https://github.com/dmurdoch/tables/issues/19" class="external-link">#19</a>).</li>
 <li>The <code>VignetteBuilder</code> field in <code>DESCRIPTION</code> has been changed to <code>rmarkdown</code> so that Pandoc can be found even when it is not on the <code>PATH</code>.</li>
 <li>Another minor update due to changes to the <code>formatters</code> package.</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index 702529c..6f40402 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -4,7 +4,7 @@ pkgdown_sha: ~
 articles:
   HTML: HTML.html
   knitrTables: knitrTables.pdf
-last_built: 2024-06-25T14:33Z
+last_built: 2024-06-26T17:30Z
 urls:
   reference: https://dmurdoch.github.io/tables/reference
   article: https://dmurdoch.github.io/tables/articles
diff --git a/reference/All.html b/reference/All.html
index 5bd4e2e..58c99ad 100644
--- a/reference/All.html
+++ b/reference/All.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/AllObs.html b/reference/AllObs.html
index 02d1299..e0ec48a 100644
--- a/reference/AllObs.html
+++ b/reference/AllObs.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Arguments.html b/reference/Arguments.html
index 21e00ae..0002492 100644
--- a/reference/Arguments.html
+++ b/reference/Arguments.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/DropEmpty.html b/reference/DropEmpty.html
index 4986600..e1a116c 100644
--- a/reference/DropEmpty.html
+++ b/reference/DropEmpty.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Format.html b/reference/Format.html
index 6a72d81..ed05358 100644
--- a/reference/Format.html
+++ b/reference/Format.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/HTMLfootnotes.html b/reference/HTMLfootnotes.html
index 00a6969..efb05ae 100644
--- a/reference/HTMLfootnotes.html
+++ b/reference/HTMLfootnotes.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Heading.html b/reference/Heading.html
index 31ce6b7..be4f669 100644
--- a/reference/Heading.html
+++ b/reference/Heading.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Hline.html b/reference/Hline.html
index 6d479cf..6668e76 100644
--- a/reference/Hline.html
+++ b/reference/Hline.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Justify.html b/reference/Justify.html
index 0545b8f..4be704e 100644
--- a/reference/Justify.html
+++ b/reference/Justify.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Literal.html b/reference/Literal.html
index b406518..80c4b2b 100644
--- a/reference/Literal.html
+++ b/reference/Literal.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Paste.html b/reference/Paste.html
index 7d9bf7b..b672dad 100644
--- a/reference/Paste.html
+++ b/reference/Paste.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/Percent.html b/reference/Percent.html
index 7f89319..22f68f0 100644
--- a/reference/Percent.html
+++ b/reference/Percent.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/PlusMinus.html b/reference/PlusMinus.html
index 2ca74b9..5e9cdea 100644
--- a/reference/PlusMinus.html
+++ b/reference/PlusMinus.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/RowFactor.html b/reference/RowFactor.html
index cc5e7f5..7f14880 100644
--- a/reference/RowFactor.html
+++ b/reference/RowFactor.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.matrix.tabular.html b/reference/as.matrix.tabular.html
index e9c4cb6..a2820fe 100644
--- a/reference/as.matrix.tabular.html
+++ b/reference/as.matrix.tabular.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.tabular.html b/reference/as.tabular.html
index 2e030ef..43e32e8 100644
--- a/reference/as.tabular.html
+++ b/reference/as.tabular.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/html.tabular.html b/reference/html.tabular.html
index 59cb091..909ebe7 100644
--- a/reference/html.tabular.html
+++ b/reference/html.tabular.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index 1dd6089..f2799dc 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/knit_print.tabular.html b/reference/knit_print.tabular.html
index be00740..58f3441 100644
--- a/reference/knit_print.tabular.html
+++ b/reference/knit_print.tabular.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -83,8 +83,8 @@ <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></
 be called by <span class="pkg">knitr</span> while processing a <code class="file">.Rmd</code> or <code class="file">.Rnw</code> document.</p>
 <p>If <code>table_options()$knit_print</code> is <code>TRUE</code> and the output
 format is supported, this method will prepare output suitable for
-formatted printing in a <span class="pkg">knitr</span> document using <code>asis_output</code>.  Otherwise,
-the usual unformatted print display will be done by <code>normal_print</code>.</p>
+formatted printing in a <span class="pkg">knitr</span> document using <code><a href="https://rdrr.io/pkg/knitr/man/asis_output.html" class="external-link">asis_output</a></code>.  Otherwise,
+the usual unformatted print display will be done by <code><a href="https://rdrr.io/pkg/knitr/man/knit_print.html" class="external-link">normal_print</a></code>.</p>
     </div>
     <div class="section level2">
     <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
diff --git a/reference/labelSubset.html b/reference/labelSubset.html
index 72da8eb..2798bbb 100644
--- a/reference/labelSubset.html
+++ b/reference/labelSubset.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/labels.html b/reference/labels.html
index 66bc676..6175c44 100644
--- a/reference/labels.html
+++ b/reference/labels.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/latex.tabular.html b/reference/latex.tabular.html
index f3c3dd3..64ff3b9 100644
--- a/reference/latex.tabular.html
+++ b/reference/latex.tabular.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/latexNumeric.html b/reference/latexNumeric.html
index 1432a3f..5604081 100644
--- a/reference/latexNumeric.html
+++ b/reference/latexNumeric.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/latexTable.html b/reference/latexTable.html
index 14dd4af..fb64acf 100644
--- a/reference/latexTable.html
+++ b/reference/latexTable.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/matrix_form.tabular.html b/reference/matrix_form.tabular.html
index 2b2f0fb..3209d82 100644
--- a/reference/matrix_form.tabular.html
+++ b/reference/matrix_form.tabular.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/table_options.html b/reference/table_options.html
index f3935f9..3cf4206 100644
--- a/reference/table_options.html
+++ b/reference/table_options.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/tabular.html b/reference/tabular.html
index a5ff921..2b2d8d5 100644
--- a/reference/tabular.html
+++ b/reference/tabular.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/toKable.html b/reference/toKable.html
index 1661da9..3650960 100644
--- a/reference/toKable.html
+++ b/reference/toKable.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/toTinytable.html b/reference/toTinytable.html
index 2a3708c..96e68fe 100644
--- a/reference/toTinytable.html
+++ b/reference/toTinytable.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/useGroupLabels.html b/reference/useGroupLabels.html
index 3eb9e6e..7b21555 100644
--- a/reference/useGroupLabels.html
+++ b/reference/useGroupLabels.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/write.csv.tabular.html b/reference/write.csv.tabular.html
index a80a724..e658b16 100644
--- a/reference/write.csv.tabular.html
+++ b/reference/write.csv.tabular.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">tables</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.27</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.9.28</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/search.json b/search.json
index 3ae01f6..4d6e56e 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"initializing","dir":"Articles","previous_headings":"","what":"Initializing","title":"HTML Tables","text":"First, need load tables. Packages uses print banner messages, ’ll usually want set chunk option message=FALSE. table now constructed usual way. R Markdown document, don’t want table output HTML document header, turn options:","code":"library(tables) X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE)) tab <- tabular( Group ~ (N=1)+Format(digits=2)*X*((Mean=mean) + Heading(\"Std Dev\")*sd) ) table_options(htmloptions(head=FALSE))"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"inserting-a-table","dir":"Articles","previous_headings":"","what":"Inserting a Table","title":"HTML Tables","text":"two ways insert table knitr/rmarkdown document. Since tables version 0.8.4, can just print object, automatically formatted according current table_options(): previous behaviour required explicit call toHTML() function, knitr option results = 'asis' chunk. require older method, use table_options(knit_print = FALSE): either case, styling information needs included document. Ideally header, can inserted anywhere calling writeCSS results = 'asis':","code":"tab table_options(knit_print = FALSE) tab        # This chunk uses the default results = 'markup' ##                         ##           X             ##  Group N  Mean  Std Dev ##  a     20 -30.9  88.6   ##  b     33   4.2 130.8   ##  c     21  37.8  97.4   ##  d     28  15.3 107.5   ##  e     23  -1.4  67.1 toHTML(tab)  # This chunk uses results = 'asis' writeCSS()"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"improving-the-look","dir":"Articles","previous_headings":"","what":"Improving the Look","title":"HTML Tables","text":"default justification makes columns numbers look messy. can set justification right, headers look wrong: best look comes pad = TRUE option. adds nonbreaking spaces around numbers centering looks good. also changes hyphens proper minus signs: Unfortunately, cut table paste spreadsheet, spaces minus signs probably won’t understood. don’t know get everything want :-(.","code":"table_options(htmloptions(head = FALSE, justification = \"r\", knit_print = TRUE)) tab table_options(htmloptions(head = FALSE, justification = \"c\", pad = TRUE)) tab"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"fine-tuning","dir":"Articles","previous_headings":"","what":"Fine tuning","title":"HTML Tables","text":"document uses default CSS table_options()$CSS. producing html_document, okay. look quite right slidy_presentation, good ioslides_presentation. Furthermore, might agree design choices. cases, substitute CSS. need modify default one, can use CSS argument writeCSS(), set new default table_options(). default setting: Note #ID values replaced id string given writeCSS(), toHTML() corresponding argument allow make changes one specific table. using newer form display table_options(knit_print = TRUE), can get customized display one table also using table_options(doCSS = TRUE). example,","code":"<style> #ID .Rtable thead, .Rtable .even {   background-color: inherit; } #ID .left   { text-align:left; } #ID .center { text-align:center; } #ID .right  { text-align:right; } #ID .Rtable, #ID .Rtable thead {    border-collapse: collapse;   border-style: solid;   border-width: medium 0;   border-color: inherit; } #ID .Rtable th, #ID .Rtable td {   padding-left: 0.5em;   padding-right: 0.5em;   border-width: 0; } <\/style> table_options(CSS = \"<style> #ID .center {    text-align:center;   background-color: aliceblue; } <\/style>\", doCSS = TRUE) tab table_options(doCSS = FALSE) tab"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"kableextra-support","dir":"Articles","previous_headings":"","what":"kableExtra support","title":"HTML Tables","text":"kableExtra package contains large number functions customize look tables generated knitr::kable() function. can also made work tables package, using toKable() function. example, conflicts styling options kableExtra ones specified table_options()$CSS; modifications might needed make everything work. instance, code requests striping, show . Experimentation may needed!","code":"library(magrittr) library(kableExtra) toKable(tab, format=\"html\") %>%    kable_styling(\"striped\", full_width = FALSE) %>%   add_header_above(c(\"Row Label\" = 1, \"Statistics\" = 3)) %>%   column_spec(4, color = \"red\") %>%   row_spec(1, color = \"blue\") %>%   group_rows(\"Subgroup\", 3, 5)"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"tinytable-support","dir":"Articles","previous_headings":"","what":"tinytable support","title":"HTML Tables","text":"tinytable package another package can used customize look tables generated tables. tinytable can customized, printed saved variety formats, including: HTML, LaTeX, Word, Typst, PNG, PDF, Rmarkdown, Quarto. example,","code":"library(magrittr) library(tinytable) toTinytable(tab, theme = \"striped\") %>%   group_tt(i = list(\"Subgroup\" = 3)) %>%   group_tt(j = list(\"Row Label\" = 1, \"Statistics\" = 2:4)) %>%   style_tt(i = 3, color = \"red\", align = \"c\", line = \"bt\", line_color = \"red\") %>%   style_tt(i = 5:6, j = 3:4, background = \"black\", color = \"orange\")"},{"path":"https://dmurdoch.github.io/tables/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Duncan Murdoch. Maintainer.","code":""},{"path":"https://dmurdoch.github.io/tables/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Murdoch D (2024). tables: Formula-Driven Table Generation. R package version 0.9.27, https://dmurdoch.github.io/tables/.","code":"@Manual{,   title = {tables: Formula-Driven Table Generation},   author = {Duncan Murdoch},   year = {2024},   note = {R package version 0.9.27},   url = {https://dmurdoch.github.io/tables/}, }"},{"path":"https://dmurdoch.github.io/tables/index.html","id":"tables","dir":"","previous_headings":"","what":"Formula-Driven Table Generation","title":"Formula-Driven Table Generation","text":"goal tables compute display complex tables summary statistics. Output may LaTeX, HTML, plain text, R matrix processing.","code":""},{"path":"https://dmurdoch.github.io/tables/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Formula-Driven Table Generation","text":"can install release version orientlib using can install development version tables GitHub :","code":"install.packages(\"tables\") # install.packages(\"devtools\") devtools::install_github(\"dmurdoch/tables\")"},{"path":"https://dmurdoch.github.io/tables/index.html","id":"example","dir":"","previous_headings":"","what":"Example","title":"Formula-Driven Table Generation","text":"basic example shows solve common problem:","code":"library(tables)  set.seed(123)  # In an R Markdown document, you don't want each table # to output the HTML document header, so turn  # off that option:  table_options(htmloptions(head=FALSE))  X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE)) tab <- tabular( Group ~                    (N=1) +                   Format(digits=2)*X*                     ((Mean=mean) +                      Heading(\"Std Dev\")*sd)                )  # To print in plain text: tab #>                          #>           X              #>  Group N  Mean   Std Dev #>  a     31  -6.84  82.50  #>  b     28  13.06  97.04  #>  c     17  -2.24  99.71  #>  d     15   4.45  98.60  #>  e     34   0.87  84.96  # To format in HTML: toHTML(tab) # To generate LaTeX code: strsplit(toLatex(tab)$text, \"\\n\") #> [[1]] #>  [1] \"\\\\begin{tabular}{lccc}\"                                                #>  [2] \"\\\\hline\"                                                               #>  [3] \" &  & \\\\multicolumn{2}{c}{X} \\\\\\\\ \"                                    #>  [4] \"Group  & N & Mean & \\\\multicolumn{1}{c}{Std Dev} \\\\\\\\ \"                #>  [5] \"\\\\hline\"                                                               #>  [6] \"a  & $31$ & $\\\\phantom{0}-6.84$ & $\\\\phantom{-}82.50$ \\\\\\\\\"            #>  [7] \"b  & $28$ & $\\\\phantom{-}13.06$ & $\\\\phantom{-}97.04$ \\\\\\\\\"            #>  [8] \"c  & $17$ & $\\\\phantom{0}-2.24$ & $\\\\phantom{-}99.71$ \\\\\\\\\"            #>  [9] \"d  & $15$ & $\\\\phantom{0}\\\\phantom{-}4.45$ & $\\\\phantom{-}98.60$ \\\\\\\\\" #> [10] \"e  & $34$ & $\\\\phantom{0}\\\\phantom{-}0.87$ & $\\\\phantom{-}84.96$ \\\\\\\\\" #> [11] \"\\\\hline \"                                                              #> [12] \"\\\\end{tabular}\""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":null,"dir":"Reference","previous_headings":"","what":"Include all columns of a dataframe. — All","title":"Include all columns of a dataframe. — All","text":"constructs formula object columns dataframe.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Include all columns of a dataframe. — All","text":"","code":"All(df, numeric=TRUE, character=FALSE, logical=FALSE, factor=FALSE,          complex=FALSE, raw=FALSE, other=FALSE,         texify=getOption(\"tables.texify\", FALSE))"},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Include all columns of a dataframe. — All","text":"df dataframe find columns. numeric, character, logical, factor, complex, raw Whether include columns specified types.  See Details . Whether include columns match none previous types. texify Whether escape LaTeX special characters column names.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Include all columns of a dataframe. — All","text":"function constructs formula columns dataframe. default, numeric columns included.  arguments  numeric, character, logical, factor, complex raw control inclusion columns corresponding types.   argument controls inclusion columns. arguments TRUE, columns included formula. function (name function given character string) passed, columns transformed function inclusion.  example, (df, factor=.character) convert factor columns character representation inclusion. cases, columns skipped.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Include all columns of a dataframe. — All","text":"Language insert table formula achieve desired table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Include all columns of a dataframe. — All","text":"","code":"# Show mean and sd of all numeric columns in the iris data tabular( Species  ~         All(iris)*(mean + sd), data=iris ) #>                                                                        #>             Sepal.Length        Sepal.Width        Petal.Length        #>  Species    mean         sd     mean        sd     mean         sd     #>  setosa     5.006        0.3525 3.428       0.3791 1.462        0.1737 #>  versicolor 5.936        0.5162 2.770       0.3138 4.260        0.4699 #>  virginica  6.588        0.6359 2.974       0.3225 5.552        0.5519 #>                     #>  Petal.Width        #>  mean        sd     #>  0.246       0.1054 #>  1.326       0.1978 #>  2.026       0.2747"},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":null,"dir":"Reference","previous_headings":"","what":"Display all observations in a table. — AllObs","title":"Display all observations in a table. — AllObs","text":"functions generate code tabular table include observations dataset, possibly divided according factors.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display all observations in a table. — AllObs","text":"","code":"AllObs(data = NULL, show = FALSE, label = \"Obsn.\", within = NULL) RowNum(within = NULL, perrow = 5, show = FALSE, label = \"Row\", data = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display all observations in a table. — AllObs","text":"data full dataset, used find number observations. show Whether show observation number row number table. label label use show = TRUE. within factor list factors break observations. perrow many observations per row RowNum used  row specification, per column part column specification.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display all observations in a table. — AllObs","text":"AllObs used display observations dataset. generates (usually undisplayed) factor different level observation, sets function display value, calls DropEmpty suppress display empty rows, columns cells. within argument specified AllObs,  factor levels restarted within grouping.  (within interpreted INDEX argument tapply, one exception described .)  may useful displaying observation number, definitely useful AllObs used column specification table. also save computation time table large, since fewer factor levels generated  later dropped. RowNum unlikely useful table , helpful displaying large datasets AllObs. allows large number observations broken several rows columns. RowNum affects rows columns, use somewhat unusual.  Normally called calling tabular, result saved variable.  variable (e.g. rownum) used row specification table wrapped (), column specification table within argument AllObs.  (exception mentioned .) Despite name, RowNum can used column specifier, prefer column-major ordering values displayed  table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display all observations in a table. — AllObs","text":"AllObs RowNum return language objects used tabular formulas.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display all observations in a table. — AllObs","text":"","code":"tabular(Factor(cyl)*Factor(gear)*AllObs(mtcars) ~                 rownames(mtcars) + mpg, data=mtcars) #>                                    #>  cyl gear rownames(mtcars)    mpg  #>  4   3    Toyota Corona       21.5 #>      4    Datsun 710          22.8 #>           Merc 240D           24.4 #>           Merc 230            22.8 #>           Fiat 128            32.4 #>           Honda Civic         30.4 #>           Toyota Corolla      33.9 #>           Fiat X1-9           27.3 #>           Volvo 142E          21.4 #>      5    Porsche 914-2       26.0 #>           Lotus Europa        30.4 #>  6   3    Hornet 4 Drive      21.4 #>           Valiant             18.1 #>      4    Mazda RX4           21.0 #>           Mazda RX4 Wag       21.0 #>           Merc 280            19.2 #>           Merc 280C           17.8 #>      5    Ferrari Dino        19.7 #>  8   3    Hornet Sportabout   18.7 #>           Duster 360          14.3 #>           Merc 450SE          16.4 #>           Merc 450SL          17.3 #>           Merc 450SLC         15.2 #>           Cadillac Fleetwood  10.4 #>           Lincoln Continental 10.4 #>           Chrysler Imperial   14.7 #>           Dodge Challenger    15.5 #>           AMC Javelin         15.2 #>           Camaro Z28          13.3 #>           Pontiac Firebird    19.2 #>      5    Ford Pantera L      15.8 #>           Maserati Bora       15.0      rownum <- with(mtcars, RowNum(list(cyl, gear))) tabular(Factor(cyl)*Factor(gear)*I(rownum) ~         mpg * AllObs(mtcars, within = list(cyl, gear, rownum)),          data=mtcars) #>                                    #>  cyl gear mpg                      #>  4   3    21.5                     #>      4    22.8 24.4 22.8 32.4 30.4 #>           33.9 27.3 21.4           #>      5    26.0 30.4                #>  6   3    21.4 18.1                #>      4    21.0 21.0 19.2 17.8      #>      5    19.7                     #>  8   3    18.7 14.3 16.4 17.3 15.2 #>           10.4 10.4 14.7 15.5 15.2 #>           13.3 19.2                #>      5    15.8 15.0"},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":null,"dir":"Reference","previous_headings":"","what":"Arguments pseudo-function — Arguments","title":"Arguments pseudo-function — Arguments","text":"Arguments pseudo-function enables use analysis functions take multiple arguments.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Arguments pseudo-function — Arguments","text":"","code":"Arguments(...)"},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Arguments pseudo-function — Arguments","text":"... Arguments pass analysis function.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Arguments pseudo-function — Arguments","text":"arguments Arguments evaluated full, length n subsetted cell table. analysis variable specified, Arguments() ,  analysis function called arguments matching given ....  analysis variable specified, inserted unnamed first argument analysis function. Arguments() entry create heading. one Arguments() specification may active term tabular formula.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Arguments pseudo-function — Arguments","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Arguments pseudo-function — Arguments","text":"","code":"# This is the example from the weighted.mean help page wt <- c(5,  5,  4,  1)/15 x <- c(3.7,3.3,3.5,2.8) gp <- c(1,1,2,2) tabular( (Factor(gp) + 1)      ~ weighted.mean*x*Arguments(w = wt) ) #>                    #>      weighted.mean #>  gp  x             #>  1   3.500         #>  2   3.360         #>  All 3.453"},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":null,"dir":"Reference","previous_headings":"","what":"DropEmpty pseudo-function — DropEmpty","title":"DropEmpty pseudo-function — DropEmpty","text":"Pseudo-function indicate rows columns containing observations dropped.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"DropEmpty pseudo-function — DropEmpty","text":"","code":"DropEmpty(empty = \"\", which = c(\"row\", \"col\", \"cell\"))"},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"DropEmpty pseudo-function — DropEmpty","text":"empty String use empty cells. vector indicating dropped.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"DropEmpty pseudo-function — DropEmpty","text":"argument contains \"row\", row table cells empty dropped. Similarly, contains \"col\", empty columns dropped.  contains \"cell\", cells rows columns dropped set empty string.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"DropEmpty pseudo-function — DropEmpty","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"DropEmpty pseudo-function — DropEmpty","text":"","code":"df <- data.frame(row = factor(1:10), value = rnorm(10)) subset <- df[sample(10, 5),, drop = FALSE]  # Some rows did not get selected, so this looks ugly tabular(row ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  1         NaN #>  2         NaN #>  3         NaN #>  4   -0.005571 #>  5    0.621553 #>  6         NaN #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200 #>  10        NaN  # This only shows rows with data in them tabular(row*DropEmpty() ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  4   -0.005571 #>  5    0.621553 #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200  # This shows empty cells as \"(empty)\" tabular(row*DropEmpty(\"(empty)\", \"cell\") ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  1   (empty)   #>  2   (empty)   #>  3   (empty)   #>  4   -0.005571 #>  5    0.621553 #>  6   (empty)   #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200 #>  10  (empty)"},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":null,"dir":"Reference","previous_headings":"","what":"Format pseudo-function — Format","title":"Format pseudo-function — Format","text":"Format controls formatting cells applies .  .Format mainly internal use.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Format pseudo-function — Format","text":"","code":"Format(...) .Format(n)"},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Format pseudo-function — Format","text":"... Arguments pass formatting function, call formatting function. n format number.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Format pseudo-function — Format","text":"Format pseudo-function changes formatting table cells, specifies values applies formatted together. first form, “call” Format looks like call format, without specifying argument x.  tabular() formats output construct x entries table governed Format() specification, pass standard format function along arguments. second form, “call” Format contains  call function formatting.  , argument x added call, containing values formatted. first form, explicit function named format, cells table character values formatted.  done column can mixed numeric character values, numerics converted character formatting. pseudo-function .Format mainly intended internal use. takes single integer argument, saying data governed call uses formatting format specification indicated integer. way entries can commonly formatted even contiguous. integers assigned sequentially format specification parsed; users likely need trial error find right value complicated table multiple formats.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Format pseudo-function — Format","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Format pseudo-function — Format","text":"","code":"# Using the first form tabular( (Sepal.Length+Sepal.Width) ~           Format(digits=2)*(mean + sd), data=iris ) #>                         #>               mean sd   #>  Sepal.Length 5.84 0.83 #>  Sepal.Width  3.06 0.44           # The same table, using the second form tabular( (Sepal.Length+Sepal.Width) ~           Format(format(digits=2))*(mean + sd), data=iris ) #>                         #>               mean sd   #>  Sepal.Length 5.84 0.83 #>  Sepal.Width  3.06 0.44"},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":null,"dir":"Reference","previous_headings":"","what":"Construct footnotes — HTMLfootnotes","title":"Construct footnotes — HTMLfootnotes","text":"function constructs HTML code footnotes insert bottom table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Construct footnotes — HTMLfootnotes","text":"","code":"HTMLfootnotes(tab, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Construct footnotes — HTMLfootnotes","text":"tab tabular object, used column width footnotes matches. ... footnotes.  named, preceded name superscript.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Construct footnotes — HTMLfootnotes","text":"character string containing HTML code footnotes.  Use table_options(HTMLfooter = ...)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Construct footnotes — HTMLfootnotes","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) footnote <- HTMLfootnotes(tab,                            \"This is a footnote with no marker.\",                            \"*\" = \"This is a footnote with an asterisk.\") if (interactive())   toHTML(tab, options = list(doFooter = TRUE,                            HTMLfooter = footnote))"},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":null,"dir":"Reference","previous_headings":"","what":"Heading pseudo-function — Heading","title":"Heading pseudo-function — Heading","text":"Heading pseudo-function normally overrides automatic heading following items table.  Setting  override=FALSE used automatically  generated expressions.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Heading pseudo-function — Heading","text":"","code":"Heading(name = NULL, override = TRUE, character.only = FALSE, nearData = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Heading pseudo-function — Heading","text":"name legal R variable name, character constant. override Whether heading override one already present. character.TRUE, name argument interpreted expression evaluating character value. nearData See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Heading pseudo-function — Heading","text":"replaces automatic heading row label following item name string specified.  argument given, heading label suppressed. alternative form Heading(name) (name=...), ... expression displayed table. override = FALSE, label supplied label. used code Factor. nearData argument rarely used.  affects situation \"+\" used join tables different numbers labels.   nearData = TRUE (default), shorter list labels pushed close data, .e. right side row labels, bottom column labels.  FALSE, pushed opposite side.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Heading pseudo-function — Heading","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Heading pseudo-function — Heading","text":"","code":"tabular( (Sepal.Length+Sepal.Width) ~           (Heading(Mean)*mean + (S.D.=sd)), data=iris ) #>                            #>               Mean  S.D.   #>  Sepal.Length 5.843 0.8281 #>  Sepal.Width  3.057 0.4359  heading <- \"Variable Heading\" tabular( (Sepal.Length+Sepal.Width) ~           (Heading(heading, character.only = TRUE)*mean + (S.D.=sd)),           data=iris ) #>                                       #>               Variable Heading S.D.   #>  Sepal.Length 5.843            0.8281 #>  Sepal.Width  3.057            0.4359"},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a horizontal line to a LaTeX table. — Hline","title":"Add a horizontal line to a LaTeX table. — Hline","text":"function inserts LaTeX directive draw full partial  line table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a horizontal line to a LaTeX table. — Hline","text":"","code":"Hline(columns, nearData = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a horizontal line to a LaTeX table. — Hline","text":"columns columns receive line? nearData See Details section Heading.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add a horizontal line to a LaTeX table. — Hline","text":"Hline() flexible:  must leftmost header row specification table, .e. mean * Hline() allowed.  Anything right Hline() factor ignored.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a horizontal line to a LaTeX table. — Hline","text":"Produces expression insert label interpreted LaTeX request horizontal line.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a horizontal line to a LaTeX table. — Hline","text":"","code":"toLatex( tabular( Species + Hline() + 1 ~ mean*Sepal.Width, data=iris) ) #> \\begin{tabular}{lc} #> \\hline #>  & \\multicolumn{1}{c}{mean} \\\\  #> Species  & \\multicolumn{1}{c}{Sepal.Width} \\\\  #> \\hline #> setosa  & $3.428$ \\\\ #> versicolor  & $2.770$ \\\\ #> virginica  & $2.974$ \\\\ #> \\hline %  &  \\\\ #> All  & $3.057$ \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":null,"dir":"Reference","previous_headings":"","what":"Justify pseudo-function — Justify","title":"Justify pseudo-function — Justify","text":"Justify pseudo-function sets justification following items table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Justify pseudo-function — Justify","text":"","code":"Justify(labels, data=labels)"},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Justify pseudo-function — Justify","text":"labels Justification use labels data Justification use data.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Justify pseudo-function — Justify","text":"justification can R name syntactically valid,  quoted string.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Justify pseudo-function — Justify","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Justify pseudo-function — Justify","text":"","code":"tabular( Justify(c,l)*Heading(Var)*(Sepal.Length+Sepal.Width) ~           Justify(c)*(mean + sd), data=iris ) #>                            #>      Var      mean    sd   #>  Sepal.Length 5.843 0.8281 #>  Sepal.Width  3.057 0.4359"},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":null,"dir":"Reference","previous_headings":"","what":"Insert a literal entry into a table margin. — Literal","title":"Insert a literal entry into a table margin. — Literal","text":"allows insertion arbitrary LaTeX text table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Insert a literal entry into a table margin. — Literal","text":"","code":"Literal(x, nearData = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Insert a literal entry into a table margin. — Literal","text":"x character string insert. nearData See Details section Heading.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Insert a literal entry into a table margin. — Literal","text":"LaTeX literal string usually end % comment character avoid blank line inserted.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Insert a literal entry into a table margin. — Literal","text":"Produces expression insert label containing literal text.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Insert a literal entry into a table margin. — Literal","text":"","code":"tabular( (Literal(\"Some text\") + Species)  ~         All(iris)*mean, data=iris ) #>                                                                       #>                     Sepal.Length Sepal.Width Petal.Length Petal.Width #>                     mean         mean        mean         mean        #>          Some text                                                    #>  Species setosa     5.006        3.428       1.462        0.246       #>          versicolor 5.936        2.770       4.260        1.326       #>          virginica  6.588        2.974       5.552        2.026"},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate terms to paste values together in table. — Paste","title":"Generate terms to paste values together in table. — Paste","text":"function generates component table formula output multiple columns punctuation .   designed LaTeX output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate terms to paste values together in table. — Paste","text":"","code":"Paste(..., head, digits=2, justify=\"c\", prefix=\"\", sep=\"\", postfix=\"\",       character.only = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate terms to paste values together in table. — Paste","text":"... Expressions displayed columns table.  named, get names headings, otherwise labelled. head missing, used column heading combined columns. digits passed format function.  digits length one, expressions use common format; otherwise formatted separately. justify One justifications use individual columns. sep One separators use columns. prefix, postfix Additional text insert group columns. character.TRUE, head argument interpreted expression evaluating character value.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate terms to paste values together in table. — Paste","text":"expression produce requested output LaTeX.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":null,"dir":"Reference","previous_headings":"","what":"Pseudo-function to compute a statistic relative to a reference set. — Percent","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"Percent pseudo-function used specify statistic depends values table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"","code":"Percent(denom = \"all\", fn = percent)"},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"denom reference set (denominator case percentage calculation) calculated.  See . fn two argument function calculate statistic.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"function fn called two arguments.  first argument usual “value vector”  values corresponding cell table, second  another vector reference values, determined denom. default value fn percent function, defined function(x, y) 100*length(x)/length(y).  gives ratio number values current cell relative reference values, expressed percentage. Using fn = function(x, y) 100*sum(x)/sum(y) give percentage sum values current cell sum reference set. default denom = \"\", values analysis variable dataset used reference.  possibilities denom = \"row\" denom = \"col\", values variable corresponding current row column subset used. special syntax denom = Equal(...) record  expression ....  reference set cases equal values expressions ... current cell. similar form denom = Unequal(...) sets reference values differ ... expressions current cell.  (fact, can used somewhat generally; see  vignette details.) Finally, possible denom values  logical vector, case values marked TRUE used, anything else, passed fn y without subsetting.  (pass variable subsetting, use Arguments pseudo-function instead.)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"Percent “pseudo-function”:  takes form function call, never actually called:   handled specially tabular.  Equal Unequal also pseudo-functions, special used denom argument Percent.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"","code":"x <- factor(sample(LETTERS[1:2], 1000, rep=TRUE)) y <- factor(sample(letters[3:4], 1000, rep=TRUE)) z <- factor(sample(LETTERS[5:6], 1000, rep=TRUE))  # These both do the same thing: tabular( (x + 1)*(y + 1) ~ (z + 1)*(1+(RowPct=Percent(\"row\")))) #>                                            #>          z                                 #>          E          F          All         #>  x   y   All RowPct All RowPct All  RowPct #>  A   c   118 50.64  115 49.36   233 100    #>      d   139 54.30  117 45.70   256 100    #>      All 257 52.56  232 47.44   489 100    #>  B   c   132 50.77  128 49.23   260 100    #>      d   127 50.60  124 49.40   251 100    #>      All 259 50.68  252 49.32   511 100    #>  All c   250 50.71  243 49.29   493 100    #>      d   266 52.47  241 47.53   507 100    #>      All 516 51.60  484 48.40  1000 100    tabular( (x + 1)*(y + 1) ~ (z + 1)*(1+(xyPct=Percent(Equal(x, y))))) #>                                         #>          z                              #>          E         F         All        #>  x   y   All xyPct All xyPct All  xyPct #>  A   c   118 50.64 115 49.36  233 100   #>      d   139 54.30 117 45.70  256 100   #>      All 257 52.56 232 47.44  489 100   #>  B   c   132 50.77 128 49.23  260 100   #>      d   127 50.60 124 49.40  251 100   #>      All 259 50.68 252 49.32  511 100   #>  All c   250 50.71 243 49.29  493 100   #>      d   266 52.47 241 47.53  507 100   #>      All 516 51.60 484 48.40 1000 100"},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate x +/- y terms in table. — PlusMinus","title":"Generate x +/- y terms in table. — PlusMinus","text":"function generates component table formula output two columns separated +/- sign.   designed LaTeX output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate x +/- y terms in table. — PlusMinus","text":"","code":"PlusMinus(x, y, head, xhead, yhead, digits = 2,            character.only = FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate x +/- y terms in table. — PlusMinus","text":"x,y Expressions displayed columns left right +/- sign, respectively. head missing, used column heading two columns. xhead, yhead missing, used individual column headings. digits, ... Parameters pass format function. character.TRUE, head, xhead yhead  arguments interpreted expressions evaluating character values.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate x +/- y terms in table. — PlusMinus","text":"expression produce requested output LaTeX.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate x +/- y terms in table. — PlusMinus","text":"","code":"stderr <- function(x) sd(x)/sqrt(length(x)) toLatex( tabular( (Species+1) ~ Sepal.Length*           PlusMinus(mean, stderr, digits=1), data=iris ) ) #> \\begin{tabular}{lcc} #> \\hline #> Species  & \\multicolumn{2}{c}{Sepal.Length} \\\\  #> \\hline #> setosa  & \\multicolumn{1}{r@{}}{$5.01$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.05$} \\\\ #> versicolor  & \\multicolumn{1}{r@{}}{$5.94$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.07$} \\\\ #> virginica  & \\multicolumn{1}{r@{}}{$6.59$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.09$} \\\\ #> All  & \\multicolumn{1}{r@{}}{$5.84$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.07$} \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":null,"dir":"Reference","previous_headings":"","what":"Use a variable as a factor to give rows in a table. — RowFactor","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"functions take variable treat factor table. RowFactor designed LaTeX output, adding extra spacing make table readable.  Multicolumn also works LaTeX, displays label style level line , spanning multiple columns.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"","code":"Factor(x, name = deparse(expr), levelnames = levels(x),         texify = getOption(\"tables.texify\", FALSE),         expr = substitute(x), override = TRUE) RowFactor(x, name = deparse(expr),      levelnames = levels(x),            spacing = 3, space = 1, suppressfirst = TRUE,           nopagebreak = \"\\\\nopagebreak \",           texify = getOption(\"tables.texify\", FALSE),            expr = substitute(x),           override = TRUE) Multicolumn(x, name = deparse(expr), levelnames = levels(x),              width=2, first=1, justify=\"l\",             texify = getOption(\"tables.texify\", FALSE),              expr = substitute(x),             override = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"x variable treated factor. name display name factor. levelnames strings use levels x. texify TRUE, characters interpreted specially LaTeX  escaped (using latexTranslate) print properly. expr expression use evaluating factor.  Generally expression passed x, internal uses may differ. override name factor override previously specified Heading() setting? spacing Extra spacing added every spacing lines. space much extra space add, ex units. suppressfirst Whether suppress spacing first group. nopagebreak LaTeX macro insert suppress page breaks except groups. width many columns label span? first first column label appears? justify label justified columns?","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"Language insert table formula achieve desired table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"","code":"tabular( Factor(1:10, \"row\") ~        All(iris[1:10,])*Heading()*identity ) #>                                                        #>  row Sepal.Length Sepal.Width Petal.Length Petal.Width #>  1   5.1          3.5         1.4          0.2         #>  2   4.9          3.0         1.4          0.2         #>  3   4.7          3.2         1.3          0.2         #>  4   4.6          3.1         1.5          0.2         #>  5   5.0          3.6         1.4          0.2         #>  6   5.4          3.9         1.7          0.4         #>  7   4.6          3.4         1.4          0.3         #>  8   5.0          3.4         1.5          0.2         #>  9   4.4          2.9         1.4          0.2         #>  10  4.9          3.1         1.5          0.1         toLatex( tabular( RowFactor(1:10, \"\", 5)  ~         All(iris[1:10,])*Heading()*identity ))  #> \\begin{tabular}{lcccc} #> \\hline #>   & Sepal.Length & Sepal.Width & Petal.Length & \\multicolumn{1}{c}{Petal.Width} \\\\  #> \\hline #> \\nopagebreak 5  & $5.1$ & $3.5$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.9$ & $3.0$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.7$ & $3.2$ & $1.3$ & $0.2$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.6$ & $3.1$ & $1.5$ & $0.2$ \\\\ #> \\nopagebreak NA  & $5.0$ & $3.6$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $5.4$ & $3.9$ & $1.7$ & $0.4$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.6$ & $3.4$ & $1.4$ & $0.3$ \\\\ #> \\nopagebreak NA  & $5.0$ & $3.4$ & $1.5$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.4$ & $2.9$ & $1.4$ & $0.2$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.9$ & $3.1$ & $1.5$ & $0.1$ \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to matrix — as.matrix.tabular","title":"Convert tabular object to matrix — as.matrix.tabular","text":"Convert tabular object matrix strings print, matrix values.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to matrix — as.matrix.tabular","text":"","code":"# S3 method for tabular as.matrix(x, format = TRUE,      rowLabels = TRUE, colLabels = TRUE, justification = \"n\", ...)"},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to matrix — as.matrix.tabular","text":"x \"tabular\" object. format format; see Details . rowLabels, colLabels Whether include row column labels; used format = TRUE. justification justify values; used format = TRUE. ... parameters pass format.tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Convert tabular object to matrix — as.matrix.tabular","text":"format=TRUE, matrix formatted strings produced.  , format argument assumed function (name function passed character vector) convert list-mode matrix another mode, e.g. .numeric.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to matrix — as.matrix.tabular","text":"matrix.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to matrix — as.matrix.tabular","text":"","code":"table <-     tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )  print(table) #>                                                    #>                 Sepal.Length      Sepal.Width      #>  Species    n   mean         sd   mean        sd   #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44 as.matrix(table) #>      [,1]         [,2]  [,3]           [,4]   [,5]          [,6]   #> [1,] \"\"           \"\"    \"Sepal.Length\" \"\"     \"Sepal.Width\" \"\"     #> [2,] \"Species\"    \"n\"   \"mean\"         \"sd\"   \"mean\"        \"sd\"   #> [3,] \"setosa\"     \" 50\" \"5.01\"         \"0.35\" \"3.43\"        \"0.38\" #> [4,] \"versicolor\" \" 50\" \"5.94\"         \"0.52\" \"2.77\"        \"0.31\" #> [5,] \"virginica\"  \" 50\" \"6.59\"         \"0.64\" \"2.97\"        \"0.32\" #> [6,] \"All\"        \"150\" \"5.84\"         \"0.83\" \"3.06\"        \"0.44\" as.matrix(table, format=as.numeric) #>      [,1]     [,2]      [,3]     [,4]      [,5] #> [1,]   50 5.006000 0.3524897 3.428000 0.3790644 #> [2,]   50 5.936000 0.5161711 2.770000 0.3137983 #> [3,]   50 6.588000 0.6358796 2.974000 0.3224966 #> [4,]  150 5.843333 0.8280661 3.057333 0.4358663"},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert matrix or dataframe to tabular object. — as.tabular","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"functions construct copy labels onto existing matrix dataframe.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"","code":"as.tabular(x, like = NULL) # S3 method for default as.tabular(x, like = NULL) # S3 method for data.frame as.tabular(x, like = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"x object convert. like NULL, tabular object   number rows columns x.  labels   used result.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"tabular object.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"","code":"model <- tabular( (Species + 1) ~ (n=1) + Sepal.Length + Sepal.Width, data=iris ) model #>                                          #>  Species    n   Sepal.Length Sepal.Width #>  setosa      50  50           50         #>  versicolor  50  50           50         #>  virginica   50  50           50         #>  All        150 150          150         as.tabular(matrix(1:12, 4,3), like=model) #>                                        #>  Species    n Sepal.Length Sepal.Width #>  setosa     1 5             9          #>  versicolor 2 6            10          #>  virginica  3 7            11          #>  All        4 8            12"},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Display a tabular object using HTML. — html.tabular","title":"Display a tabular object using HTML. — html.tabular","text":"similar print.tabular, inserts code display table HTML table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display a tabular object using HTML. — html.tabular","text":"","code":"toHTML(object, file = \"\", options = NULL,                         id = NULL, append = FALSE,                         browsable = TRUE, ...) html.tabular(object, ...) writeCSS(CSS = htmloptions()$CSS, id = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display a tabular object using HTML. — html.tabular","text":"object tabular object. file filename connection write HTML code, \"\" write console. options list options set duration call. id unique identifier set table associated CSS style, NULL, id. append TRUE, opens file appending (filename rather connection). browsable output marked browsable? ... Settings default formatting.  See Details . CSS character vector use CSS.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display a tabular object using HTML. — html.tabular","text":"toHTML() function produces HTML output suitable inclusion HTML page. html.tabular function set work method html generic Hmisc, registered method, tables can work Hmisc installed. HTML, mainly CSS style sheet determines look table.   formatting table, html.tabular sets CSS class according table's Justify setting; justifications c(\"l\", \"c\", \"r\") translated classes c(\"left\", \"center\", \"right\") respectively; strings passed used directly class names.   id value NULL, used CSS id selector searching style. See table_options number options control formatting, including default style sheet.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display a tabular object using HTML. — html.tabular","text":"file = \"\" (default), toHTML() function creates HTML object using htmltools::HTML function returns .  file character value connection, results written HTML object returned invisibly.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display a tabular object using HTML. — html.tabular","text":"","code":"# \\donttest{ X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE))  tab <- tabular( Group ~ (N=1)+Format(digits=2)*X*((Mean=mean) + Heading(\"Std Dev\")*sd) )  save <- table_options() table_options(rowlabeljustification=\"c\")  f <- tempfile(fileext=\".html\") con <- file(f, \"wt\")  if (interactive())   toHTML(tab, con, options=htmloptions(head=TRUE, table=FALSE))  writeLines(\"<p>This table has pad = FALSE.  The centered numbers look sloppy.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=FALSE))  writeLines(\"<p>This table has pad = FALSE and justification=\\\"r\\\". The justification makes the columns of numbers look all right (except for the hyphens used as minus signs), but they are placed poorly relative to the labels.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=FALSE, justification=\"r\"))  writeLines(\"<p>This one has pad = TRUE. It looks best, but if you cut and paste, the spacing characters may cause problems.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=TRUE))  table_options(save) close(con) if (interactive())   browseURL(f) # }"},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Custom printing of tabular objects. — knit_print.tabular","title":"Custom printing of tabular objects. — knit_print.tabular","text":"Automatically print tabular objects formatting knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Custom printing of tabular objects. — knit_print.tabular","text":"","code":"# S3 method for tabular knit_print(x, format = getKnitrFormat(), ...)"},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Custom printing of tabular objects. — knit_print.tabular","text":"x tabular object. format output format?  \"latex\" \"html\" supported. ... parameters, currently ignored.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Custom printing of tabular objects. — knit_print.tabular","text":"function normally called user.  designed called knitr processing .Rmd .Rnw document. table_options()$knit_print TRUE output format supported, method prepare output suitable formatted printing knitr document using asis_output.  Otherwise, usual unformatted print display done normal_print.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Custom printing of tabular objects. — knit_print.tabular","text":"object marked printing knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Custom printing of tabular objects. — knit_print.tabular","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) knitr::knit_print(tab) #> [1] \"\\\\begin{tabular}{lccccc}\\n\\\\hline\\n &  & \\\\multicolumn{2}{c}{Sepal.Length} & \\\\multicolumn{2}{c}{Sepal.Width} \\\\\\\\ \\nSpecies  & n & mean & sd & mean & \\\\multicolumn{1}{c}{sd} \\\\\\\\ \\n\\\\hline\\nsetosa  & $\\\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\\\\\\\nversicolor  & $\\\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\\\\\\\nvirginica  & $\\\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\\\\\\\nAll  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\\\\\\\n\\\\hline \\n\\\\end{tabular}\\n\\n\\nFALSE\\n\\n\\n\" #> attr(,\"class\") #> [1] \"knit_asis\" #> attr(,\"knit_cacheable\") #> [1] NA"},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a label to a logical vector. — labelSubset","title":"Add a label to a logical vector. — labelSubset","text":"function mainly internal use.  adds label  logical vector, Percent pseudo-function can ignore forming denominator.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a label to a logical vector. — labelSubset","text":"","code":"labelSubset(subset, label)"},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a label to a logical vector. — labelSubset","text":"subset logical vector describing subset dataset. label character label use describe subset call Equal Unequal within Percent.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a label to a logical vector. — labelSubset","text":"vector class \"labelledSubset\" label  recorded attribute.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Add a label to a logical vector. — labelSubset","text":"Duncan Murdoch","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve or modify the row or column labels. — labels","title":"Retrieve or modify the row or column labels. — labels","text":"functions allow row column labels tabular object retrieved modified.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve or modify the row or column labels. — labels","text":"","code":"rowLabels(x) rowLabels(x) <- value colLabels(x) colLabels(x) <- value # S3 method for tabularRowLabels [(x, i, j, ..., drop = FALSE) # S3 method for tabularColLabels [(x, i, j, ..., drop = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve or modify the row or column labels. — labels","text":"x \"tabular\", \"tabularRowLabels\" \"tabularColLabels\" object. value replacement , j, ..., drop Arguments used subsetting labels.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve or modify the row or column labels. — labels","text":"Subsetting row labels allow number rows changed; likewise, subsetting column labels allow number columns changed.  change ,  subset original \"tabular\" object.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve or modify the row or column labels. — labels","text":"rowLabels corresponding subsetting method return object class \"tabularRowLabels\". colLabels corresponding subsetting method  return object class \"tabularColLabels\". assignment functions return \"tabular\" objects.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve or modify the row or column labels. — labels","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) colLabels(tab) #>      [,1] [,2]         [,3] [,4]        [,5] #> [1,]      Sepal.Length <NA> Sepal.Width <NA> #> [2,] n    mean         sd   mean        sd   #> Attributes:  dim, justification, colnamejust, justify, suppress, nearData, class  colLabels(tab) <- colLabels(tab)[1,] tab #>                                                    #>  Species        Sepal.Length      Sepal.Width      #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44"},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Display a tabular object using LaTeX. — latex.tabular","title":"Display a tabular object using LaTeX. — latex.tabular","text":"similar print.tabular, inserts code display table LaTeX tabular environment.  toLatex.tabular method works toLatex generic utils.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display a tabular object using LaTeX. — latex.tabular","text":"","code":"toLatex(object, ...) # S3 method for tabular toLatex(object, file = \"\", options = NULL, append = FALSE, ...) latex.tabular(object, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display a tabular object using LaTeX. — latex.tabular","text":"object tabular object. file filename connection write LaTeX code, \"\" write standard output. options list options set duration call. append TRUE, opens file appending (filename rather connection). ... Settings default formatting.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display a tabular object using LaTeX. — latex.tabular","text":"toLatex() method produces LaTeX output suitable inclusion Sweave document. latex.tabular function set work method latex generic Hmisc, registered method, tables can work Hmisc installed.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Display a tabular object using LaTeX. — latex.tabular","text":"historical reasons, toLatex() function non-empty file argument write file returned value printed.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display a tabular object using LaTeX. — latex.tabular","text":"toLatex() method returns x invisibly, prints LaTeX script console. table_options() booktabs() return previous settings.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display a tabular object using LaTeX. — latex.tabular","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) toLatex(tab) #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} save <- booktabs() toLatex(tab) #> \\begin{tabular}{lccccc} #> \\toprule #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\ \\cmidrule(lr){3-4}\\cmidrule(lr){5-6} #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\midrule #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\bottomrule  #> \\end{tabular} table_options(save)"},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":null,"dir":"Reference","previous_headings":"","what":"Process numeric LaTeX or HTML values. — latexNumeric","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"takes formatted strings produced format numeric values, modifies LaTeX HTML code retains spacing, renders minus signs properly.  default formatting tabular uses maintain proper alignment.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"","code":"latexNumeric(chars, minus = TRUE, leftpad = TRUE, rightpad = TRUE, mathmode = TRUE) htmlNumeric(chars, minus = TRUE, leftpad = TRUE, rightpad = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"chars character vector numeric values. minus Whether pad cases minus sign spacing width. leftpad,rightpad Whether pad cases leading trailing blanks spacing matching digit width per space. mathmode Whether wrap result dollar signs, LaTeX renders minus signs properly.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"character vector length chars, modifications render properly LaTeX.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"","code":"latexNumeric(format(c(1.1,-1,10,-10))) #> [1] \"$\\\\phantom{0}\\\\phantom{-}1.1$\" \"$\\\\phantom{0}-1.0$\"            #> [3] \"$\\\\phantom{-}10.0$\"            \"$-10.0$\"                       htmlNumeric(format(c(1.1,-1,10,-10))) #> [1] \"&#x2007;&#x2007;1.1\" \"&#x2007;&minus;1.0\"  \"&#x2007;10.0\"        #> [4] \"&minus;10.0\""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":null,"dir":"Reference","previous_headings":"","what":"Create table in full table environment — latexTable","title":"Create table in full table environment — latexTable","text":"tabular function creates table usually  renders tabular environment displayed LaTeX,  \"float\" caption, label, etc.  function wraps tabular result result call knitr::kable function.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create table in full table environment — latexTable","text":"","code":"latexTable(table, format = \"latex\", longtable = FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create table in full table environment — latexTable","text":"table Either formula passed tabular, result call function. format Currently \"latex\" format output supported. longtable, ... Additional arguments passed knitr::kable function.  See details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create table in full table environment — latexTable","text":"Rather redoing work generating LaTeX code wrap tabular result, function works generating dummy kable table, replaces tabular part tabular result. Many arguments kable deal content table, wrapper.  ignored warning.  Currently arguments ignored, defaults, : caption = NULL caption use table. label = NULL Part LaTeX label use table.  full label \"tab:\" prepended  kable. escape = TRUE Whether escape special characters caption. booktabs = FALSE, longtable = FALSE Logical values indicate style table.  must also specified tabular; see main vignette details. position = \"\" instruction LaTeX position float document. centering = TRUE Whether center table float. caption.short = \"\" Abbreviated caption use TOC. table.envir = (!.null(caption)) \"table\" Name outer environment. arguments defined knitr package,  may change future.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create table in full table environment — latexTable","text":"object class \"knitr_kable\" suitable include Sweave knitr  .Rnw document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create table in full table environment — latexTable","text":"","code":"cat(latexTable(tabular((Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ),     caption = \"Iris sepal data\", label = \"sepals\")) #> \\begin{table} #>  #> \\caption{\\label{tab:sepals}Iris sepal data} #> \\centering #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} #>  #> \\end{table}"},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"formatters package provides methods displaying breaking tables smaller pieces.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"","code":"matrix_form.tabular(df)"},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"df tabular object.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"formatters package provides matrix_form generic function S4 objects.  \"tabular\" objects S3 objects, dispatch function,  must fully specified called.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"Duncan Murdoch help Gabe Becker.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"","code":"if (requireNamespace(\"formatters\")) {   Sex <- factor(sample(c(\"Male\", \"Female\"), 100, rep=TRUE))   Status <- factor(sample(c(\"low\", \"medium\", \"high\"), 100, rep=TRUE))   z <- rnorm(100) + 5   fmt <- function(x) {   s <- format(x, digits=2)   even <- ((1:length(s)) %% 2) == 0   s[even] <- sprintf(\"(%s)\", s[even])   s }   tab <- tabular( Justify(c)*Heading()*z*Sex*Heading(Statistic)*Format(fmt())*(mean+sd)                    ~ Status )   mform <- matrix_form.tabular(tab)   page <- 1   cat(\"Page \", page, \" Full table\\n\\n\")   cat(formatters::toString(mform))      # This shows automatic pagination, breaking up the   # table by rows   byrow <- formatters::pag_indices_inner(formatters::mf_rinfo(mform),                               rlpp = 2,                               min_siblings = 1)   for (i in seq_along(byrow)) {     mform2 <- matrix_form.tabular(tab[byrow[[i]], ])     page <- page + 1     cat(\"\\nPage \", page, \" Rows\", byrow[[i]], \"\\n\\n\")     cat(formatters::toString(mform2))   }      # This gives the breaks by columns, counting the   # row label columns.     # The formatters::vert_pag_indices function had an incompatible   # change in v0.5.8   if (\"fontspec\" %in% names(formals(formatters::vert_pag_indices)))     bycol <- formatters::vert_pag_indices(mform, cpp = 30,  rep_cols = 2,                                         fontspec = NULL)   else     bycol <- formatters::vert_pag_indices(mform, cpp = 30,  rep_cols = 2)   # Display the table with both kinds of breaks   for (i in seq_along(byrow)) {     rows <- byrow[[i]]     for (j in seq_along(bycol)) {       cols <- bycol[[j]]       cols <- cols[cols > 2] - 2  # cols includes the row labels       mform3 <- matrix_form.tabular(tab[rows, cols, drop = FALSE])       page <- page + 1       cat(\"\\nPage \", page, \"Rows\", rows, \"column\", cols, \"\\n\\n\")       cat(formatters::toString(mform3))     }   } } #> Loading required namespace: formatters #> Page  1  Full table #>  #>                          Status          #>                  high     low     medium #> ———————————————————————————————————————— #> Female   mean    5.39     5.04     4.93  #>           sd    (0.84)   (0.92)   (0.90) #>  Male    mean    5.07     5.16     4.62  #>           sd    (0.92)   (0.97)   (0.84) #>  #> Page  2  Rows 1 2  #>  #>                          Status          #>                  high     low     medium #> ———————————————————————————————————————— #> Female   mean    5.39     5.04     4.93  #>           sd    (0.84)   (0.92)   (0.90) #>  #> Page  3  Rows 3 4  #>  #>                        Status          #>                high     low     medium #> —————————————————————————————————————— #> Male   mean    5.07     5.16     4.62  #>         sd    (0.92)   (0.97)   (0.84) #>  #> Page  4 Rows 1 2 column 1  #>  #>                 Status #>                  high  #> —————————————————————— #> Female   mean    5.39  #>           sd    (0.84) #>  #> Page  5 Rows 1 2 column 2  #>  #>                 Status #>                  low   #> —————————————————————— #> Female   mean    5.04  #>           sd    (0.92) #>  #> Page  6 Rows 1 2 column 3  #>  #>                 Status #>                 medium #> —————————————————————— #> Female   mean     4.9  #>           sd    (0.9)  #>  #> Page  7 Rows 3 4 column 1  #>  #>               Status #>                high  #> ———————————————————— #> Male   mean    5.07  #>         sd    (0.92) #>  #> Page  8 Rows 3 4 column 2  #>  #>               Status #>                low   #> ———————————————————— #> Male   mean    5.16  #>         sd    (0.97) #>  #> Page  9 Rows 3 4 column 3  #>  #>               Status #>               medium #> ———————————————————— #> Male   mean    4.62  #>         sd    (0.84)"},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":null,"dir":"Reference","previous_headings":"","what":"Set or query options for the table formatting. — table_options","title":"Set or query options for the table formatting. — table_options","text":"functions set query options table formatting LaTeX HTML output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set or query options for the table formatting. — table_options","text":"","code":"table_options(...) booktabs(...) htmloptions(head=TRUE, table=TRUE, pad=FALSE,              ...)"},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set or query options for the table formatting. — table_options","text":"head logical; enables HTML header options table logical; enables output parts table pad logical; enables HTML padding options ... options listed Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set or query options for the table formatting. — table_options","text":"table_options() function sets number options control formatting.  Currently  options affect LaTeX HTML output : justification = \"c\" Default justification data columns table. rowlabeljustification = \"l\" Default justification row labels. doBegin, doHeader, doBody, doFooter, doEnd logical values (defaults TRUE) control inclusion specific parts output table. knit_print = TRUE auto formatting printing knitr document. options used LaTeX output: tabular = \"tabular\" LaTeX environment use table.  choices \"longtable\" might make sense. toprule, midrule, bottomrule LaTeX macros use lines table.  default \"\\hline\". titlerule = NULL LaTeX macro use underline multicolumn titles.  NULL, underlining done. latexleftpad, latexrightpad, latexminus, mathmode control formatting numbers table.  TRUE (default), blanks R's formatting converted hard spaces LaTeX output, negative signs rendered properly.  Generally makes output look better, .tex input may harder read. options used HTML output: doHTMLheader, doCSS, doHTMLbody control output material top HTML page. HTMLhead, CSS, HTMLbody default strings output corresponding element selected. present, string \"CHARSET\" replaced result localeToCharset() HTMLhead.  string \"#ID\" replaced \"#\" followed id argument html.tabular (removed blank). HTMLcaption optional HTML caption table.  NULL, caption emitted. HTMLleftpad, HTMLrightpad, HTMLminus control formatting numbers table.  TRUE, blanks R's formatting converted hard spaces HTML output, negative signs rendered properly.  Generally makes output look better,  cut paste table may include special characters recognized software.  default FALSE. HTMLattributes string add \"<table>\" declaration top table.  default, attributes 'frame=\"hsides\" rules=\"groups\"'. set horizontal rules top bottom table header, body, footer (present). HTMLfooter NULL footer, HTML code insert table.  Note HTML footer specified body table; html.tabular written call. may set persistently calling table_options(), just duration call passing list via latex(options=list( ... )).  Additional  ... arguments latex passed format. booktabs() function sets table_options() values different defaults,  suitable use booktabs LaTeX package. htmloptions() function constructs list suitable options argument html.tabular, grouping options rarely differ . Note LaTeX code can used rule options; example, see longtable example vignette.  Material go headers goes toprule, material headers body goes midrule, material bottom table goes bottomrule.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set or query options for the table formatting. — table_options","text":"table_options() booktabs() return previous settings. htmloptions() returns list settings without changing defaults.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set or query options for the table formatting. — table_options","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) toLatex(tab) #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} save <- booktabs() toLatex(tab) #> \\begin{tabular}{lccccc} #> \\toprule #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\ \\cmidrule(lr){3-4}\\cmidrule(lr){5-6} #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\midrule #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\bottomrule  #> \\end{tabular} table_options(save)  # \\donttest{ f <- tempfile(fileext = \".html\") if (interactive())   toHTML(tab, f,      options=htmloptions(HTMLcaption=\"Table of Iris Data\",                       pad = TRUE)) # }"},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute complex table — tabular","title":"Compute complex table — tabular","text":"Computes table summary statistics, cross-classified various variables.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute complex table — tabular","text":"","code":"tabular(table, ...) # S3 method for default tabular(table, ...) # S3 method for formula tabular(table, data = NULL, n, suppressLabels = 0, ...) # S3 method for tabular print(x, justification=\"n\", ...) # S3 method for tabular format(x, digits=4, justification=\"n\", latex=FALSE, html=FALSE,                           leftpad = TRUE, rightpad = TRUE, minus = TRUE,  \t\t\t mathmode = TRUE, ...) # S3 method for tabular [(x, i, j, ..., drop=FALSE) # S3 method for tabular cbind(..., deparse.level = 1) # S3 method for tabular rbind(..., deparse.level = 1)"},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute complex table — tabular","text":"table table expression.  See Details . data optional dataframe, list environment look variables table. n optional value giving length data.  See Details . suppressLabels many initial labels suppress? x object print, format, subset. digits, ... print format methods, many significant digits parameters show default?  See Formatting . justification default justification use table. latex TRUE, latexNumeric function applied formatting numeric columns format, maintain spacing handle signs properly. html TRUE, htmlNumeric function applied formatting numeric columns format, maintain spacing handle signs properly. leftpad, rightpad, minus, mathmode Options pass latexNumeric htmlNumeric control details formatting.  See pages details. , j, drop usual arguments matrix indexing, see Details . deparse.level Ignored.  (Present generic requires .)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute complex table — tabular","text":"purposes function, \"table\" rectangular array values, computed using formula expression.  left hand side formula describes rows table, right hand side describes columns. Within expression rows columns, operators +, * = special meanings. + operator represents concatenation, x + y ~ z says show rows corresponding x rows corresponding y. * operator represents nesting, x*y ~ z says show rows y within row corresponding x. = operator sets new name term; abbreviation Heading() pseudo-function.  (“Pseudo-functions” described tables vignette.)  Note = low operator precedence may confused parser setting function arguments, parentheses usually needed. Parentheses may used group terms usual arithmetic way,  (x + y)*(u + v) equivalent x*u + x*v + y*u + y*v. names Format, .Format Heading special meaning; see section Formatting . interpretation terms formulas depends evaluate. term evaluates function, summary function  produces scalar value applied vector values, scalar displayed table.  example,  (mean + var) ~ x  display mean x variance x.  function specified, length assumed, table display counts.  (one summary function may specified one term, mean*var error.) term evaluates logical vector, assumed specify subset.  example,  ~ (x > 3) + (x > 5) tabulate counts two subsets. term evaluates factor, generates multiple rows columns, corresponding different levels factor.  example three levels, ~ mean*x calculate mean x within level . term evaluates language object, treated macro, expanded  place formula. terms assumed R expressions producing vector values summarized table.  one vector values can specified given term, different terms can summarize different values.  .atomic must  evaluate TRUE values recognized. logical, factor values table length, columns dataframe (can computed values).  n missing data dataframe, n set .  Otherwise, terms 1 appear table, length assumed previous terms. last resort, set n argument call tabular() explicitly. \"[\" method extracts subset table. indexing, consider table consist matrix containing values. drop=TRUE, labels attributes dropped.  drop=FALSE, default, j indices must select  rectangular block table; matrix indexing (using two column matrix full matrix logical values) supported.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"formatting","dir":"Reference","previous_headings":"","what":"Formatting","title":"Compute complex table — tabular","text":"tabular() function formatting computed values,  records requests formatting. format.tabular(), print.tabular() latex.tabular()  functions make use requests. default, columns formatted using format function, arguments digits arguments passed ....  column formatted separately, similarly matrix printed default. request special formatting, four pseudo-functions provided.  first Format.  Normally includes arguments pass format() function, e.g. Format(digits=2).  may instead include call function, e.g. Format(sprintf(\"%.2f\").  either case summary values cells table nested Format specification passed function argument named x, .e. first example, values formatted using format(digits=2, x=values),  second, using sprintf(\"%.2f\", x=values).  Users can supply function used formatting; take values named argument x return character vector length. can used control formatting multiple columns .  example, Format(digits=2)*(mean + sd) print mean standard deviation single call format, guaranteeing number decimal places used .  (iris example demonstrates .) latex argument latex.tabular TRUE,  effort made retain spacing, convert minus signs  appropriate type dash using latexNumeric function. second pseudo-function .Format mainly intended internal use.  takes single integer argument, saying data governed call uses formatting another format specification.  way entries can commonly formatted even contiguous.  integers assigned sequentially format specification parsed; users likely need trial error find right value complicated table multiple formats. third pseudo-function Justify.  takes character values names arguments; treated depends output format.  format.tabular, coarse justification done left, right center, using l, r c respectively. LaTeX formatting, string acceptable justification string LaTeX passed . final pseudo-function Heading.  Use function row definitions set heading following column row labels.  (Internally headings factor columns implemented.) called argument, suppresses following heading.  suppressLabels=n argument tabular() equivalent repeating Heading() n times start table formula.  = operator abbreviation Heading(); see .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"tabular-methods","dir":"Reference","previous_headings":"","what":"tabular methods","title":"Compute complex table — tabular","text":"default tabular method just applies .formula table, calls tabular.formula. tabular.formula method main workhorse package.  authors wish produce tables directly structures normally create formula whose environment contains mentioned variables call tabular.formula appropriate arguments.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute complex table — tabular","text":"object S3 class \"tabular\".  matrix mode list, whose entries computed summary values, following attributes: rowLabels matrix labels rows.  number rows main matrix, may multiple columns different nested levels labels. label covers multiple rows, entered first row, NA used fill following rows. colLabels Like rowLabels, labelling columns. table original table expression displayed.  list original format specifications attached \"fmtlist\" attribute. formats matrix shape main result, containing NA default formatting, index format list.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Compute complex table — tabular","text":"function inspired 20 year old memories SAS TABULATE procedure.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute complex table — tabular","text":"Duncan Murdoch","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute complex table — tabular","text":"","code":"tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) #>                                                    #>                 Sepal.Length      Sepal.Width      #>  Species    n   mean         sd   mean        sd   #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44  # This example shows some of the less common options          Sex <- factor(sample(c(\"Male\", \"Female\"), 100, rep=TRUE)) Status <- factor(sample(c(\"low\", \"medium\", \"high\"), 100, rep=TRUE)) z <- rnorm(100)+5 fmt <- function(x) {   s <- format(x, digits=2)   even <- ((1:length(s)) %% 2) == 0   s[even] <- sprintf(\"(%s)\", s[even])   s } tab <- tabular( Justify(c)*Heading()*z*Sex*Heading(Statistic)*Format(fmt())*(mean+sd)                  ~ Status ) tab #>                                        #>                   Status               #>   Sex   Statistic  high   low   medium #>  Female   mean     5.12   4.70   5.24  #>            sd     (0.78) (1.06) (1.07) #>   Male    mean     4.95   4.81   4.61  #>            sd     (0.94) (0.99) (1.09) tab[1:2, c(2,3,1)] #>                                        #>                   Status               #>   Sex   Statistic  low   medium  high  #>  Female   mean     4.70   5.24   5.12  #>            sd     (1.06) (1.07) (0.78)"},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to knitr_kable format. — toKable","title":"Convert tabular object to knitr_kable format. — toKable","text":"Converts output tabular related functions format consistent output kable function, can  customized using kableExtra package.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to knitr_kable format. — toKable","text":"","code":"toKable(table, format = getKnitrFormat(), booktabs = TRUE, ...) getKnitrFormat(default = \"latex\")"},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to knitr_kable format. — toKable","text":"table object class tabular. format type knitr_kable object desired; currently \"latex\" \"html\" supported. booktabs table rendered booktabs style? affects LaTeX output. ... Additional arguments pass html.tabular latex.tabular. default default type output running knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to knitr_kable format. — toKable","text":"object class knitr_kable, suitable passing functions kableExtra package.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to knitr_kable format. — toKable","text":"","code":"if (requireNamespace(\"kableExtra\") &&      (!requireNamespace(\"pkgdown\") || !pkgdown::in_pkgdown())) {   tab <-  tabular( (Species + 1) ~ (n=1) + Format(digits=2)*           (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )   print(kableExtra::kable_styling(toKable(tab), latex_options = \"striped\"))   cat(\"\\n\")   toKable(tab, format = \"html\", options = list(HTMLcaption = \"Fisher's iris data\")) } #> Loading required namespace: kableExtra"},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to tinytable format. — toTinytable","title":"Convert tabular object to tinytable format. — toTinytable","text":"Converts output tabular related functions format consistent output tt function, can  customized using tinytable package.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to tinytable format. — toTinytable","text":"","code":"toTinytable(table, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to tinytable format. — toTinytable","text":"table object class tabular. ... Additional arguments pass tt.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to tinytable format. — toTinytable","text":"object class tinytable, suitable passing functions tinytable package. tables can exported several formats, including LaTeX, HTML, Markdown, Word, Typst, PDF, PNG.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to tinytable format. — toTinytable","text":"","code":"if (requireNamespace(\"tinytable\")) {    tab <-  tabular( (Species + 1) ~ (n=1) + Format(digits=2)*           (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )   tab <- toTinytable(tab, theme = \"striped\")   tab <- tinytable::style_tt(tab, i = 1:2, background = \"teal\", color = \"white\")   tab  } #> +------------+-----+-------+-------+-------+-------+ #> |                  | Sepal.Length  | Sepal.Width   | #> +------------+-----+-------+-------+-------+-------+ #> | Species    | n   | mean  | sd    | mean  | sd    | #> +============+=====+=======+=======+=======+=======+ #> | setosa     |  50 | 5.01  | 0.35  | 3.43  | 0.38  | #> +------------+-----+-------+-------+-------+-------+ #> | versicolor |  50 | 5.94  | 0.52  | 2.77  | 0.31  | #> +------------+-----+-------+-------+-------+-------+ #> | virginica  |  50 | 6.59  | 0.64  | 2.97  | 0.32  | #> +------------+-----+-------+-------+-------+-------+ #> | All        | 150 | 5.84  | 0.83  | 3.06  | 0.44  | #> +------------+-----+-------+-------+-------+-------+"},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":null,"dir":"Reference","previous_headings":"","what":"Format table with groups of lines — useGroupLabels","title":"Format table with groups of lines — useGroupLabels","text":"factor level applies multiple lines table, normally extra column row labels added  show levels.  function merges column another column labels.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Format table with groups of lines — useGroupLabels","text":"","code":"useGroupLabels(tab, col = 1,                 indent = \"  \",                 newcolumn = 1,                singleRow = TRUE,                extraLines = 0)"},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Format table with groups of lines — useGroupLabels","text":"tab tabular object. col column defines groups? indent prefix add existing entries new column. newcolumn column gets  group headings? singleRow group single row entry newcolumn row, put group label row rather separate row. extraLines Add many blank lines separate groups addition line containing group label.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Format table with groups of lines — useGroupLabels","text":"tabular object, modified include header rows specified.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Format table with groups of lines — useGroupLabels","text":"newcolumn less 1 greater  number row label columns (removing column col), extra columns added.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Format table with groups of lines — useGroupLabels","text":"","code":"set.seed(123) n <- 10 df <- data.frame(a = factor(sample(1:3, n, replace=TRUE)),                  b = factor(sample(1:3, n, replace=TRUE)),                  x = rnorm(n)) levels(df$a) <- c(\"Long name 1\", \"Long name 2\", \"Long name 3\") levels(df$b) <- c(\"a\", \"abc\", \"abcdef\") library(tables) tab <- tabular(a*Heading()*b ~ mean*x, data = df) tab <- tab[!is.na(tab[,1])] useGroupLabels(tab) #>                      #>              mean    #>              x       #>  Long name 1         #>    a         -0.2159 #>  Long name 2         #>    a          0.8255 #>    abc       -1.0489 #>    abcdef    -0.4200 #>  Long name 3         #>    a         -0.2476 #>    abc        1.5387 #>    abcdef     1.2948"},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Write table to file in CSV or other format. — write.csv.tabular","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"writes formatted table CSV delimeted file, import spreadsheet  report writer.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"","code":"write.csv.tabular(x, file=\"\",      justification = \"n\", row.names=FALSE, ...) write.table.tabular(x, file=\"\",      justification = \"n\", row.names=FALSE, col.names=FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"x object tabular. file filename connection write. justification Parameter pass format.tabular. row.names, col.names Parameters pass write.csv write.table ... Parameters pass format.tabular write.table; see Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"write.csv.tabular writes simple version table (similar produced print.tabular) given connection CSV format, using write.csv. write.table.tabular similarly using general write.table. optional arguments ... sent write.csv/write.table names exactly match parameters write.table; otherwise, sent format.tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"return value write.csv write.table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"","code":"if (FALSE) { # This writes a table to the clipboard on Windows using tab delimiters, for # easy import into a spreadsheet.  write.table.tabular(      tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ),     \"clipboard\", sep=\"\\t\") }"},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0927","dir":"Changelog","previous_headings":"","what":"tables 0.9.27","title":"tables 0.9.27","text":"factor level \"\" caused error displayed. now changed \" \" display (issue #19). VignetteBuilder field DESCRIPTION changed rmarkdown Pandoc can found even PATH. Another minor update due changes formatters package.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0925","dir":"Changelog","previous_headings":"","what":"tables 0.9.25","title":"tables 0.9.25","text":"CRAN release: 2024-04-13 PlusMinus() Paste() didn’t handle formatting properly multiple columns involved (issue #13). toLatex() non-empty file argument didn’t write file properly. (Reported Reinhard Kerschner F. Hortner.) cases () give error (issue #17). toTinytable() function added work tinytable package. Minor update due changes formatters package.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0917","dir":"Changelog","previous_headings":"","what":"tables 0.9.17","title":"tables 0.9.17","text":"CRAN release: 2023-05-02 Change host Github. Add useGroupLabels() function. Add HTMLfootnotes() function. Add method formatters::matrix_form.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0910","dir":"Changelog","previous_headings":"","what":"tables 0.9.10","title":"tables 0.9.10","text":"CRAN release: 2022-10-17 rbind() failed complicated example, classes names column labels differed. Error messages rbind() cbind() made helpful.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-098","dir":"Changelog","previous_headings":"","what":"tables 0.9.8","title":"tables 0.9.8","text":"() didn’t work tibbles. (Reported Vincent Arel-Bundock.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-097","dir":"Changelog","previous_headings":"","what":"tables 0.9.7","title":"tables 0.9.7","text":"toHTML() ignoring file argument.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-094","dir":"Changelog","previous_headings":"","what":"tables 0.9.4","title":"tables 0.9.4","text":"CRAN release: 2020-08-28 Minor update fix test note.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-093","dir":"Changelog","previous_headings":"","what":"tables 0.9.3","title":"tables 0.9.3","text":"CRAN release: 2020-05-26 Added latexTable() function, provide captions, labels, etc. Added knitrTable vignette.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-09","dir":"Changelog","previous_headings":"","what":"tables 0.9","title":"tables 0.9","text":"Reduced dependence Hmisc.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-088","dir":"Changelog","previous_headings":"","what":"tables 0.8.8","title":"tables 0.8.8","text":"CRAN release: 2019-05-13 Updates fix CRAN errors.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-087","dir":"Changelog","previous_headings":"","what":"tables 0.8.7","title":"tables 0.8.7","text":"CRAN release: 2018-11-11 Added … argument toKable() options can passed control conversion. (Thanks Mary Putt pointing need .) Fixed bug .tabular.data.frame() failed columns factors. (Reported Daniel Farewell.) Fixed incompatibility new version fancyvrb. (Thanks Prof. Brian Ripley working solution.) Fixed incompatibility rmarkdown/knitr new version.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-084","dir":"Changelog","previous_headings":"","what":"tables 0.8.4","title":"tables 0.8.4","text":"CRAN release: 2018-05-21 Added check bad args DropEmpty(), fixed example . Added “nearData” argument Heading() etc, fix Hline() bug reported Johannes Ranke. Fixed bug justification row labels. Fixed bug statistic wrong length, reported Stefan Marr. Added toKable() function, use kableExtra package. Added knit_print.tabular() method, tabular objects print correct formatting knitr documents.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-08","dir":"Changelog","previous_headings":"","what":"tables 0.8","title":"tables 0.8","text":"CRAN release: 2017-01-03 Allow editing row column labels. Added DropEmpty() pseudo-function. Added AllObs() RowNum() formula functions. Added character.argument Heading() Paste().","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0791","dir":"Changelog","previous_headings":"","what":"tables 0.7.91","title":"tables 0.7.91","text":"Updated options html.tabular use better CSS HTML5 tables. Added HTML vignette. Fixed bug: functions prefixed “pkg::” formulas led warning messages. (Reported Lars Bishop.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0788","dir":"Changelog","previous_headings":"","what":"tables 0.7.88","title":"tables 0.7.88","text":"Edited messages allow internationalization. translations added far.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0787","dir":"Changelog","previous_headings":"","what":"tables 0.7.87","title":"tables 0.7.87","text":"Added “append” argument latex.tabular() html.tabular(), made explicit connections allowed “file” argument. (Suggestion Marc Halperin.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0786","dir":"Changelog","previous_headings":"","what":"tables 0.7.86","title":"tables 0.7.86","text":"Fixed scoping bug: locally defined format functions always found. (Reported Doug Ezra Morrison.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0779","dir":"Changelog","previous_headings":"","what":"tables 0.7.79","title":"tables 0.7.79","text":"CRAN release: 2014-07-24 Added Equal() Unequal() pseudo-functions flexible Percent() calculations. Fixed bug handling factors excluded NA values. Added “formula” attribute tabular.formula results. Added .tabular() function. Added Arguments() function allow multi-argument analysis functions.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0768","dir":"Changelog","previous_headings":"","what":"tables 0.7.68","title":"tables 0.7.68","text":"Bug fix setting column headings (reported Lars Bishop).","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0767","dir":"Changelog","previous_headings":"","what":"tables 0.7.67","title":"tables 0.7.67","text":"cbind() rbind() methods now allow NULL list arguments. (Suggestion Jeff Newmiller.) Added note vignette use RowFactor nopagebreak longtable environment. (Based sleuthing Jeffrey Miller.) Added HTMLcaption table options insert HTML caption. (Suggestion Joseph Larmarange.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0764","dir":"Changelog","previous_headings":"","what":"tables 0.7.64","title":"tables 0.7.64","text":"CRAN release: 2013-11-12 Added support HTML output. Added support extraction subsets matrix. Added Paste() function. summary doesn’t produce scalar value, formatting messed display. Now warning issued cell displayed  similar. Added cbind() rbind() methods tabular objects. internal texify() function work properly.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0748","dir":"Changelog","previous_headings":"","what":"tables 0.7.48","title":"tables 0.7.48","text":"Default formatting now skips character cells. Justification labels text mode wasn’t done properly.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-07","dir":"Changelog","previous_headings":"","what":"tables 0.7","title":"tables 0.7","text":"CRAN release: 2012-12-14 RowFactor now allows spacing=1. Specifications justification table_options() now recycled. Missing values handled correctly computing counts, working factors. (Reported Manuel Reif.) Added Percent() pseudo-function. Cleaned handling row column labels, especially cases rows different column headings summed. Added optional parameter Heading() use another hasn’t already set.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-06","dir":"Changelog","previous_headings":"","what":"tables 0.6","title":"tables 0.6","text":"CRAN release: 2012-04-02 Fixed bug column headings print.tabular (reported Tal Galili) Added Factor(). Fixed bug zero columns row labels. Added levelnames argument RowFactor Factor allow label customization. Added Multicolumn function. Added .matrix(), write.csv.tabular() write.table.tabular() (suggestions Greg Snow). Added LaTeX escapes text body labels constructed () factor labels. (Suggestion Dieter Menne.) Added caption longtable example. (Suggestion Dieter Menne.) Added version number vignette title page. Fixed RowFactor add space first row, last row. (Bug report Dieter Menne.) Made tabular() generic function. (Suggestion Hadley Wickham.) Added description missing values vignette. Fixed handling data Hmisc “labelled” class attached. (Reported Thomas MacFarland.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-05","dir":"Changelog","previous_headings":"","what":"tables 0.5","title":"tables 0.5","text":"CRAN release: 2011-12-07 Planned CRAN release ","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-04","dir":"Changelog","previous_headings":"","what":"tables 0.4","title":"tables 0.4","text":"Added (), Literal() RowFactor() Added table_options() booktabs() booktabs support Gave different defaults row label justification data justification Suppress page breaks RowFactor(). Allow options set temporarily latex() call. Added options suppress parts output.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-03","dir":"Changelog","previous_headings":"","what":"tables 0.3","title":"tables 0.3","text":"CRAN release: 2011-11-29 Renamed “tabular” “tables”, put R-forge","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-02","dir":"Changelog","previous_headings":"","what":"tables 0.2","title":"tables 0.2","text":"First reasonably complete release","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-01","dir":"Changelog","previous_headings":"","what":"tables 0.1","title":"tables 0.1","text":"First alpha version Hmisc support","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-00","dir":"Changelog","previous_headings":"","what":"tables 0.0","title":"tables 0.0","text":"Various abortive attempts","code":""}]
+[{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"initializing","dir":"Articles","previous_headings":"","what":"Initializing","title":"HTML Tables","text":"First, need load tables. Packages uses print banner messages, ’ll usually want set chunk option message=FALSE. table now constructed usual way. R Markdown document, don’t want table output HTML document header, turn options:","code":"library(tables) X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE)) tab <- tabular( Group ~ (N=1)+Format(digits=2)*X*((Mean=mean) + Heading(\"Std Dev\")*sd) ) table_options(htmloptions(head=FALSE))"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"inserting-a-table","dir":"Articles","previous_headings":"","what":"Inserting a Table","title":"HTML Tables","text":"two ways insert table knitr/rmarkdown document. Since tables version 0.8.4, can just print object, automatically formatted according current table_options(): previous behaviour required explicit call toHTML() function, knitr option results = 'asis' chunk. require older method, use table_options(knit_print = FALSE): either case, styling information needs included document. Ideally header, can inserted anywhere calling writeCSS results = 'asis':","code":"tab table_options(knit_print = FALSE) tab        # This chunk uses the default results = 'markup' ##                         ##           X             ##  Group N  Mean  Std Dev ##  a     20 -30.9  88.6   ##  b     33   4.2 130.8   ##  c     21  37.8  97.4   ##  d     28  15.3 107.5   ##  e     23  -1.4  67.1 toHTML(tab)  # This chunk uses results = 'asis' writeCSS()"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"improving-the-look","dir":"Articles","previous_headings":"","what":"Improving the Look","title":"HTML Tables","text":"default justification makes columns numbers look messy. can set justification right, headers look wrong: best look comes pad = TRUE option. adds nonbreaking spaces around numbers centering looks good. also changes hyphens proper minus signs: Unfortunately, cut table paste spreadsheet, spaces minus signs probably won’t understood. don’t know get everything want :-(.","code":"table_options(htmloptions(head = FALSE, justification = \"r\", knit_print = TRUE)) tab table_options(htmloptions(head = FALSE, justification = \"c\", pad = TRUE)) tab"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"fine-tuning","dir":"Articles","previous_headings":"","what":"Fine tuning","title":"HTML Tables","text":"document uses default CSS table_options()$CSS. producing html_document, okay. look quite right slidy_presentation, good ioslides_presentation. Furthermore, might agree design choices. cases, substitute CSS. need modify default one, can use CSS argument writeCSS(), set new default table_options(). default setting: Note #ID values replaced id string given writeCSS(), toHTML() corresponding argument allow make changes one specific table. using newer form display table_options(knit_print = TRUE), can get customized display one table also using table_options(doCSS = TRUE). example,","code":"<style> #ID .Rtable thead, .Rtable .even {   background-color: inherit; } #ID .left   { text-align:left; } #ID .center { text-align:center; } #ID .right  { text-align:right; } #ID .Rtable, #ID .Rtable thead {    border-collapse: collapse;   border-style: solid;   border-width: medium 0;   border-color: inherit; } #ID .Rtable th, #ID .Rtable td {   padding-left: 0.5em;   padding-right: 0.5em;   border-width: 0; } <\/style> table_options(CSS = \"<style> #ID .center {    text-align:center;   background-color: aliceblue; } <\/style>\", doCSS = TRUE) tab table_options(doCSS = FALSE) tab"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"kableextra-support","dir":"Articles","previous_headings":"","what":"kableExtra support","title":"HTML Tables","text":"kableExtra package contains large number functions customize look tables generated knitr::kable() function. can also made work tables package, using toKable() function. example, conflicts styling options kableExtra ones specified table_options()$CSS; modifications might needed make everything work. instance, code requests striping, show . Experimentation may needed!","code":"library(magrittr) library(kableExtra) toKable(tab, format=\"html\") %>%    kable_styling(\"striped\", full_width = FALSE) %>%   add_header_above(c(\"Row Label\" = 1, \"Statistics\" = 3)) %>%   column_spec(4, color = \"red\") %>%   row_spec(1, color = \"blue\") %>%   group_rows(\"Subgroup\", 3, 5)"},{"path":"https://dmurdoch.github.io/tables/articles/HTML.html","id":"tinytable-support","dir":"Articles","previous_headings":"","what":"tinytable support","title":"HTML Tables","text":"tinytable package another package can used customize look tables generated tables. tinytable can customized, printed saved variety formats, including: HTML, LaTeX, Word, Typst, PNG, PDF, Rmarkdown, Quarto. example,","code":"library(magrittr) library(tinytable) toTinytable(tab, theme = \"striped\") %>%   group_tt(i = list(\"Subgroup\" = 3)) %>%   group_tt(j = list(\"Row Label\" = 1, \"Statistics\" = 2:4)) %>%   style_tt(i = 3, color = \"red\", align = \"c\", line = \"bt\", line_color = \"red\") %>%   style_tt(i = 5:6, j = 3:4, background = \"black\", color = \"orange\")"},{"path":"https://dmurdoch.github.io/tables/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Duncan Murdoch. Maintainer.","code":""},{"path":"https://dmurdoch.github.io/tables/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Murdoch D (2024). tables: Formula-Driven Table Generation. R package version 0.9.28, https://dmurdoch.github.io/tables/.","code":"@Manual{,   title = {tables: Formula-Driven Table Generation},   author = {Duncan Murdoch},   year = {2024},   note = {R package version 0.9.28},   url = {https://dmurdoch.github.io/tables/}, }"},{"path":"https://dmurdoch.github.io/tables/index.html","id":"tables","dir":"","previous_headings":"","what":"Formula-Driven Table Generation","title":"Formula-Driven Table Generation","text":"goal tables compute display complex tables summary statistics. Output may LaTeX, HTML, plain text, R matrix processing.","code":""},{"path":"https://dmurdoch.github.io/tables/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Formula-Driven Table Generation","text":"can install release version orientlib using can install development version tables GitHub :","code":"install.packages(\"tables\") # install.packages(\"devtools\") devtools::install_github(\"dmurdoch/tables\")"},{"path":"https://dmurdoch.github.io/tables/index.html","id":"example","dir":"","previous_headings":"","what":"Example","title":"Formula-Driven Table Generation","text":"basic example shows solve common problem:","code":"library(tables)  set.seed(123)  # In an R Markdown document, you don't want each table # to output the HTML document header, so turn  # off that option:  table_options(htmloptions(head=FALSE))  X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE)) tab <- tabular( Group ~                    (N=1) +                   Format(digits=2)*X*                     ((Mean=mean) +                      Heading(\"Std Dev\")*sd)                )  # To print in plain text: tab #>                          #>           X              #>  Group N  Mean   Std Dev #>  a     31  -6.84  82.50  #>  b     28  13.06  97.04  #>  c     17  -2.24  99.71  #>  d     15   4.45  98.60  #>  e     34   0.87  84.96  # To format in HTML: toHTML(tab) # To generate LaTeX code: strsplit(toLatex(tab)$text, \"\\n\") #> [[1]] #>  [1] \"\\\\begin{tabular}{lccc}\"                                                #>  [2] \"\\\\hline\"                                                               #>  [3] \" &  & \\\\multicolumn{2}{c}{X} \\\\\\\\ \"                                    #>  [4] \"Group  & N & Mean & \\\\multicolumn{1}{c}{Std Dev} \\\\\\\\ \"                #>  [5] \"\\\\hline\"                                                               #>  [6] \"a  & $31$ & $\\\\phantom{0}-6.84$ & $\\\\phantom{-}82.50$ \\\\\\\\\"            #>  [7] \"b  & $28$ & $\\\\phantom{-}13.06$ & $\\\\phantom{-}97.04$ \\\\\\\\\"            #>  [8] \"c  & $17$ & $\\\\phantom{0}-2.24$ & $\\\\phantom{-}99.71$ \\\\\\\\\"            #>  [9] \"d  & $15$ & $\\\\phantom{0}\\\\phantom{-}4.45$ & $\\\\phantom{-}98.60$ \\\\\\\\\" #> [10] \"e  & $34$ & $\\\\phantom{0}\\\\phantom{-}0.87$ & $\\\\phantom{-}84.96$ \\\\\\\\\" #> [11] \"\\\\hline \"                                                              #> [12] \"\\\\end{tabular}\""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":null,"dir":"Reference","previous_headings":"","what":"Include all columns of a dataframe. — All","title":"Include all columns of a dataframe. — All","text":"constructs formula object columns dataframe.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Include all columns of a dataframe. — All","text":"","code":"All(df, numeric=TRUE, character=FALSE, logical=FALSE, factor=FALSE,          complex=FALSE, raw=FALSE, other=FALSE,         texify=getOption(\"tables.texify\", FALSE))"},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Include all columns of a dataframe. — All","text":"df dataframe find columns. numeric, character, logical, factor, complex, raw Whether include columns specified types.  See Details . Whether include columns match none previous types. texify Whether escape LaTeX special characters column names.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Include all columns of a dataframe. — All","text":"function constructs formula columns dataframe. default, numeric columns included.  arguments  numeric, character, logical, factor, complex raw control inclusion columns corresponding types.   argument controls inclusion columns. arguments TRUE, columns included formula. function (name function given character string) passed, columns transformed function inclusion.  example, (df, factor=.character) convert factor columns character representation inclusion. cases, columns skipped.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Include all columns of a dataframe. — All","text":"Language insert table formula achieve desired table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/All.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Include all columns of a dataframe. — All","text":"","code":"# Show mean and sd of all numeric columns in the iris data tabular( Species  ~         All(iris)*(mean + sd), data=iris ) #>                                                                        #>             Sepal.Length        Sepal.Width        Petal.Length        #>  Species    mean         sd     mean        sd     mean         sd     #>  setosa     5.006        0.3525 3.428       0.3791 1.462        0.1737 #>  versicolor 5.936        0.5162 2.770       0.3138 4.260        0.4699 #>  virginica  6.588        0.6359 2.974       0.3225 5.552        0.5519 #>                     #>  Petal.Width        #>  mean        sd     #>  0.246       0.1054 #>  1.326       0.1978 #>  2.026       0.2747"},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":null,"dir":"Reference","previous_headings":"","what":"Display all observations in a table. — AllObs","title":"Display all observations in a table. — AllObs","text":"functions generate code tabular table include observations dataset, possibly divided according factors.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display all observations in a table. — AllObs","text":"","code":"AllObs(data = NULL, show = FALSE, label = \"Obsn.\", within = NULL) RowNum(within = NULL, perrow = 5, show = FALSE, label = \"Row\", data = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display all observations in a table. — AllObs","text":"data full dataset, used find number observations. show Whether show observation number row number table. label label use show = TRUE. within factor list factors break observations. perrow many observations per row RowNum used  row specification, per column part column specification.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display all observations in a table. — AllObs","text":"AllObs used display observations dataset. generates (usually undisplayed) factor different level observation, sets function display value, calls DropEmpty suppress display empty rows, columns cells. within argument specified AllObs,  factor levels restarted within grouping.  (within interpreted INDEX argument tapply, one exception described .)  may useful displaying observation number, definitely useful AllObs used column specification table. also save computation time table large, since fewer factor levels generated  later dropped. RowNum unlikely useful table , helpful displaying large datasets AllObs. allows large number observations broken several rows columns. RowNum affects rows columns, use somewhat unusual.  Normally called calling tabular, result saved variable.  variable (e.g. rownum) used row specification table wrapped (), column specification table within argument AllObs.  (exception mentioned .) Despite name, RowNum can used column specifier, prefer column-major ordering values displayed  table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display all observations in a table. — AllObs","text":"AllObs RowNum return language objects used tabular formulas.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/AllObs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display all observations in a table. — AllObs","text":"","code":"tabular(Factor(cyl)*Factor(gear)*AllObs(mtcars) ~                 rownames(mtcars) + mpg, data=mtcars) #>                                    #>  cyl gear rownames(mtcars)    mpg  #>  4   3    Toyota Corona       21.5 #>      4    Datsun 710          22.8 #>           Merc 240D           24.4 #>           Merc 230            22.8 #>           Fiat 128            32.4 #>           Honda Civic         30.4 #>           Toyota Corolla      33.9 #>           Fiat X1-9           27.3 #>           Volvo 142E          21.4 #>      5    Porsche 914-2       26.0 #>           Lotus Europa        30.4 #>  6   3    Hornet 4 Drive      21.4 #>           Valiant             18.1 #>      4    Mazda RX4           21.0 #>           Mazda RX4 Wag       21.0 #>           Merc 280            19.2 #>           Merc 280C           17.8 #>      5    Ferrari Dino        19.7 #>  8   3    Hornet Sportabout   18.7 #>           Duster 360          14.3 #>           Merc 450SE          16.4 #>           Merc 450SL          17.3 #>           Merc 450SLC         15.2 #>           Cadillac Fleetwood  10.4 #>           Lincoln Continental 10.4 #>           Chrysler Imperial   14.7 #>           Dodge Challenger    15.5 #>           AMC Javelin         15.2 #>           Camaro Z28          13.3 #>           Pontiac Firebird    19.2 #>      5    Ford Pantera L      15.8 #>           Maserati Bora       15.0      rownum <- with(mtcars, RowNum(list(cyl, gear))) tabular(Factor(cyl)*Factor(gear)*I(rownum) ~         mpg * AllObs(mtcars, within = list(cyl, gear, rownum)),          data=mtcars) #>                                    #>  cyl gear mpg                      #>  4   3    21.5                     #>      4    22.8 24.4 22.8 32.4 30.4 #>           33.9 27.3 21.4           #>      5    26.0 30.4                #>  6   3    21.4 18.1                #>      4    21.0 21.0 19.2 17.8      #>      5    19.7                     #>  8   3    18.7 14.3 16.4 17.3 15.2 #>           10.4 10.4 14.7 15.5 15.2 #>           13.3 19.2                #>      5    15.8 15.0"},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":null,"dir":"Reference","previous_headings":"","what":"Arguments pseudo-function — Arguments","title":"Arguments pseudo-function — Arguments","text":"Arguments pseudo-function enables use analysis functions take multiple arguments.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Arguments pseudo-function — Arguments","text":"","code":"Arguments(...)"},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Arguments pseudo-function — Arguments","text":"... Arguments pass analysis function.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Arguments pseudo-function — Arguments","text":"arguments Arguments evaluated full, length n subsetted cell table. analysis variable specified, Arguments() ,  analysis function called arguments matching given ....  analysis variable specified, inserted unnamed first argument analysis function. Arguments() entry create heading. one Arguments() specification may active term tabular formula.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Arguments pseudo-function — Arguments","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Arguments.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Arguments pseudo-function — Arguments","text":"","code":"# This is the example from the weighted.mean help page wt <- c(5,  5,  4,  1)/15 x <- c(3.7,3.3,3.5,2.8) gp <- c(1,1,2,2) tabular( (Factor(gp) + 1)      ~ weighted.mean*x*Arguments(w = wt) ) #>                    #>      weighted.mean #>  gp  x             #>  1   3.500         #>  2   3.360         #>  All 3.453"},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":null,"dir":"Reference","previous_headings":"","what":"DropEmpty pseudo-function — DropEmpty","title":"DropEmpty pseudo-function — DropEmpty","text":"Pseudo-function indicate rows columns containing observations dropped.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"DropEmpty pseudo-function — DropEmpty","text":"","code":"DropEmpty(empty = \"\", which = c(\"row\", \"col\", \"cell\"))"},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"DropEmpty pseudo-function — DropEmpty","text":"empty String use empty cells. vector indicating dropped.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"DropEmpty pseudo-function — DropEmpty","text":"argument contains \"row\", row table cells empty dropped. Similarly, contains \"col\", empty columns dropped.  contains \"cell\", cells rows columns dropped set empty string.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"DropEmpty pseudo-function — DropEmpty","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/DropEmpty.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"DropEmpty pseudo-function — DropEmpty","text":"","code":"df <- data.frame(row = factor(1:10), value = rnorm(10)) subset <- df[sample(10, 5),, drop = FALSE]  # Some rows did not get selected, so this looks ugly tabular(row ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  1         NaN #>  2         NaN #>  3         NaN #>  4   -0.005571 #>  5    0.621553 #>  6         NaN #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200 #>  10        NaN  # This only shows rows with data in them tabular(row*DropEmpty() ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  4   -0.005571 #>  5    0.621553 #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200  # This shows empty cells as \"(empty)\" tabular(row*DropEmpty(\"(empty)\", \"cell\") ~ value*mean, data = subset) #>                #>      value     #>  row mean      #>  1   (empty)   #>  2   (empty)   #>  3   (empty)   #>  4   -0.005571 #>  5    0.621553 #>  6   (empty)   #>  7   -1.821818 #>  8   -0.247325 #>  9   -0.244200 #>  10  (empty)"},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":null,"dir":"Reference","previous_headings":"","what":"Format pseudo-function — Format","title":"Format pseudo-function — Format","text":"Format controls formatting cells applies .  .Format mainly internal use.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Format pseudo-function — Format","text":"","code":"Format(...) .Format(n)"},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Format pseudo-function — Format","text":"... Arguments pass formatting function, call formatting function. n format number.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Format pseudo-function — Format","text":"Format pseudo-function changes formatting table cells, specifies values applies formatted together. first form, “call” Format looks like call format, without specifying argument x.  tabular() formats output construct x entries table governed Format() specification, pass standard format function along arguments. second form, “call” Format contains  call function formatting.  , argument x added call, containing values formatted. first form, explicit function named format, cells table character values formatted.  done column can mixed numeric character values, numerics converted character formatting. pseudo-function .Format mainly intended internal use. takes single integer argument, saying data governed call uses formatting format specification indicated integer. way entries can commonly formatted even contiguous. integers assigned sequentially format specification parsed; users likely need trial error find right value complicated table multiple formats.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Format pseudo-function — Format","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Format.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Format pseudo-function — Format","text":"","code":"# Using the first form tabular( (Sepal.Length+Sepal.Width) ~           Format(digits=2)*(mean + sd), data=iris ) #>                         #>               mean sd   #>  Sepal.Length 5.84 0.83 #>  Sepal.Width  3.06 0.44           # The same table, using the second form tabular( (Sepal.Length+Sepal.Width) ~           Format(format(digits=2))*(mean + sd), data=iris ) #>                         #>               mean sd   #>  Sepal.Length 5.84 0.83 #>  Sepal.Width  3.06 0.44"},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":null,"dir":"Reference","previous_headings":"","what":"Construct footnotes — HTMLfootnotes","title":"Construct footnotes — HTMLfootnotes","text":"function constructs HTML code footnotes insert bottom table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Construct footnotes — HTMLfootnotes","text":"","code":"HTMLfootnotes(tab, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Construct footnotes — HTMLfootnotes","text":"tab tabular object, used column width footnotes matches. ... footnotes.  named, preceded name superscript.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Construct footnotes — HTMLfootnotes","text":"character string containing HTML code footnotes.  Use table_options(HTMLfooter = ...)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/HTMLfootnotes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Construct footnotes — HTMLfootnotes","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) footnote <- HTMLfootnotes(tab,                            \"This is a footnote with no marker.\",                            \"*\" = \"This is a footnote with an asterisk.\") if (interactive())   toHTML(tab, options = list(doFooter = TRUE,                            HTMLfooter = footnote))"},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":null,"dir":"Reference","previous_headings":"","what":"Heading pseudo-function — Heading","title":"Heading pseudo-function — Heading","text":"Heading pseudo-function normally overrides automatic heading following items table.  Setting  override=FALSE used automatically  generated expressions.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Heading pseudo-function — Heading","text":"","code":"Heading(name = NULL, override = TRUE, character.only = FALSE, nearData = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Heading pseudo-function — Heading","text":"name legal R variable name, character constant. override Whether heading override one already present. character.TRUE, name argument interpreted expression evaluating character value. nearData See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Heading pseudo-function — Heading","text":"replaces automatic heading row label following item name string specified.  argument given, heading label suppressed. alternative form Heading(name) (name=...), ... expression displayed table. override = FALSE, label supplied label. used code Factor. nearData argument rarely used.  affects situation \"+\" used join tables different numbers labels.   nearData = TRUE (default), shorter list labels pushed close data, .e. right side row labels, bottom column labels.  FALSE, pushed opposite side.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Heading pseudo-function — Heading","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Heading.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Heading pseudo-function — Heading","text":"","code":"tabular( (Sepal.Length+Sepal.Width) ~           (Heading(Mean)*mean + (S.D.=sd)), data=iris ) #>                            #>               Mean  S.D.   #>  Sepal.Length 5.843 0.8281 #>  Sepal.Width  3.057 0.4359  heading <- \"Variable Heading\" tabular( (Sepal.Length+Sepal.Width) ~           (Heading(heading, character.only = TRUE)*mean + (S.D.=sd)),           data=iris ) #>                                       #>               Variable Heading S.D.   #>  Sepal.Length 5.843            0.8281 #>  Sepal.Width  3.057            0.4359"},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a horizontal line to a LaTeX table. — Hline","title":"Add a horizontal line to a LaTeX table. — Hline","text":"function inserts LaTeX directive draw full partial  line table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a horizontal line to a LaTeX table. — Hline","text":"","code":"Hline(columns, nearData = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a horizontal line to a LaTeX table. — Hline","text":"columns columns receive line? nearData See Details section Heading.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add a horizontal line to a LaTeX table. — Hline","text":"Hline() flexible:  must leftmost header row specification table, .e. mean * Hline() allowed.  Anything right Hline() factor ignored.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a horizontal line to a LaTeX table. — Hline","text":"Produces expression insert label interpreted LaTeX request horizontal line.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Hline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a horizontal line to a LaTeX table. — Hline","text":"","code":"toLatex( tabular( Species + Hline() + 1 ~ mean*Sepal.Width, data=iris) ) #> \\begin{tabular}{lc} #> \\hline #>  & \\multicolumn{1}{c}{mean} \\\\  #> Species  & \\multicolumn{1}{c}{Sepal.Width} \\\\  #> \\hline #> setosa  & $3.428$ \\\\ #> versicolor  & $2.770$ \\\\ #> virginica  & $2.974$ \\\\ #> \\hline %  &  \\\\ #> All  & $3.057$ \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":null,"dir":"Reference","previous_headings":"","what":"Justify pseudo-function — Justify","title":"Justify pseudo-function — Justify","text":"Justify pseudo-function sets justification following items table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Justify pseudo-function — Justify","text":"","code":"Justify(labels, data=labels)"},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Justify pseudo-function — Justify","text":"labels Justification use labels data Justification use data.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Justify pseudo-function — Justify","text":"justification can R name syntactically valid,  quoted string.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Justify pseudo-function — Justify","text":"“pseudo-function”:  takes form function call, never actually called:   handled specially tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Justify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Justify pseudo-function — Justify","text":"","code":"tabular( Justify(c,l)*Heading(Var)*(Sepal.Length+Sepal.Width) ~           Justify(c)*(mean + sd), data=iris ) #>                            #>      Var      mean    sd   #>  Sepal.Length 5.843 0.8281 #>  Sepal.Width  3.057 0.4359"},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":null,"dir":"Reference","previous_headings":"","what":"Insert a literal entry into a table margin. — Literal","title":"Insert a literal entry into a table margin. — Literal","text":"allows insertion arbitrary LaTeX text table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Insert a literal entry into a table margin. — Literal","text":"","code":"Literal(x, nearData = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Insert a literal entry into a table margin. — Literal","text":"x character string insert. nearData See Details section Heading.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Insert a literal entry into a table margin. — Literal","text":"LaTeX literal string usually end % comment character avoid blank line inserted.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Insert a literal entry into a table margin. — Literal","text":"Produces expression insert label containing literal text.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Literal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Insert a literal entry into a table margin. — Literal","text":"","code":"tabular( (Literal(\"Some text\") + Species)  ~         All(iris)*mean, data=iris ) #>                                                                       #>                     Sepal.Length Sepal.Width Petal.Length Petal.Width #>                     mean         mean        mean         mean        #>          Some text                                                    #>  Species setosa     5.006        3.428       1.462        0.246       #>          versicolor 5.936        2.770       4.260        1.326       #>          virginica  6.588        2.974       5.552        2.026"},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate terms to paste values together in table. — Paste","title":"Generate terms to paste values together in table. — Paste","text":"function generates component table formula output multiple columns punctuation .   designed LaTeX output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate terms to paste values together in table. — Paste","text":"","code":"Paste(..., head, digits=2, justify=\"c\", prefix=\"\", sep=\"\", postfix=\"\",       character.only = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate terms to paste values together in table. — Paste","text":"... Expressions displayed columns table.  named, get names headings, otherwise labelled. head missing, used column heading combined columns. digits passed format function.  digits length one, expressions use common format; otherwise formatted separately. justify One justifications use individual columns. sep One separators use columns. prefix, postfix Additional text insert group columns. character.TRUE, head argument interpreted expression evaluating character value.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Paste.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate terms to paste values together in table. — Paste","text":"expression produce requested output LaTeX.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":null,"dir":"Reference","previous_headings":"","what":"Pseudo-function to compute a statistic relative to a reference set. — Percent","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"Percent pseudo-function used specify statistic depends values table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"","code":"Percent(denom = \"all\", fn = percent)"},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"denom reference set (denominator case percentage calculation) calculated.  See . fn two argument function calculate statistic.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"function fn called two arguments.  first argument usual “value vector”  values corresponding cell table, second  another vector reference values, determined denom. default value fn percent function, defined function(x, y) 100*length(x)/length(y).  gives ratio number values current cell relative reference values, expressed percentage. Using fn = function(x, y) 100*sum(x)/sum(y) give percentage sum values current cell sum reference set. default denom = \"\", values analysis variable dataset used reference.  possibilities denom = \"row\" denom = \"col\", values variable corresponding current row column subset used. special syntax denom = Equal(...) record  expression ....  reference set cases equal values expressions ... current cell. similar form denom = Unequal(...) sets reference values differ ... expressions current cell.  (fact, can used somewhat generally; see  vignette details.) Finally, possible denom values  logical vector, case values marked TRUE used, anything else, passed fn y without subsetting.  (pass variable subsetting, use Arguments pseudo-function instead.)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"pseudo-functions","dir":"Reference","previous_headings":"","what":"Pseudo-functions","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"Percent “pseudo-function”:  takes form function call, never actually called:   handled specially tabular.  Equal Unequal also pseudo-functions, special used denom argument Percent.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/Percent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Pseudo-function to compute a statistic relative to a reference set. — Percent","text":"","code":"x <- factor(sample(LETTERS[1:2], 1000, rep=TRUE)) y <- factor(sample(letters[3:4], 1000, rep=TRUE)) z <- factor(sample(LETTERS[5:6], 1000, rep=TRUE))  # These both do the same thing: tabular( (x + 1)*(y + 1) ~ (z + 1)*(1+(RowPct=Percent(\"row\")))) #>                                            #>          z                                 #>          E          F          All         #>  x   y   All RowPct All RowPct All  RowPct #>  A   c   118 50.64  115 49.36   233 100    #>      d   139 54.30  117 45.70   256 100    #>      All 257 52.56  232 47.44   489 100    #>  B   c   132 50.77  128 49.23   260 100    #>      d   127 50.60  124 49.40   251 100    #>      All 259 50.68  252 49.32   511 100    #>  All c   250 50.71  243 49.29   493 100    #>      d   266 52.47  241 47.53   507 100    #>      All 516 51.60  484 48.40  1000 100    tabular( (x + 1)*(y + 1) ~ (z + 1)*(1+(xyPct=Percent(Equal(x, y))))) #>                                         #>          z                              #>          E         F         All        #>  x   y   All xyPct All xyPct All  xyPct #>  A   c   118 50.64 115 49.36  233 100   #>      d   139 54.30 117 45.70  256 100   #>      All 257 52.56 232 47.44  489 100   #>  B   c   132 50.77 128 49.23  260 100   #>      d   127 50.60 124 49.40  251 100   #>      All 259 50.68 252 49.32  511 100   #>  All c   250 50.71 243 49.29  493 100   #>      d   266 52.47 241 47.53  507 100   #>      All 516 51.60 484 48.40 1000 100"},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate x +/- y terms in table. — PlusMinus","title":"Generate x +/- y terms in table. — PlusMinus","text":"function generates component table formula output two columns separated +/- sign.   designed LaTeX output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate x +/- y terms in table. — PlusMinus","text":"","code":"PlusMinus(x, y, head, xhead, yhead, digits = 2,            character.only = FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate x +/- y terms in table. — PlusMinus","text":"x,y Expressions displayed columns left right +/- sign, respectively. head missing, used column heading two columns. xhead, yhead missing, used individual column headings. digits, ... Parameters pass format function. character.TRUE, head, xhead yhead  arguments interpreted expressions evaluating character values.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate x +/- y terms in table. — PlusMinus","text":"expression produce requested output LaTeX.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/PlusMinus.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate x +/- y terms in table. — PlusMinus","text":"","code":"stderr <- function(x) sd(x)/sqrt(length(x)) toLatex( tabular( (Species+1) ~ Sepal.Length*           PlusMinus(mean, stderr, digits=1), data=iris ) ) #> \\begin{tabular}{lcc} #> \\hline #> Species  & \\multicolumn{2}{c}{Sepal.Length} \\\\  #> \\hline #> setosa  & \\multicolumn{1}{r@{}}{$5.01$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.05$} \\\\ #> versicolor  & \\multicolumn{1}{r@{}}{$5.94$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.07$} \\\\ #> virginica  & \\multicolumn{1}{r@{}}{$6.59$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.09$} \\\\ #> All  & \\multicolumn{1}{r@{}}{$5.84$} & \\multicolumn{1}{@{ $\\pm$ }l}{$0.07$} \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":null,"dir":"Reference","previous_headings":"","what":"Use a variable as a factor to give rows in a table. — RowFactor","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"functions take variable treat factor table. RowFactor designed LaTeX output, adding extra spacing make table readable.  Multicolumn also works LaTeX, displays label style level line , spanning multiple columns.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"","code":"Factor(x, name = deparse(expr), levelnames = levels(x),         texify = getOption(\"tables.texify\", FALSE),         expr = substitute(x), override = TRUE) RowFactor(x, name = deparse(expr),      levelnames = levels(x),            spacing = 3, space = 1, suppressfirst = TRUE,           nopagebreak = \"\\\\nopagebreak \",           texify = getOption(\"tables.texify\", FALSE),            expr = substitute(x),           override = TRUE) Multicolumn(x, name = deparse(expr), levelnames = levels(x),              width=2, first=1, justify=\"l\",             texify = getOption(\"tables.texify\", FALSE),              expr = substitute(x),             override = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"x variable treated factor. name display name factor. levelnames strings use levels x. texify TRUE, characters interpreted specially LaTeX  escaped (using latexTranslate) print properly. expr expression use evaluating factor.  Generally expression passed x, internal uses may differ. override name factor override previously specified Heading() setting? spacing Extra spacing added every spacing lines. space much extra space add, ex units. suppressfirst Whether suppress spacing first group. nopagebreak LaTeX macro insert suppress page breaks except groups. width many columns label span? first first column label appears? justify label justified columns?","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"Language insert table formula achieve desired table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/RowFactor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Use a variable as a factor to give rows in a table. — RowFactor","text":"","code":"tabular( Factor(1:10, \"row\") ~        All(iris[1:10,])*Heading()*identity ) #>                                                        #>  row Sepal.Length Sepal.Width Petal.Length Petal.Width #>  1   5.1          3.5         1.4          0.2         #>  2   4.9          3.0         1.4          0.2         #>  3   4.7          3.2         1.3          0.2         #>  4   4.6          3.1         1.5          0.2         #>  5   5.0          3.6         1.4          0.2         #>  6   5.4          3.9         1.7          0.4         #>  7   4.6          3.4         1.4          0.3         #>  8   5.0          3.4         1.5          0.2         #>  9   4.4          2.9         1.4          0.2         #>  10  4.9          3.1         1.5          0.1         toLatex( tabular( RowFactor(1:10, \"\", 5)  ~         All(iris[1:10,])*Heading()*identity ))  #> \\begin{tabular}{lcccc} #> \\hline #>   & Sepal.Length & Sepal.Width & Petal.Length & \\multicolumn{1}{c}{Petal.Width} \\\\  #> \\hline #> \\nopagebreak 5  & $5.1$ & $3.5$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.9$ & $3.0$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.7$ & $3.2$ & $1.3$ & $0.2$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.6$ & $3.1$ & $1.5$ & $0.2$ \\\\ #> \\nopagebreak NA  & $5.0$ & $3.6$ & $1.4$ & $0.2$ \\\\ #> \\nopagebreak NA  & $5.4$ & $3.9$ & $1.7$ & $0.4$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.6$ & $3.4$ & $1.4$ & $0.3$ \\\\ #> \\nopagebreak NA  & $5.0$ & $3.4$ & $1.5$ & $0.2$ \\\\ #> \\nopagebreak NA  & $4.4$ & $2.9$ & $1.4$ & $0.2$ \\\\ #> \\rule{0pt}{1.7\\normalbaselineskip}NA  & $4.9$ & $3.1$ & $1.5$ & $0.1$ \\\\ #> \\hline  #> \\end{tabular}"},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to matrix — as.matrix.tabular","title":"Convert tabular object to matrix — as.matrix.tabular","text":"Convert tabular object matrix strings print, matrix values.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to matrix — as.matrix.tabular","text":"","code":"# S3 method for tabular as.matrix(x, format = TRUE,      rowLabels = TRUE, colLabels = TRUE, justification = \"n\", ...)"},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to matrix — as.matrix.tabular","text":"x \"tabular\" object. format format; see Details . rowLabels, colLabels Whether include row column labels; used format = TRUE. justification justify values; used format = TRUE. ... parameters pass format.tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Convert tabular object to matrix — as.matrix.tabular","text":"format=TRUE, matrix formatted strings produced.  , format argument assumed function (name function passed character vector) convert list-mode matrix another mode, e.g. .numeric.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to matrix — as.matrix.tabular","text":"matrix.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.matrix.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to matrix — as.matrix.tabular","text":"","code":"table <-     tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )  print(table) #>                                                    #>                 Sepal.Length      Sepal.Width      #>  Species    n   mean         sd   mean        sd   #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44 as.matrix(table) #>      [,1]         [,2]  [,3]           [,4]   [,5]          [,6]   #> [1,] \"\"           \"\"    \"Sepal.Length\" \"\"     \"Sepal.Width\" \"\"     #> [2,] \"Species\"    \"n\"   \"mean\"         \"sd\"   \"mean\"        \"sd\"   #> [3,] \"setosa\"     \" 50\" \"5.01\"         \"0.35\" \"3.43\"        \"0.38\" #> [4,] \"versicolor\" \" 50\" \"5.94\"         \"0.52\" \"2.77\"        \"0.31\" #> [5,] \"virginica\"  \" 50\" \"6.59\"         \"0.64\" \"2.97\"        \"0.32\" #> [6,] \"All\"        \"150\" \"5.84\"         \"0.83\" \"3.06\"        \"0.44\" as.matrix(table, format=as.numeric) #>      [,1]     [,2]      [,3]     [,4]      [,5] #> [1,]   50 5.006000 0.3524897 3.428000 0.3790644 #> [2,]   50 5.936000 0.5161711 2.770000 0.3137983 #> [3,]   50 6.588000 0.6358796 2.974000 0.3224966 #> [4,]  150 5.843333 0.8280661 3.057333 0.4358663"},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert matrix or dataframe to tabular object. — as.tabular","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"functions construct copy labels onto existing matrix dataframe.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"","code":"as.tabular(x, like = NULL) # S3 method for default as.tabular(x, like = NULL) # S3 method for data.frame as.tabular(x, like = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"x object convert. like NULL, tabular object   number rows columns x.  labels   used result.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"tabular object.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/as.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert matrix or dataframe to tabular object. — as.tabular","text":"","code":"model <- tabular( (Species + 1) ~ (n=1) + Sepal.Length + Sepal.Width, data=iris ) model #>                                          #>  Species    n   Sepal.Length Sepal.Width #>  setosa      50  50           50         #>  versicolor  50  50           50         #>  virginica   50  50           50         #>  All        150 150          150         as.tabular(matrix(1:12, 4,3), like=model) #>                                        #>  Species    n Sepal.Length Sepal.Width #>  setosa     1 5             9          #>  versicolor 2 6            10          #>  virginica  3 7            11          #>  All        4 8            12"},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Display a tabular object using HTML. — html.tabular","title":"Display a tabular object using HTML. — html.tabular","text":"similar print.tabular, inserts code display table HTML table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display a tabular object using HTML. — html.tabular","text":"","code":"toHTML(object, file = \"\", options = NULL,                         id = NULL, append = FALSE,                         browsable = TRUE, ...) html.tabular(object, ...) writeCSS(CSS = htmloptions()$CSS, id = NULL)"},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display a tabular object using HTML. — html.tabular","text":"object tabular object. file filename connection write HTML code, \"\" write console. options list options set duration call. id unique identifier set table associated CSS style, NULL, id. append TRUE, opens file appending (filename rather connection). browsable output marked browsable? ... Settings default formatting.  See Details . CSS character vector use CSS.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display a tabular object using HTML. — html.tabular","text":"toHTML() function produces HTML output suitable inclusion HTML page. html.tabular function set work method html generic Hmisc, registered method, tables can work Hmisc installed. HTML, mainly CSS style sheet determines look table.   formatting table, html.tabular sets CSS class according table's Justify setting; justifications c(\"l\", \"c\", \"r\") translated classes c(\"left\", \"center\", \"right\") respectively; strings passed used directly class names.   id value NULL, used CSS id selector searching style. See table_options number options control formatting, including default style sheet.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display a tabular object using HTML. — html.tabular","text":"file = \"\" (default), toHTML() function creates HTML object using htmltools::HTML function returns .  file character value connection, results written HTML object returned invisibly.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/html.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display a tabular object using HTML. — html.tabular","text":"","code":"# \\donttest{ X <- rnorm(125, sd=100) Group <- factor(sample(letters[1:5], 125, rep=TRUE))  tab <- tabular( Group ~ (N=1)+Format(digits=2)*X*((Mean=mean) + Heading(\"Std Dev\")*sd) )  save <- table_options() table_options(rowlabeljustification=\"c\")  f <- tempfile(fileext=\".html\") con <- file(f, \"wt\")  if (interactive())   toHTML(tab, con, options=htmloptions(head=TRUE, table=FALSE))  writeLines(\"<p>This table has pad = FALSE.  The centered numbers look sloppy.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=FALSE))  writeLines(\"<p>This table has pad = FALSE and justification=\\\"r\\\". The justification makes the columns of numbers look all right (except for the hyphens used as minus signs), but they are placed poorly relative to the labels.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=FALSE, justification=\"r\"))  writeLines(\"<p>This one has pad = TRUE. It looks best, but if you cut and paste, the spacing characters may cause problems.<br>\", con)  if (interactive())   toHTML(tab, con, options=htmloptions(head=FALSE, table=TRUE, pad=TRUE))  table_options(save) close(con) if (interactive())   browseURL(f) # }"},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Custom printing of tabular objects. — knit_print.tabular","title":"Custom printing of tabular objects. — knit_print.tabular","text":"Automatically print tabular objects formatting knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Custom printing of tabular objects. — knit_print.tabular","text":"","code":"# S3 method for tabular knit_print(x, format = getKnitrFormat(), ...)"},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Custom printing of tabular objects. — knit_print.tabular","text":"x tabular object. format output format?  \"latex\" \"html\" supported. ... parameters, currently ignored.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Custom printing of tabular objects. — knit_print.tabular","text":"function normally called user.  designed called knitr processing .Rmd .Rnw document. table_options()$knit_print TRUE output format supported, method prepare output suitable formatted printing knitr document using asis_output.  Otherwise, usual unformatted print display done normal_print.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Custom printing of tabular objects. — knit_print.tabular","text":"object marked printing knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/knit_print.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Custom printing of tabular objects. — knit_print.tabular","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) knitr::knit_print(tab) #> [1] \"\\\\begin{tabular}{lccccc}\\n\\\\hline\\n &  & \\\\multicolumn{2}{c}{Sepal.Length} & \\\\multicolumn{2}{c}{Sepal.Width} \\\\\\\\ \\nSpecies  & n & mean & sd & mean & \\\\multicolumn{1}{c}{sd} \\\\\\\\ \\n\\\\hline\\nsetosa  & $\\\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\\\\\\\nversicolor  & $\\\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\\\\\\\nvirginica  & $\\\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\\\\\\\nAll  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\\\\\\\n\\\\hline \\n\\\\end{tabular}\\n\\n\\nFALSE\\n\\n\\n\" #> attr(,\"class\") #> [1] \"knit_asis\" #> attr(,\"knit_cacheable\") #> [1] NA"},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a label to a logical vector. — labelSubset","title":"Add a label to a logical vector. — labelSubset","text":"function mainly internal use.  adds label  logical vector, Percent pseudo-function can ignore forming denominator.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a label to a logical vector. — labelSubset","text":"","code":"labelSubset(subset, label)"},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a label to a logical vector. — labelSubset","text":"subset logical vector describing subset dataset. label character label use describe subset call Equal Unequal within Percent.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a label to a logical vector. — labelSubset","text":"vector class \"labelledSubset\" label  recorded attribute.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labelSubset.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Add a label to a logical vector. — labelSubset","text":"Duncan Murdoch","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve or modify the row or column labels. — labels","title":"Retrieve or modify the row or column labels. — labels","text":"functions allow row column labels tabular object retrieved modified.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve or modify the row or column labels. — labels","text":"","code":"rowLabels(x) rowLabels(x) <- value colLabels(x) colLabels(x) <- value # S3 method for tabularRowLabels [(x, i, j, ..., drop = FALSE) # S3 method for tabularColLabels [(x, i, j, ..., drop = FALSE)"},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve or modify the row or column labels. — labels","text":"x \"tabular\", \"tabularRowLabels\" \"tabularColLabels\" object. value replacement , j, ..., drop Arguments used subsetting labels.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve or modify the row or column labels. — labels","text":"Subsetting row labels allow number rows changed; likewise, subsetting column labels allow number columns changed.  change ,  subset original \"tabular\" object.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve or modify the row or column labels. — labels","text":"rowLabels corresponding subsetting method return object class \"tabularRowLabels\". colLabels corresponding subsetting method  return object class \"tabularColLabels\". assignment functions return \"tabular\" objects.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/labels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve or modify the row or column labels. — labels","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) colLabels(tab) #>      [,1] [,2]         [,3] [,4]        [,5] #> [1,]      Sepal.Length <NA> Sepal.Width <NA> #> [2,] n    mean         sd   mean        sd   #> Attributes:  dim, justification, colnamejust, justify, suppress, nearData, class  colLabels(tab) <- colLabels(tab)[1,] tab #>                                                    #>  Species        Sepal.Length      Sepal.Width      #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44"},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Display a tabular object using LaTeX. — latex.tabular","title":"Display a tabular object using LaTeX. — latex.tabular","text":"similar print.tabular, inserts code display table LaTeX tabular environment.  toLatex.tabular method works toLatex generic utils.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display a tabular object using LaTeX. — latex.tabular","text":"","code":"toLatex(object, ...) # S3 method for tabular toLatex(object, file = \"\", options = NULL, append = FALSE, ...) latex.tabular(object, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display a tabular object using LaTeX. — latex.tabular","text":"object tabular object. file filename connection write LaTeX code, \"\" write standard output. options list options set duration call. append TRUE, opens file appending (filename rather connection). ... Settings default formatting.  See Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Display a tabular object using LaTeX. — latex.tabular","text":"toLatex() method produces LaTeX output suitable inclusion Sweave document. latex.tabular function set work method latex generic Hmisc, registered method, tables can work Hmisc installed.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Display a tabular object using LaTeX. — latex.tabular","text":"historical reasons, toLatex() function non-empty file argument write file returned value printed.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display a tabular object using LaTeX. — latex.tabular","text":"toLatex() method returns x invisibly, prints LaTeX script console. table_options() booktabs() return previous settings.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/latex.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Display a tabular object using LaTeX. — latex.tabular","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) toLatex(tab) #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} save <- booktabs() toLatex(tab) #> \\begin{tabular}{lccccc} #> \\toprule #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\ \\cmidrule(lr){3-4}\\cmidrule(lr){5-6} #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\midrule #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\bottomrule  #> \\end{tabular} table_options(save)"},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":null,"dir":"Reference","previous_headings":"","what":"Process numeric LaTeX or HTML values. — latexNumeric","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"takes formatted strings produced format numeric values, modifies LaTeX HTML code retains spacing, renders minus signs properly.  default formatting tabular uses maintain proper alignment.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"","code":"latexNumeric(chars, minus = TRUE, leftpad = TRUE, rightpad = TRUE, mathmode = TRUE) htmlNumeric(chars, minus = TRUE, leftpad = TRUE, rightpad = TRUE)"},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"chars character vector numeric values. minus Whether pad cases minus sign spacing width. leftpad,rightpad Whether pad cases leading trailing blanks spacing matching digit width per space. mathmode Whether wrap result dollar signs, LaTeX renders minus signs properly.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"character vector length chars, modifications render properly LaTeX.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexNumeric.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Process numeric LaTeX or HTML values. — latexNumeric","text":"","code":"latexNumeric(format(c(1.1,-1,10,-10))) #> [1] \"$\\\\phantom{0}\\\\phantom{-}1.1$\" \"$\\\\phantom{0}-1.0$\"            #> [3] \"$\\\\phantom{-}10.0$\"            \"$-10.0$\"                       htmlNumeric(format(c(1.1,-1,10,-10))) #> [1] \"&#x2007;&#x2007;1.1\" \"&#x2007;&minus;1.0\"  \"&#x2007;10.0\"        #> [4] \"&minus;10.0\""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":null,"dir":"Reference","previous_headings":"","what":"Create table in full table environment — latexTable","title":"Create table in full table environment — latexTable","text":"tabular function creates table usually  renders tabular environment displayed LaTeX,  \"float\" caption, label, etc.  function wraps tabular result result call knitr::kable function.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create table in full table environment — latexTable","text":"","code":"latexTable(table, format = \"latex\", longtable = FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create table in full table environment — latexTable","text":"table Either formula passed tabular, result call function. format Currently \"latex\" format output supported. longtable, ... Additional arguments passed knitr::kable function.  See details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create table in full table environment — latexTable","text":"Rather redoing work generating LaTeX code wrap tabular result, function works generating dummy kable table, replaces tabular part tabular result. Many arguments kable deal content table, wrapper.  ignored warning.  Currently arguments ignored, defaults, : caption = NULL caption use table. label = NULL Part LaTeX label use table.  full label \"tab:\" prepended  kable. escape = TRUE Whether escape special characters caption. booktabs = FALSE, longtable = FALSE Logical values indicate style table.  must also specified tabular; see main vignette details. position = \"\" instruction LaTeX position float document. centering = TRUE Whether center table float. caption.short = \"\" Abbreviated caption use TOC. table.envir = (!.null(caption)) \"table\" Name outer environment. arguments defined knitr package,  may change future.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create table in full table environment — latexTable","text":"object class \"knitr_kable\" suitable include Sweave knitr  .Rnw document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/latexTable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create table in full table environment — latexTable","text":"","code":"cat(latexTable(tabular((Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ),     caption = \"Iris sepal data\", label = \"sepals\")) #> \\begin{table} #>  #> \\caption{\\label{tab:sepals}Iris sepal data} #> \\centering #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} #>  #> \\end{table}"},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"formatters package provides methods displaying breaking tables smaller pieces.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"","code":"matrix_form.tabular(df)"},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"df tabular object.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"formatters package provides matrix_form generic function S4 objects.  \"tabular\" objects S3 objects, dispatch function,  must fully specified called.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"Duncan Murdoch help Gabe Becker.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/matrix_form.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform tabular object to matrices printable by formatters package — matrix_form.tabular","text":"","code":"if (requireNamespace(\"formatters\")) {   Sex <- factor(sample(c(\"Male\", \"Female\"), 100, rep=TRUE))   Status <- factor(sample(c(\"low\", \"medium\", \"high\"), 100, rep=TRUE))   z <- rnorm(100) + 5   fmt <- function(x) {   s <- format(x, digits=2)   even <- ((1:length(s)) %% 2) == 0   s[even] <- sprintf(\"(%s)\", s[even])   s }   tab <- tabular( Justify(c)*Heading()*z*Sex*Heading(Statistic)*Format(fmt())*(mean+sd)                    ~ Status )   mform <- matrix_form.tabular(tab)   page <- 1   cat(\"Page \", page, \" Full table\\n\\n\")   cat(formatters::toString(mform))      # This shows automatic pagination, breaking up the   # table by rows   byrow <- formatters::pag_indices_inner(formatters::mf_rinfo(mform),                               rlpp = 2,                               min_siblings = 1)   for (i in seq_along(byrow)) {     mform2 <- matrix_form.tabular(tab[byrow[[i]], ])     page <- page + 1     cat(\"\\nPage \", page, \" Rows\", byrow[[i]], \"\\n\\n\")     cat(formatters::toString(mform2))   }      # This gives the breaks by columns, counting the   # row label columns.     # The formatters::vert_pag_indices function had an incompatible   # change in v0.5.8   if (\"fontspec\" %in% names(formals(formatters::vert_pag_indices)))     bycol <- formatters::vert_pag_indices(mform, cpp = 30,  rep_cols = 2,                                         fontspec = NULL)   else     bycol <- formatters::vert_pag_indices(mform, cpp = 30,  rep_cols = 2)   # Display the table with both kinds of breaks   for (i in seq_along(byrow)) {     rows <- byrow[[i]]     for (j in seq_along(bycol)) {       cols <- bycol[[j]]       cols <- cols[cols > 2] - 2  # cols includes the row labels       mform3 <- matrix_form.tabular(tab[rows, cols, drop = FALSE])       page <- page + 1       cat(\"\\nPage \", page, \"Rows\", rows, \"column\", cols, \"\\n\\n\")       cat(formatters::toString(mform3))     }   } } #> Loading required namespace: formatters #> Page  1  Full table #>  #>                          Status          #>                  high     low     medium #> ———————————————————————————————————————— #> Female   mean    5.39     5.04     4.93  #>           sd    (0.84)   (0.92)   (0.90) #>  Male    mean    5.07     5.16     4.62  #>           sd    (0.92)   (0.97)   (0.84) #>  #> Page  2  Rows 1 2  #>  #>                          Status          #>                  high     low     medium #> ———————————————————————————————————————— #> Female   mean    5.39     5.04     4.93  #>           sd    (0.84)   (0.92)   (0.90) #>  #> Page  3  Rows 3 4  #>  #>                        Status          #>                high     low     medium #> —————————————————————————————————————— #> Male   mean    5.07     5.16     4.62  #>         sd    (0.92)   (0.97)   (0.84) #>  #> Page  4 Rows 1 2 column 1  #>  #>                 Status #>                  high  #> —————————————————————— #> Female   mean    5.39  #>           sd    (0.84) #>  #> Page  5 Rows 1 2 column 2  #>  #>                 Status #>                  low   #> —————————————————————— #> Female   mean    5.04  #>           sd    (0.92) #>  #> Page  6 Rows 1 2 column 3  #>  #>                 Status #>                 medium #> —————————————————————— #> Female   mean     4.9  #>           sd    (0.9)  #>  #> Page  7 Rows 3 4 column 1  #>  #>               Status #>                high  #> ———————————————————— #> Male   mean    5.07  #>         sd    (0.92) #>  #> Page  8 Rows 3 4 column 2  #>  #>               Status #>                low   #> ———————————————————— #> Male   mean    5.16  #>         sd    (0.97) #>  #> Page  9 Rows 3 4 column 3  #>  #>               Status #>               medium #> ———————————————————— #> Male   mean    4.62  #>         sd    (0.84)"},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":null,"dir":"Reference","previous_headings":"","what":"Set or query options for the table formatting. — table_options","title":"Set or query options for the table formatting. — table_options","text":"functions set query options table formatting LaTeX HTML output.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set or query options for the table formatting. — table_options","text":"","code":"table_options(...) booktabs(...) htmloptions(head=TRUE, table=TRUE, pad=FALSE,              ...)"},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set or query options for the table formatting. — table_options","text":"head logical; enables HTML header options table logical; enables output parts table pad logical; enables HTML padding options ... options listed Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Set or query options for the table formatting. — table_options","text":"table_options() function sets number options control formatting.  Currently  options affect LaTeX HTML output : justification = \"c\" Default justification data columns table. rowlabeljustification = \"l\" Default justification row labels. doBegin, doHeader, doBody, doFooter, doEnd logical values (defaults TRUE) control inclusion specific parts output table. knit_print = TRUE auto formatting printing knitr document. options used LaTeX output: tabular = \"tabular\" LaTeX environment use table.  choices \"longtable\" might make sense. toprule, midrule, bottomrule LaTeX macros use lines table.  default \"\\hline\". titlerule = NULL LaTeX macro use underline multicolumn titles.  NULL, underlining done. latexleftpad, latexrightpad, latexminus, mathmode control formatting numbers table.  TRUE (default), blanks R's formatting converted hard spaces LaTeX output, negative signs rendered properly.  Generally makes output look better, .tex input may harder read. options used HTML output: doHTMLheader, doCSS, doHTMLbody control output material top HTML page. HTMLhead, CSS, HTMLbody default strings output corresponding element selected. present, string \"CHARSET\" replaced result localeToCharset() HTMLhead.  string \"#ID\" replaced \"#\" followed id argument html.tabular (removed blank). HTMLcaption optional HTML caption table.  NULL, caption emitted. HTMLleftpad, HTMLrightpad, HTMLminus control formatting numbers table.  TRUE, blanks R's formatting converted hard spaces HTML output, negative signs rendered properly.  Generally makes output look better,  cut paste table may include special characters recognized software.  default FALSE. HTMLattributes string add \"<table>\" declaration top table.  default, attributes 'frame=\"hsides\" rules=\"groups\"'. set horizontal rules top bottom table header, body, footer (present). HTMLfooter NULL footer, HTML code insert table.  Note HTML footer specified body table; html.tabular written call. may set persistently calling table_options(), just duration call passing list via latex(options=list( ... )).  Additional  ... arguments latex passed format. booktabs() function sets table_options() values different defaults,  suitable use booktabs LaTeX package. htmloptions() function constructs list suitable options argument html.tabular, grouping options rarely differ . Note LaTeX code can used rule options; example, see longtable example vignette.  Material go headers goes toprule, material headers body goes midrule, material bottom table goes bottomrule.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set or query options for the table formatting. — table_options","text":"table_options() booktabs() return previous settings. htmloptions() returns list settings without changing defaults.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/table_options.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set or query options for the table formatting. — table_options","text":"","code":"tab <- tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) toLatex(tab) #> \\begin{tabular}{lccccc} #> \\hline #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\  #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\hline #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\hline  #> \\end{tabular} save <- booktabs() toLatex(tab) #> \\begin{tabular}{lccccc} #> \\toprule #>  &  & \\multicolumn{2}{c}{Sepal.Length} & \\multicolumn{2}{c}{Sepal.Width} \\\\ \\cmidrule(lr){3-4}\\cmidrule(lr){5-6} #> Species  & n & mean & sd & mean & \\multicolumn{1}{c}{sd} \\\\  #> \\midrule #> setosa  & $\\phantom{0}50$ & $5.01$ & $0.35$ & $3.43$ & $0.38$ \\\\ #> versicolor  & $\\phantom{0}50$ & $5.94$ & $0.52$ & $2.77$ & $0.31$ \\\\ #> virginica  & $\\phantom{0}50$ & $6.59$ & $0.64$ & $2.97$ & $0.32$ \\\\ #> All  & $150$ & $5.84$ & $0.83$ & $3.06$ & $0.44$ \\\\ #> \\bottomrule  #> \\end{tabular} table_options(save)  # \\donttest{ f <- tempfile(fileext = \".html\") if (interactive())   toHTML(tab, f,      options=htmloptions(HTMLcaption=\"Table of Iris Data\",                       pad = TRUE)) # }"},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute complex table — tabular","title":"Compute complex table — tabular","text":"Computes table summary statistics, cross-classified various variables.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute complex table — tabular","text":"","code":"tabular(table, ...) # S3 method for default tabular(table, ...) # S3 method for formula tabular(table, data = NULL, n, suppressLabels = 0, ...) # S3 method for tabular print(x, justification=\"n\", ...) # S3 method for tabular format(x, digits=4, justification=\"n\", latex=FALSE, html=FALSE,                           leftpad = TRUE, rightpad = TRUE, minus = TRUE,  \t\t\t mathmode = TRUE, ...) # S3 method for tabular [(x, i, j, ..., drop=FALSE) # S3 method for tabular cbind(..., deparse.level = 1) # S3 method for tabular rbind(..., deparse.level = 1)"},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute complex table — tabular","text":"table table expression.  See Details . data optional dataframe, list environment look variables table. n optional value giving length data.  See Details . suppressLabels many initial labels suppress? x object print, format, subset. digits, ... print format methods, many significant digits parameters show default?  See Formatting . justification default justification use table. latex TRUE, latexNumeric function applied formatting numeric columns format, maintain spacing handle signs properly. html TRUE, htmlNumeric function applied formatting numeric columns format, maintain spacing handle signs properly. leftpad, rightpad, minus, mathmode Options pass latexNumeric htmlNumeric control details formatting.  See pages details. , j, drop usual arguments matrix indexing, see Details . deparse.level Ignored.  (Present generic requires .)","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute complex table — tabular","text":"purposes function, \"table\" rectangular array values, computed using formula expression.  left hand side formula describes rows table, right hand side describes columns. Within expression rows columns, operators +, * = special meanings. + operator represents concatenation, x + y ~ z says show rows corresponding x rows corresponding y. * operator represents nesting, x*y ~ z says show rows y within row corresponding x. = operator sets new name term; abbreviation Heading() pseudo-function.  (“Pseudo-functions” described tables vignette.)  Note = low operator precedence may confused parser setting function arguments, parentheses usually needed. Parentheses may used group terms usual arithmetic way,  (x + y)*(u + v) equivalent x*u + x*v + y*u + y*v. names Format, .Format Heading special meaning; see section Formatting . interpretation terms formulas depends evaluate. term evaluates function, summary function  produces scalar value applied vector values, scalar displayed table.  example,  (mean + var) ~ x  display mean x variance x.  function specified, length assumed, table display counts.  (one summary function may specified one term, mean*var error.) term evaluates logical vector, assumed specify subset.  example,  ~ (x > 3) + (x > 5) tabulate counts two subsets. term evaluates factor, generates multiple rows columns, corresponding different levels factor.  example three levels, ~ mean*x calculate mean x within level . term evaluates language object, treated macro, expanded  place formula. terms assumed R expressions producing vector values summarized table.  one vector values can specified given term, different terms can summarize different values.  .atomic must  evaluate TRUE values recognized. logical, factor values table length, columns dataframe (can computed values).  n missing data dataframe, n set .  Otherwise, terms 1 appear table, length assumed previous terms. last resort, set n argument call tabular() explicitly. \"[\" method extracts subset table. indexing, consider table consist matrix containing values. drop=TRUE, labels attributes dropped.  drop=FALSE, default, j indices must select  rectangular block table; matrix indexing (using two column matrix full matrix logical values) supported.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"formatting","dir":"Reference","previous_headings":"","what":"Formatting","title":"Compute complex table — tabular","text":"tabular() function formatting computed values,  records requests formatting. format.tabular(), print.tabular() latex.tabular()  functions make use requests. default, columns formatted using format function, arguments digits arguments passed ....  column formatted separately, similarly matrix printed default. request special formatting, four pseudo-functions provided.  first Format.  Normally includes arguments pass format() function, e.g. Format(digits=2).  may instead include call function, e.g. Format(sprintf(\"%.2f\").  either case summary values cells table nested Format specification passed function argument named x, .e. first example, values formatted using format(digits=2, x=values),  second, using sprintf(\"%.2f\", x=values).  Users can supply function used formatting; take values named argument x return character vector length. can used control formatting multiple columns .  example, Format(digits=2)*(mean + sd) print mean standard deviation single call format, guaranteeing number decimal places used .  (iris example demonstrates .) latex argument latex.tabular TRUE,  effort made retain spacing, convert minus signs  appropriate type dash using latexNumeric function. second pseudo-function .Format mainly intended internal use.  takes single integer argument, saying data governed call uses formatting another format specification.  way entries can commonly formatted even contiguous.  integers assigned sequentially format specification parsed; users likely need trial error find right value complicated table multiple formats. third pseudo-function Justify.  takes character values names arguments; treated depends output format.  format.tabular, coarse justification done left, right center, using l, r c respectively. LaTeX formatting, string acceptable justification string LaTeX passed . final pseudo-function Heading.  Use function row definitions set heading following column row labels.  (Internally headings factor columns implemented.) called argument, suppresses following heading.  suppressLabels=n argument tabular() equivalent repeating Heading() n times start table formula.  = operator abbreviation Heading(); see .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"tabular-methods","dir":"Reference","previous_headings":"","what":"tabular methods","title":"Compute complex table — tabular","text":"default tabular method just applies .formula table, calls tabular.formula. tabular.formula method main workhorse package.  authors wish produce tables directly structures normally create formula whose environment contains mentioned variables call tabular.formula appropriate arguments.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute complex table — tabular","text":"object S3 class \"tabular\".  matrix mode list, whose entries computed summary values, following attributes: rowLabels matrix labels rows.  number rows main matrix, may multiple columns different nested levels labels. label covers multiple rows, entered first row, NA used fill following rows. colLabels Like rowLabels, labelling columns. table original table expression displayed.  list original format specifications attached \"fmtlist\" attribute. formats matrix shape main result, containing NA default formatting, index format list.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Compute complex table — tabular","text":"function inspired 20 year old memories SAS TABULATE procedure.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute complex table — tabular","text":"Duncan Murdoch","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute complex table — tabular","text":"","code":"tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ) #>                                                    #>                 Sepal.Length      Sepal.Width      #>  Species    n   mean         sd   mean        sd   #>  setosa      50 5.01         0.35 3.43        0.38 #>  versicolor  50 5.94         0.52 2.77        0.31 #>  virginica   50 6.59         0.64 2.97        0.32 #>  All        150 5.84         0.83 3.06        0.44  # This example shows some of the less common options          Sex <- factor(sample(c(\"Male\", \"Female\"), 100, rep=TRUE)) Status <- factor(sample(c(\"low\", \"medium\", \"high\"), 100, rep=TRUE)) z <- rnorm(100)+5 fmt <- function(x) {   s <- format(x, digits=2)   even <- ((1:length(s)) %% 2) == 0   s[even] <- sprintf(\"(%s)\", s[even])   s } tab <- tabular( Justify(c)*Heading()*z*Sex*Heading(Statistic)*Format(fmt())*(mean+sd)                  ~ Status ) tab #>                                        #>                   Status               #>   Sex   Statistic  high   low   medium #>  Female   mean     5.12   4.70   5.24  #>            sd     (0.78) (1.06) (1.07) #>   Male    mean     4.95   4.81   4.61  #>            sd     (0.94) (0.99) (1.09) tab[1:2, c(2,3,1)] #>                                        #>                   Status               #>   Sex   Statistic  low   medium  high  #>  Female   mean     4.70   5.24   5.12  #>            sd     (1.06) (1.07) (0.78)"},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to knitr_kable format. — toKable","title":"Convert tabular object to knitr_kable format. — toKable","text":"Converts output tabular related functions format consistent output kable function, can  customized using kableExtra package.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to knitr_kable format. — toKable","text":"","code":"toKable(table, format = getKnitrFormat(), booktabs = TRUE, ...) getKnitrFormat(default = \"latex\")"},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to knitr_kable format. — toKable","text":"table object class tabular. format type knitr_kable object desired; currently \"latex\" \"html\" supported. booktabs table rendered booktabs style? affects LaTeX output. ... Additional arguments pass html.tabular latex.tabular. default default type output running knitr document.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to knitr_kable format. — toKable","text":"object class knitr_kable, suitable passing functions kableExtra package.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/toKable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to knitr_kable format. — toKable","text":"","code":"if (requireNamespace(\"kableExtra\") &&      (!requireNamespace(\"pkgdown\") || !pkgdown::in_pkgdown())) {   tab <-  tabular( (Species + 1) ~ (n=1) + Format(digits=2)*           (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )   print(kableExtra::kable_styling(toKable(tab), latex_options = \"striped\"))   cat(\"\\n\")   toKable(tab, format = \"html\", options = list(HTMLcaption = \"Fisher's iris data\")) } #> Loading required namespace: kableExtra"},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert tabular object to tinytable format. — toTinytable","title":"Convert tabular object to tinytable format. — toTinytable","text":"Converts output tabular related functions format consistent output tt function, can  customized using tinytable package.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert tabular object to tinytable format. — toTinytable","text":"","code":"toTinytable(table, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert tabular object to tinytable format. — toTinytable","text":"table object class tabular. ... Additional arguments pass tt.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert tabular object to tinytable format. — toTinytable","text":"object class tinytable, suitable passing functions tinytable package. tables can exported several formats, including LaTeX, HTML, Markdown, Word, Typst, PDF, PNG.","code":""},{"path":[]},{"path":"https://dmurdoch.github.io/tables/reference/toTinytable.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convert tabular object to tinytable format. — toTinytable","text":"","code":"if (requireNamespace(\"tinytable\")) {    tab <-  tabular( (Species + 1) ~ (n=1) + Format(digits=2)*           (Sepal.Length + Sepal.Width)*(mean + sd), data=iris )   tab <- toTinytable(tab, theme = \"striped\")   tab <- tinytable::style_tt(tab, i = 1:2, background = \"teal\", color = \"white\")   tab  } #> +------------+-----+-------+-------+-------+-------+ #> |                  | Sepal.Length  | Sepal.Width   | #> +------------+-----+-------+-------+-------+-------+ #> | Species    | n   | mean  | sd    | mean  | sd    | #> +============+=====+=======+=======+=======+=======+ #> | setosa     |  50 | 5.01  | 0.35  | 3.43  | 0.38  | #> +------------+-----+-------+-------+-------+-------+ #> | versicolor |  50 | 5.94  | 0.52  | 2.77  | 0.31  | #> +------------+-----+-------+-------+-------+-------+ #> | virginica  |  50 | 6.59  | 0.64  | 2.97  | 0.32  | #> +------------+-----+-------+-------+-------+-------+ #> | All        | 150 | 5.84  | 0.83  | 3.06  | 0.44  | #> +------------+-----+-------+-------+-------+-------+"},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":null,"dir":"Reference","previous_headings":"","what":"Format table with groups of lines — useGroupLabels","title":"Format table with groups of lines — useGroupLabels","text":"factor level applies multiple lines table, normally extra column row labels added  show levels.  function merges column another column labels.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Format table with groups of lines — useGroupLabels","text":"","code":"useGroupLabels(tab, col = 1,                 indent = \"  \",                 newcolumn = 1,                singleRow = TRUE,                extraLines = 0)"},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Format table with groups of lines — useGroupLabels","text":"tab tabular object. col column defines groups? indent prefix add existing entries new column. newcolumn column gets  group headings? singleRow group single row entry newcolumn row, put group label row rather separate row. extraLines Add many blank lines separate groups addition line containing group label.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Format table with groups of lines — useGroupLabels","text":"tabular object, modified include header rows specified.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Format table with groups of lines — useGroupLabels","text":"newcolumn less 1 greater  number row label columns (removing column col), extra columns added.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/useGroupLabels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Format table with groups of lines — useGroupLabels","text":"","code":"set.seed(123) n <- 10 df <- data.frame(a = factor(sample(1:3, n, replace=TRUE)),                  b = factor(sample(1:3, n, replace=TRUE)),                  x = rnorm(n)) levels(df$a) <- c(\"Long name 1\", \"Long name 2\", \"Long name 3\") levels(df$b) <- c(\"a\", \"abc\", \"abcdef\") library(tables) tab <- tabular(a*Heading()*b ~ mean*x, data = df) tab <- tab[!is.na(tab[,1])] useGroupLabels(tab) #>                      #>              mean    #>              x       #>  Long name 1         #>    a         -0.2159 #>  Long name 2         #>    a          0.8255 #>    abc       -1.0489 #>    abcdef    -0.4200 #>  Long name 3         #>    a         -0.2476 #>    abc        1.5387 #>    abcdef     1.2948"},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":null,"dir":"Reference","previous_headings":"","what":"Write table to file in CSV or other format. — write.csv.tabular","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"writes formatted table CSV delimeted file, import spreadsheet  report writer.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"","code":"write.csv.tabular(x, file=\"\",      justification = \"n\", row.names=FALSE, ...) write.table.tabular(x, file=\"\",      justification = \"n\", row.names=FALSE, col.names=FALSE, ...)"},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"x object tabular. file filename connection write. justification Parameter pass format.tabular. row.names, col.names Parameters pass write.csv write.table ... Parameters pass format.tabular write.table; see Details .","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"write.csv.tabular writes simple version table (similar produced print.tabular) given connection CSV format, using write.csv. write.table.tabular similarly using general write.table. optional arguments ... sent write.csv/write.table names exactly match parameters write.table; otherwise, sent format.tabular.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"return value write.csv write.table.","code":""},{"path":"https://dmurdoch.github.io/tables/reference/write.csv.tabular.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write table to file in CSV or other format. — write.csv.tabular","text":"","code":"if (FALSE) { # This writes a table to the clipboard on Windows using tab delimiters, for # easy import into a spreadsheet.  write.table.tabular(      tabular( (Species + 1) ~ (n=1) + Format(digits=2)*          (Sepal.Length + Sepal.Width)*(mean + sd), data=iris ),     \"clipboard\", sep=\"\\t\") }"},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0928","dir":"Changelog","previous_headings":"","what":"tables 0.9.28","title":"tables 0.9.28","text":"factor level \"\" caused error displayed. now changed \" \" display (issue #19). VignetteBuilder field DESCRIPTION changed rmarkdown Pandoc can found even PATH. Another minor update due changes formatters package.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0925","dir":"Changelog","previous_headings":"","what":"tables 0.9.25","title":"tables 0.9.25","text":"CRAN release: 2024-04-13 PlusMinus() Paste() didn’t handle formatting properly multiple columns involved (issue #13). toLatex() non-empty file argument didn’t write file properly. (Reported Reinhard Kerschner F. Hortner.) cases () give error (issue #17). toTinytable() function added work tinytable package. Minor update due changes formatters package.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0917","dir":"Changelog","previous_headings":"","what":"tables 0.9.17","title":"tables 0.9.17","text":"CRAN release: 2023-05-02 Change host Github. Add useGroupLabels() function. Add HTMLfootnotes() function. Add method formatters::matrix_form.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0910","dir":"Changelog","previous_headings":"","what":"tables 0.9.10","title":"tables 0.9.10","text":"CRAN release: 2022-10-17 rbind() failed complicated example, classes names column labels differed. Error messages rbind() cbind() made helpful.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-098","dir":"Changelog","previous_headings":"","what":"tables 0.9.8","title":"tables 0.9.8","text":"() didn’t work tibbles. (Reported Vincent Arel-Bundock.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-097","dir":"Changelog","previous_headings":"","what":"tables 0.9.7","title":"tables 0.9.7","text":"toHTML() ignoring file argument.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-094","dir":"Changelog","previous_headings":"","what":"tables 0.9.4","title":"tables 0.9.4","text":"CRAN release: 2020-08-28 Minor update fix test note.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-093","dir":"Changelog","previous_headings":"","what":"tables 0.9.3","title":"tables 0.9.3","text":"CRAN release: 2020-05-26 Added latexTable() function, provide captions, labels, etc. Added knitrTable vignette.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-09","dir":"Changelog","previous_headings":"","what":"tables 0.9","title":"tables 0.9","text":"Reduced dependence Hmisc.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-088","dir":"Changelog","previous_headings":"","what":"tables 0.8.8","title":"tables 0.8.8","text":"CRAN release: 2019-05-13 Updates fix CRAN errors.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-087","dir":"Changelog","previous_headings":"","what":"tables 0.8.7","title":"tables 0.8.7","text":"CRAN release: 2018-11-11 Added … argument toKable() options can passed control conversion. (Thanks Mary Putt pointing need .) Fixed bug .tabular.data.frame() failed columns factors. (Reported Daniel Farewell.) Fixed incompatibility new version fancyvrb. (Thanks Prof. Brian Ripley working solution.) Fixed incompatibility rmarkdown/knitr new version.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-084","dir":"Changelog","previous_headings":"","what":"tables 0.8.4","title":"tables 0.8.4","text":"CRAN release: 2018-05-21 Added check bad args DropEmpty(), fixed example . Added “nearData” argument Heading() etc, fix Hline() bug reported Johannes Ranke. Fixed bug justification row labels. Fixed bug statistic wrong length, reported Stefan Marr. Added toKable() function, use kableExtra package. Added knit_print.tabular() method, tabular objects print correct formatting knitr documents.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-08","dir":"Changelog","previous_headings":"","what":"tables 0.8","title":"tables 0.8","text":"CRAN release: 2017-01-03 Allow editing row column labels. Added DropEmpty() pseudo-function. Added AllObs() RowNum() formula functions. Added character.argument Heading() Paste().","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0791","dir":"Changelog","previous_headings":"","what":"tables 0.7.91","title":"tables 0.7.91","text":"Updated options html.tabular use better CSS HTML5 tables. Added HTML vignette. Fixed bug: functions prefixed “pkg::” formulas led warning messages. (Reported Lars Bishop.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0788","dir":"Changelog","previous_headings":"","what":"tables 0.7.88","title":"tables 0.7.88","text":"Edited messages allow internationalization. translations added far.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0787","dir":"Changelog","previous_headings":"","what":"tables 0.7.87","title":"tables 0.7.87","text":"Added “append” argument latex.tabular() html.tabular(), made explicit connections allowed “file” argument. (Suggestion Marc Halperin.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0786","dir":"Changelog","previous_headings":"","what":"tables 0.7.86","title":"tables 0.7.86","text":"Fixed scoping bug: locally defined format functions always found. (Reported Doug Ezra Morrison.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0779","dir":"Changelog","previous_headings":"","what":"tables 0.7.79","title":"tables 0.7.79","text":"CRAN release: 2014-07-24 Added Equal() Unequal() pseudo-functions flexible Percent() calculations. Fixed bug handling factors excluded NA values. Added “formula” attribute tabular.formula results. Added .tabular() function. Added Arguments() function allow multi-argument analysis functions.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0768","dir":"Changelog","previous_headings":"","what":"tables 0.7.68","title":"tables 0.7.68","text":"Bug fix setting column headings (reported Lars Bishop).","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0767","dir":"Changelog","previous_headings":"","what":"tables 0.7.67","title":"tables 0.7.67","text":"cbind() rbind() methods now allow NULL list arguments. (Suggestion Jeff Newmiller.) Added note vignette use RowFactor nopagebreak longtable environment. (Based sleuthing Jeffrey Miller.) Added HTMLcaption table options insert HTML caption. (Suggestion Joseph Larmarange.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0764","dir":"Changelog","previous_headings":"","what":"tables 0.7.64","title":"tables 0.7.64","text":"CRAN release: 2013-11-12 Added support HTML output. Added support extraction subsets matrix. Added Paste() function. summary doesn’t produce scalar value, formatting messed display. Now warning issued cell displayed  similar. Added cbind() rbind() methods tabular objects. internal texify() function work properly.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-0748","dir":"Changelog","previous_headings":"","what":"tables 0.7.48","title":"tables 0.7.48","text":"Default formatting now skips character cells. Justification labels text mode wasn’t done properly.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-07","dir":"Changelog","previous_headings":"","what":"tables 0.7","title":"tables 0.7","text":"CRAN release: 2012-12-14 RowFactor now allows spacing=1. Specifications justification table_options() now recycled. Missing values handled correctly computing counts, working factors. (Reported Manuel Reif.) Added Percent() pseudo-function. Cleaned handling row column labels, especially cases rows different column headings summed. Added optional parameter Heading() use another hasn’t already set.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-06","dir":"Changelog","previous_headings":"","what":"tables 0.6","title":"tables 0.6","text":"CRAN release: 2012-04-02 Fixed bug column headings print.tabular (reported Tal Galili) Added Factor(). Fixed bug zero columns row labels. Added levelnames argument RowFactor Factor allow label customization. Added Multicolumn function. Added .matrix(), write.csv.tabular() write.table.tabular() (suggestions Greg Snow). Added LaTeX escapes text body labels constructed () factor labels. (Suggestion Dieter Menne.) Added caption longtable example. (Suggestion Dieter Menne.) Added version number vignette title page. Fixed RowFactor add space first row, last row. (Bug report Dieter Menne.) Made tabular() generic function. (Suggestion Hadley Wickham.) Added description missing values vignette. Fixed handling data Hmisc “labelled” class attached. (Reported Thomas MacFarland.)","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-05","dir":"Changelog","previous_headings":"","what":"tables 0.5","title":"tables 0.5","text":"CRAN release: 2011-12-07 Planned CRAN release ","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-04","dir":"Changelog","previous_headings":"","what":"tables 0.4","title":"tables 0.4","text":"Added (), Literal() RowFactor() Added table_options() booktabs() booktabs support Gave different defaults row label justification data justification Suppress page breaks RowFactor(). Allow options set temporarily latex() call. Added options suppress parts output.","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-03","dir":"Changelog","previous_headings":"","what":"tables 0.3","title":"tables 0.3","text":"CRAN release: 2011-11-29 Renamed “tabular” “tables”, put R-forge","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-02","dir":"Changelog","previous_headings":"","what":"tables 0.2","title":"tables 0.2","text":"First reasonably complete release","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-01","dir":"Changelog","previous_headings":"","what":"tables 0.1","title":"tables 0.1","text":"First alpha version Hmisc support","code":""},{"path":"https://dmurdoch.github.io/tables/news/index.html","id":"tables-00","dir":"Changelog","previous_headings":"","what":"tables 0.0","title":"tables 0.0","text":"Various abortive attempts","code":""}]