# arsenal v3.5.0

Monthly downloads

## An Arsenal of 'R' Functions for Large-Scale Statistical Summaries

An Arsenal of 'R' functions for large-scale statistical summaries,
which are streamlined to work within the latest reporting tools in 'R' and
'RStudio' and which use formulas and versatile summary statistics for summary
tables and models. The primary functions include tableby(), a Table-1-like
summary of multiple variable types 'by' the levels of one or more categorical
variables; paired(), a Table-1-like summary of multiple variable types paired across
two time points; modelsum(), which performs simple model fits on one or more endpoints
for many variables (univariate or adjusted for covariates);
freqlist(), a powerful frequency table across many categorical variables;
comparedf(), a function for comparing data.frames; and
write2(), a function to output tables to a document.

## Readme

# The `arsenal`

Package

## Overview

The goal of `library(arsenal)`

is to make statistical reporting easy. It includes many functions which the useR will find useful to have
in his/her "arsenal" of functions. There are, at this time, 6 main functions, documented below. Each of these functions is
motivated by a local SAS macro or procedure of similar functionality.

Note that `arsenal`

v3.0.0 is not backwards compatible with previous versions (mainly because `compare()`

got renamed to `comparedf()`

).
See the `NEWS`

file for more details.

`arsenal`

now has a `pkgdown`

site: https://mayoverse.github.io/arsenal/

## The `tableby()`

Function

`tableby()`

is a function to easily summarize a set of independent variables by one or more categorical variables.
Optionally, an appropriate test is performed to test the distribution of the independent variables across
the levels of the categorical variable. Options for this function are easily controlled using `tableby.control()`

.

The `tableby()`

output is easily knitted in an Rmarkdown document or displayed in the command line using the `summary()`

function.
Other S3 methods are implemented for objects from `tableby()`

, including `print()`

, `[`

, `as.data.frame()`

, `sort()`

, `merge()`

, `padjust()`

,
`head()`

, and `tail()`

.

## The `paired()`

Function

`paired()`

is a function to easily summarize a set of independent variables across two time points.
Optionally, an appropriate test is performed to test the distribution of the independent variables across
the time points. Options for this function are easily controlled using `paired.control()`

.

The `paired()`

output is easily knitted in an Rmarkdown document or displayed in the command line using the `summary()`

function.
It has the same S3 methods as `tableby()`

, since it's a special case of the `tableby()`

object.

## The `modelsum()`

Function

`modelsum()`

is a function to fit and summarize models for each independent variable with one or more response variables,
with options to adjust for covariates for each model. Options for this function are easily controlled using `modelsum.control()`

.

The `modelsum`

output is easily knitted in an Rmarkdown document or displayed in the command line using the `summary()`

function.
Other S3 methods are implemented for objects from `modelsum()`

, including `print()`

, `[`

, `as.data.frame()`

, and `merge()`

.

## The `freqlist()`

Function

`freqlist()`

is a function to approximate the output from SAS's `PROC FREQ`

procedure when using the `/list`

option of the `TABLE`

statement.
Options for this function are easily controlled using `freq.control()`

.

The `freqlist()`

output is easily knitted in an Rmarkdown document or displayed in the command line using the `summary()`

function.
Other S3 methods are implemented for objects from `freqlist()`

, including `print()`

, `[`

, `as.data.frame()`

, `sort()`

, and `merge()`

.
Additionally, the `summary()`

output can be used with `head()`

or `tail()`

.

## The `comparedf()`

Function

`comparedf()`

compares two data.frames and reporting any differences between them,
much like SAS's `PROC COMPARE`

procedure.

The `comparedf()`

output is easily knitted in an Rmarkdown document or displayed in the command line using the `summary()`

function.
Other S3 methods are implemented for objects of class `"comparedf"`

, including `print()`

, `n.diffs()`

, `n.diff.obs()`

, and `diffs()`

.

## The `write2*()`

Family of Functions

`write2word()`

, `write2pdf()`

, and `write2html()`

are functions to output a table into a document, much like SAS's `ODS`

procedure.
The S3 method behind them is `write2()`

. There are methods implemented for `tableby()`

, `modelsum()`

, `freqlist()`

, and `comparedf()`

, and
also methods for `knitr::kable()`

, `xtable::xtable()`

, and `pander::pander_return()`

. Another option is to coerce an object using
`verbatim()`

to print out the results monospaced (as if they were in the terminal)--the default method does this automatically.
To output multiple tables into a document, simply make a list of them and call the same function as before. A YAML
header can be added using `yaml()`

. Code chunks can be written using `code.chunk()`

