# Create an object summarizing categorical variables

### Description

Create an object summarizing categorical variables optionally stratifying by one or more startifying variables and performing statistical tests. Usually, `CreateTableOne`

should be used as the universal frontend for both continuous and categorical data.

### Usage

1 2 3 4 | ```
CreateCatTable(vars, strata, data, includeNA = FALSE, test = TRUE,
testApprox = chisq.test, argsApprox = list(correct = TRUE),
testExact = fisher.test, argsExact = list(workspace = 2 * 10^5),
smd = TRUE)
``` |

### Arguments

`vars` |
Variable(s) to be summarized given as a character vector. |

`strata` |
Stratifying (grouping) variable name(s) given as a character vector. If omitted, the overall results are returned. |

`data` |
A data frame in which these variables exist. All variables (both vars and strata) must be in this data frame. |

`includeNA` |
If TRUE, NA is handled as a regular factor level rather than missing. NA is shown as the last factor level in the table. Only effective for categorical variables. |

`test` |
If TRUE, as in the default and there are more than two groups, groupwise comparisons are performed. Both tests that require the large sample approximation and exact tests are performed. Either one of the result can be obtained from the print method. |

`testApprox` |
A function used to perform the large sample approximation based tests. The default is |

`argsApprox` |
A named list of arguments passed to the function specified in testApprox. The default is |

`testExact` |
A function used to perform the exact tests. The default is |

`argsExact` |
A named list of arguments passed to the function specified in testExact. The default is |

`smd` |
If TRUE, as in the default and there are more than two groups, standardized mean differences for all pairwise comparisons are calculated. |

### Value

An object of class `CatTable`

.

### Author(s)

Kazuki Yoshida (based on `Deducer::frequencies()`

)

### See Also

`CreateTableOne`

, `print.CatTable`

, `summary.CatTable`

### Examples

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 | ```
## Load
library(tableone)
## Load Mayo Clinic Primary Biliary Cirrhosis Data
library(survival)
data(pbc)
## Check variables
head(pbc)
## Create an overall table for categorical variables
catVars <- c("status","ascites","hepato","spiders","edema","stage")
catTableOverall <- CreateCatTable(vars = catVars, data = pbc)
## Simply typing the object name will invoke the print.CatTable method,
## which will show the sample size, frequencies and percentages.
## For 2-level variables, only the higher level is shown for simplicity
## unless the variables are specified in the cramVars argument.
catTableOverall
## If you need to show both levels for some 2-level factors, use cramVars
print(catTableOverall, cramVars = "hepato")
## Use the showAllLevels argument to see all levels for all variables.
print(catTableOverall, showAllLevels = TRUE)
## You can choose form frequencies ("f") and/or percentages ("p") or both.
## "fp" frequency (percentage) is the default. Row names change accordingly.
print(catTableOverall, format = "f")
print(catTableOverall, format = "p")
## To further examine the variables, use the summary.CatTable method,
## which will show more details.
summary(catTableOverall)
## The table can be stratified by one or more variables
catTableBySexTrt <- CreateCatTable(vars = catVars,
strata = c("sex","trt"), data = pbc)
## print now includes p-values which are by default calculated by chisq.test.
## It is formatted at the decimal place specified by the pDigits argument
## (3 by default). It is formatted like <0.001 if very small.
catTableBySexTrt
## The exact argument toggles the p-values to the exact test result from
## fisher.test. It will show which ones are from exact tests.
print(catTableBySexTrt, exact = "ascites")
## summary now includes both types of p-values
summary(catTableBySexTrt)
## If your work flow includes copying to Excel and Word when writing manuscripts,
## you may benefit from the quote argument. This will quote everything so that
## Excel does not mess up the cells.
print(catTableBySexTrt, exact = "ascites", quote = TRUE)
## If you want to center-align values in Word, use noSpaces option.
print(catTableBySexTrt, exact = "ascites", quote = TRUE, noSpaces = TRUE)
``` |

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker. Vote for new features on Trello.