overview_nominal: Calculates descriptive statistics for a numerical variable

View source: R/overview_nominal.R

overview_nominalR Documentation

Calculates descriptive statistics for a numerical variable

Description

This function calculated basic descriptive statistics for a categorical/ nominal variable. Inputs can be summary data, vectors, or a data frame.

Usage

overview_nominal(
  data = NULL,
  outcome_variable = NULL,
  grouping_variable = NULL,
  cases = NULL,
  outcome_variable_levels = NULL,
  outcome_variable_name = "My Outcome Variable",
  grouping_variable_name = "My Grouping Variable",
  conf_level = 0.95,
  count_NA = FALSE
)

Arguments

data
  • for raw data, a data frame or tibble

outcome_variable
  • for raw data, either a vector containing factor data or the name of a data-frame column containing a factor

grouping_variable
  • for raw data, either NULL (default), or the vector of a factor or a data-frame column containing a factor

cases

For summary data - A vector of 1 or more counts, integers>0

outcome_variable_levels

For summary data - An optional vector of group labels, same length as cases. If not passed, auto-generated.

outcome_variable_name

Optional friendly name for the outcome variable. Defaults to 'My Outcome Variable'. Ignored if a data-frame is passed, this argument is ignored.

grouping_variable_name

Optional friendly name for the grouping variable. Defaults to 'My Grouping Variable'. Ignored for summary data and for data frames – only used if vectors of data are passed.

conf_level

The confidence level for the confidence interval. Given in decimal form. Defaults to 0.95.

count_NA

Logical to count NAs (TRUE) in total N or not (FALSE)

Value

Returns a table of descriptive statistics

  • overview_nominal

    • outcome_variable_name -

    • outcome_variable_level -

    • cases -

    • n -

    • P -

    • P_LL -

    • P_UL -

    • P_SE -

    • P_adjusted -

    • ta_LL -

    • ta_UL -

Examples

# example code
esci::overview_nominal(esci::data_latimier_3groups, "Group")


rcalinjageman/esci documentation built on March 29, 2024, 7:30 p.m.