pt_cat_long: Discrete data summary in long format

In metrumresearchgroup/pmtables: Tables for Pharmacometrics

Discrete data summary in long format

Description

Discrete data summary in long format

Usage

pt_cat_long(
  data,
  cols,
  span = ".total",
  all_name = " ",
  all_name_span = "Summary",
  summarize = c("both", "right", "top", "none"),
  table = NULL,
  by = NULL,
  denom = c("group", "total")
)

Arguments

data	the data frame to summarize; the user should filter or subset so that data contains exactly the records to be summarized; pmtables will not add or remove rows prior to summarizing data
cols	the columns to summarize; may be character vector or quosure
span	variable name for column spanner
all_name	a name to use for the complete data summary
all_name_span	table column name to use for data summaries across levels of span if it is provided
summarize	where to include a data summary across subgroups; use none to drop the summary from the table
table	a named list to use for renaming columns (see details and examples)
by	use span argument instead
denom	the denominator to use when calculating percent for each level; group uses the total number in the chunk being summarized; total uses the total number in the data set; historically, group has been used as the default.

Details

The data summary for all cells in the table is count (percent). The number of data records in each column variable level is given under the column title as n.

When group is selected for denom, percent is calculated with denominator set to n, the total for each column variable level. When total is selected for denom, then percent is calculated by the total number of records in the input data.

The notes in this table are generated with pt_cat_long_notes().

Value

An object with class pmtable; see class-pmtable.

Examples

out <- pt_cat_long(pmt_first, cols = "SEXf,ASIANf", span = "FORMf")

## Not run: 
st2report(stable(out))

## End(Not run)

metrumresearchgroup/pmtables documentation built on Oct. 27, 2024, 5:16 p.m.