eta_vs_catcov: Eta categorical covariate plots (typical)

In xpose.xtras: Extra Functionality for the 'xpose' Package

Eta categorical covariate plots (typical)

Description

Eta categorical covariate plots (typical)

Usage

eta_vs_catcov(
  xpdb,
  mapping = NULL,
  etavar = NULL,
  drop_fixed = TRUE,
  orientation = "x",
  show_n = check_xpdb_x(xpdb, .warn = FALSE),
  type = "bol",
  title = "Eta versus categorical covariates | @run",
  subtitle = "Based on @nind individuals, Eta shrink: @etashk",
  caption = "@dir",
  tag = NULL,
  facets,
  .problem,
  quiet,
  ...
)

Arguments

xpdb	<⁠xp_xtras> or <⁠xpose_data'> object
mapping	ggplot2 style mapping
etavar	tidyselect for eta variables
drop_fixed	As in xpose
orientation	Passed to xplot_boxplot
show_n	Add "N=" to plot
type	Passed to xplot_boxplot
title	Plot title
subtitle	Plot subtitle
caption	Plot caption
tag	Plot tag
facets	Additional facets
.problem	Problem number
quiet	Silence output
...	Any additional aesthetics.

Details

The ability to show number per covariate level is inspired by the package pmplots, but is implements here within the xpose ecosystem for consistency.

Value

The desired plot

Examples

eta_vs_catcov(xpdb_x)

# Labels and units are also supported
xpdb_x %>%
  xpose::set_var_labels(AGE="Age", MED1 = "Digoxin") %>%
  xpose::set_var_units(AGE="yrs") %>%
  set_var_levels(SEX=lvl_sex(), MED1 = lvl_bin()) %>%
  eta_vs_catcov()

xpose.xtras documentation built on Aug. 23, 2025, 9:07 a.m.