Skip to content
forked from CTU-Bern/btabler

Package for easy creation of latex tables

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

aghaynes/btabler

 
 

Repository files navigation

btabler

R-CMD-fullcheck

btabler is a package which adds wraps the xtable package, adding additional functionality such as merging header columns.

Note that btabler does not produce HTML tables. If using .Rmd, output should be pdf_document.

Example usage

Installing the package

The package can be installed from the CTU Bern universe via

install.packages('btabler', repos = 'https://ctu-bern.r-universe.dev')

Using the package

Load it as usual:

library(btabler)

Create your tables via whatever means and pass them to the btable function:

df <- data.frame(name = c("", "Row 1", "Row2"),
                 out_t = c("Total", "t1", "t1"),
                 out_1 = c("Group 1", "g11", "g12"), 
                 out_2 = c("Group 2", "g21", "g22"))
btable(df, nhead = 1, nfoot = 0, caption = "Table1")

btable returns the latex code for the table you passed, which can be easily used with sweave to create tables in reports.

As an example for further modifications, column widths can also be modified using the aligntot argument:

btable(df, nhead = 1, nfoot = 0, 
       caption = "Table1", 
       aligntot = "p{3cm}p{1.5cm}p{1.5cm}p{1.5cm}")

See the vignette for further examples of using btabler

vignette("btabler")

Requirements for the header

btabler tables are only interpretable by LaTeX when a few packages are loaded. It is recommended to place the following code in the header of your .tex file or .Rmd

# .tex
\usepackage{longtable}
\usepackage{booktabs}
\usepackage{float}
\usepackage{array}

# .Rmd
header-includes:
  - \usepackage{longtable}
  - \usepackage{booktabs}
  - \usepackage{float}
  - \usepackage{array}

Other things like custom column types can also be added to the header (see the vignette for an example)

vignette("btabler")

btabler provides basic templates in Rmd and Rnw formats:

use_btabletemplate("filename", "Rmd")

Acknowledgements

The package logo was created with ggplot2 and hexSticker with icons from Font Awesome (via the emojifont package).

About

Package for easy creation of latex tables

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • R 100.0%