plot_expected_categories_1D: Plot expected univariate (1D) category likelihoods

In hlplab/MVBeliefUpdatr: Fitting, Summarizing, and Visualizing of Multivariate Gaussian Ideal Observers and Adaptors

Plot expected univariate (1D) category likelihoods

Description

Plot univariate Gaussian categories expected given NIW belief(s). One NIW belief describes the uncertainty about the category statistics of all categories. This includes the m (the mean of category means \mu), S (the scattermatrix), kappa (the strength of the belief in m) and nu (the strength of the belief in S). For the univariate case, m and S are scalars \insertCite@see @murphy2012 p. 136MVBeliefUpdatr.

Usage

plot_expected_categories_density_1D(
  x,
  data.exposure = NULL,
  data.test = NULL,
  facet_rows_by = NULL,
  facet_cols_by = NULL,
  facet_wrap_by = NULL,
  animate_by = NULL,
  animation_follow = F,
  xlim,
  ylim = NULL,
  x.expand = c(0, 0),
  category.ids = NULL,
  category.labels = NULL,
  category.colors = NULL,
  category.linetypes = NULL,
  ...
)

plot_expected_categories_density1D(
  x,
  data.exposure = NULL,
  data.test = NULL,
  facet_rows_by = NULL,
  facet_cols_by = NULL,
  facet_wrap_by = NULL,
  animate_by = NULL,
  animation_follow = F,
  xlim,
  ylim = NULL,
  x.expand = c(0, 0),
  category.ids = NULL,
  category.labels = NULL,
  category.colors = NULL,
  category.linetypes = NULL,
  ...
)

Arguments

x	An NIW_belief or NIW_beliefs object.
data.exposure	Optional tibble or data.frame that contains exposure data to be plotted. (default: 'NULL')
data.test	Optional tibble or data.frame that contains test data to be plotted. (default: 'NULL')
facet_rows_by, facet_cols_by, facet_wrap_by, animate_by	Which group variables, if any, should be used for faceting and/or animation? (defaults: 'NULL')
animation_follow	Should the animation follow the data (zoom in and out)? (default: 'FALSE')
xlim, ylim	Limits for the x- and y-axis.
category.ids	Vector of category IDs to be plotted or leave 'NULL' to plot all groups. (default: 'NULL')
category.labels	Vector of group labels of same length as 'category.ids' or 'NULL' to use defaults. (default: 'NULL')
category.colors	Vector of colors of same length as category.ids or 'NULL' to use defaults. (default: 'NULL')
category.linetypes	Vector of linetypes of same length as category.ids or 'NULL' to use defaults. (default: 'NULL') Currently being ignored.
...	additional arguments to geom_line.
levels	Levels of the confidence ellipses. (default: .5, .66, .8, .9., and .95)

Details

It is possible to hand more than one NIW belief to this function, and to facet or animate by variables that uniquely identify the different beliefs. For example, one can plot different priors for different talkers (grouping by talker), or different posteriors for different exposure conditions (grouping by exposure condition), the incremental updating of NIW beliefs (grouping by observations), or any combinations of these.

Value

ggplot object.

References

\insertRef

murphy2012MVBeliefUpdatr

See Also

TBD

hlplab/MVBeliefUpdatr documentation built on March 29, 2025, 10:42 p.m.