likert.options: Builds an object with options for plotting 'likert' results.

In jbryer/likert: Analysis and Visualization Likert Items

Builds an object with options for plotting 'likert' results.

Description

This function specifies all the plotting options for Likert plots.

Usage

likert.options(
  low.color = "#D8B365",
  high.color = "#5AB4AC",
  neutral.color = "grey90",
  neutral.color.ramp = "white",
  colors = NULL,
  plot.percent.low = TRUE,
  plot.percent.high = TRUE,
  plot.percent.neutral = TRUE,
  plot.percents = FALSE,
  text.size = 3,
  text.color = "black",
  text.color.manual.pos = NULL,
  text.color.manual.neg = NULL,
  text.color.manual.neutral = NULL,
  centered = TRUE,
  include.center = TRUE,
  ordered = TRUE,
  wrap = 50,
  wrap.grouping = 50,
  legend = "Response",
  ylabel = "Percentage",
  legend.position = c("bottom", "top", "left", "right", "none"),
  panel.arrange = "v",
  panel.strip.color = "#F0F0F0",
  digits = 2,
  drop0trailing = FALSE,
  zero.print = TRUE,
  ...
)

Arguments

low.color	color for low values.
high.color	color for high values.
neutral.color	color for middle values (if odd number of levels).
neutral.color.ramp	second color used when calling [colorRamp()]. with low.color and high.color to define the color palettes.
colors	vector specifying the colors to use. This must be equal to the number of likert levels.
plot.percent.low	whether to plot low percentages.
plot.percent.high	whether to plot high percentages.
plot.percent.neutral	whether to plot netural percentages.
plot.percents	whether to label each category/bar.
text.size	size of text attributes.
text.color	color of text attributes.
text.color.manual.pos	individual color specification of positive text attributes.
text.color.manual.neg	individual color specification of negative text attributes.
text.color.manual.neutral	individual color specification of neutral text attributes.
centered	if true, the bar plot will be centered around zero such that the lower half of levels will be negative.
include.center	if TRUE, include the center level in the plot otherwise the center will be excluded.
ordered	reorder items from high to low.
wrap	width to wrap label text for item labels
wrap.grouping	width to wrap label text for group labels.
legend	title for the legend.
ylabel	label for the y-axis
legend.position	the position for the legend ("left", "right", "bottom", "top", or two-element numeric vector).
panel.arrange	how panels for grouped likert items should be arrange. Possible values are v (vertical, the default), h (horizontal), and NULL (auto fill horizontal and vertical)
panel.strip.color	the background color for panel labels.
digits	the number of significant digits to print.
drop0trailing	logical, indicating if trailing zeros, i.e., "0" after the decimal mark, should be removed
zero.print	logical, character string or NULL specifying if and how zeros should be formatted specially.
...	included for future expansion.

jbryer/likert documentation built on June 13, 2025, 7:56 p.m.