.

For more information, see `vignette("write2")`

.

## Other Notable Functions

`keep.labels()`

keeps the`'label'`

attribute on an R object when subsetting.`loosen.labels()`

allows the labels to drop again.`formulize()`

is a shortcut to collapse variable names into a formula.`mdy.Date()`

and`Date.mdy()`

convert numeric dates for month, day, and year to Date object, and vice versa.`is.Date`

: tests if an object is a date.`%nin%`

tests for "not in", the negation of`%in%`

.`allNA()`

tests for all elements being NA, and`includeNA()`

makes NAs explicit values.

## Functions in arsenal

Name | Description | |

arsenal-defunct | Defunct functions in arsenal | |

as.data.frame.freqlist | as.data.frame.freqlist | |

comparedf.control | Control settings for comparedf function | |

NA.operations | Some functions to handle NAs | |

comparedf | Compare two data.frames and report differences | |

arsenal_table | arsenal tables with common structure | |

arsenal | An Arsenal of 'R' Functions for Large-Scale Statistical Summaries | |

arsenal-deprecated | Deprecated functions in arsenal | |

as.data.frame.tableby | as.data.frame.tableby | |

as.data.frame.modelsum | as.data.frame.modelsum | |

comparedf.tolerances | comparedf tolerances | |

freq.control | Control settings for freqlist function | |

formulize | formulize | |

%nin% | Not in | |

mdy.Date | Convert numeric dates to Date object, and vice versa | |

internal.functions | Split a string into pieces intelligently | |

mockstudy | Mock study data for examples | |

modelsum.internal | Helper functions for modelsum | |

modelsum.family | Family functions for modelsum | |

padjust | Adjust P-values for Multiple Comparisons | |

diffs | Extract differences | |

paired | Summary Statistics of a Set of Independent Variables Paired Across Two Timepoints | |

freqlist | freqlist | |

freqlist.internal | Helper functions for freqlist | |

modelsum.control | Control settings for modelsum function | |

modelsum | Fit models over each of a set of independent variables with a response variable | |

summary.modelsum | Summarize a modelsum object. | |

keep.labels | Keep Labels | |

tableby.internal | Helper functions for tableby | |

tableby.stats | tableby Summary Statistics Functions | |

summary.freqlist | summary.freqlist | |

tableby | Summary Statistics of a Set of Independent Variables by a Categorical Variable | |

summary.comparedf | The summary method for a comparedf object | |

tableby.stats.internal | Internal tableby functions | |

labels | Labels | |

tableby.control | Control settings for tableby function | |

yaml | Include a YAML header in write2 | |

summary.tableby | The summary method for a tableby object | |

write2 | write2 | |

write2specific | write2word, write2html, write2pdf | |

write2.internal | Helper functions for write2 | |

paired.control | Control settings for paired function | |

paired.internal | Helper functions for paired | |

No Results! |

## Vignettes of arsenal

Name | ||

comparedf.Rmd | ||

freqlist.Rmd | ||

labels.Rmd | ||

modelsum.Rmd | ||

paired.Rmd | ||

tableby.Rmd | ||

write2.Rmd | ||

No Results! |

## Last month downloads

## Details

Date | 2020-07-10 |

URL | https://github.com/mayoverse/arsenal, https://cran.r-project.org/package=arsenal, https://mayoverse.github.io/arsenal/ |

BugReports | https://github.com/mayoverse/arsenal/issues |

VignetteBuilder | knitr |

License | GPL (>= 2) |

RoxygenNote | 7.1.0 |

LazyData | true |

Encoding | UTF-8 |

NeedsCompilation | no |

Packaged | 2020-07-13 15:26:55 UTC; m144326 |

Repository | CRAN |

Date/Publication | 2020-07-13 18:10:13 UTC |

suggests | broom (>= 0.7.0) , coin , gam , magrittr , MASS , pander , pROC , rmarkdown , rpart , stringr , survival (>= 2.41-3) , testthat , xtable , yaml |

imports | knitr (>= 1.29) , utils (>= 3.4.0) |

depends | R (>= 3.4.0) , stats (>= 3.4.0) |

Contributors | Jason Sinnwell, Elizabeth Atkinson, Tina Gunderson, Gregory Dougherty, Patrick Votruba, Emily Lundt, Ryan Lennon, Krista Goergen, Andrew Hanson, Brendan Broderick, Maddie McCullough |

#### Include our badge in your README

```
[![Rdoc](http://www.rdocumentation.org/badges/version/arsenal)](http://www.rdocumentation.org/packages/arsenal)
```