schola_barplot: Plot standard Schola likert-like barplot with groupwise...

In scholaempirica/reschola: The Schola Empirica Package

Plot standard Schola likert-like barplot with groupwise comparison per items

Description

TODO description...

Usage

schola_barplot(
  .data,
  vars,
  group,
  dict = dict_from_data(.data),
  escape_level = "nevím",
  n_breaks = 11,
  desc = TRUE,
  labels = TRUE,
  min_label_width = 0.09,
  absolute_counts = TRUE,
  fill_cols = NULL,
  fill_labels = waiver(),
  facet_label_wrap = 115,
  reverse = FALSE,
  order_by = "chi-square differences",
  drop = FALSE,
  drop_na = TRUE,
  ...
)

Arguments

.data	data with items and group variable
vars	vector of items, supports tidyselect syntax (i.e, non-standard evaluation)
group	group variable used to split the results, have to be logical, where TRUE is gonna be considered as "focal" group and displayed as upper group with full opacity. Supports tidyselect syntax.
dict	item code-label dictionary, if none provided, those are derived from the data.
escape_level	character, level of item response considered as NA
n_breaks	number of breaks displayed at x-axis, outer labels are automatically aligned to face inward. Defaults to 11, which results in 10% wide breaks.
desc	sor items in descending order?
labels	draw labels?
min_label_width	smallest percentage (0-1) to display in the plot, proportions larger than this value are shown, smaller are not.
absolute_counts	draw labels and absolute counts in parentheses?
fill_cols	colors to be used for item categories, defaults to NULL, meaning standard RdYlBu palette will be used
fill_labels	character vector or function taking breaks and returning labels for fill aesthetic
facet_label_wrap	width of facet label to wrap
reverse	if TRUE, reverse colors
order_by	how to order the items. chi-square differences (default) computes chi-square test for every item and sort them by largest X2 statistic to smallest (if desc = TRUE)
drop	Drop unobserved levels form the legend? Defaults to FALSE. See ggplot2::discrete_scale for more details.
drop_na	Drop NAs from every item (a.k.a. "pairwise")? Defaults to TRUE. Note that the number of observations per item may differ, because NA in one item does not mean the respondent row is discarded completely (listwise).
...	Arguments passed on to fct_nanify negate logical, whether to return non-matching elements. Defaults to FALSE. ignore_case logical, ignore case when matching? Defaults to TRUE.

Details

TODO details...

Value

object of class "gg", "ggplot"

See Also

Other Making charts: flush_axis, plot_lollipop(), prepare_lollipop_data(), theme_schola()

scholaempirica/reschola documentation built on Feb. 1, 2024, 12:26 a.m.