better_parametric_plot: Plot better plots of parametric predictors in QGAMs

In dosc91/mtqgam: Mouse-Tracking Data in QGAMs

Plot better plots of parametric predictors in QGAMs

Description

better_parametric_plot creates a point plot with confidence interval ranges using ggplot2. It basically is a wrapper for itsadug's plot_parametric function.

Usage

better_parametric_plot(
  qgam,
  quantile = NULL,
  pred,
  cond = NULL,
  print.summary = FALSE,
  plot.old = FALSE,
  order = NULL,
  xlab = "fit",
  ylab = NULL,
  size = 0.5,
  color = NULL,
  alpha = 1)

Arguments

qgam	A qgam object created with qgam::qgam or extracted from a qgam::mqgam object, or a collection of qgams created with qgam::mqgam.
quantile	If qgam is a collection of qgam models, specify the quantile you are interested in. Not meaningful for single qgam objects.
pred	The predictor term to plot. Note: This is no longer identical to the pred argument specified for itsadug::plot_parametric.
cond	A named list of the values to use for the other predictor terms (not in view). Used for choosing between smooths that share the same view predictors.
print.summary	Logical: whether or not to print summary.
plot.old	Plot the original plot_parametric as well.
order	Specify the order with which the levels given in pred should be plotted.
xlab	The x-axis label.
ylab	The y-axis label.
size	Size argument for the ggplot object; specifies the size of points and lines.
color	Color argument for the ggplot object; specifies the color of points and lines.
alpha	Alpha argument for the ggplot object; specifies the transparency of points and lines.

Value

A ggplot object.

Author(s)

D. Schmitz

References

Fasiolo M., Goude Y., Nedellec R., & Wood S. N. (2017). Fast calibrated additive quantile regression. URL: https://arxiv.org/abs/1707.03307

van Rij J, Wieling M, Baayen R, & van Rijn H (2020). itsadug: Interpreting Time Series and Autocorrelated Data Using GAMMs. R package version 2.4.

Wickham, H. (2016). ggplot2: Elegant Graphics for Data Analysis. Springer-Verlag New York.

Examples

# using a single qgam extracted from an mqgam object OR fitted with qgam::qgam
better_parametric_plot(qgam = mtqgam_qgam,
  pred = "factor_3")

# using a qgam that is part of an mqgam object
library(qgam)

better_parametric_plot(qgam = mtqgam_mqgam,
  quantile = 0.5,
  pred = "factor_3")

# combining better_parametric_plot with ggplot2
better_parametric_plot(qgam = mtqgam_qgam,
  pred = "factor_3") +
  theme_void() +
  labs(subtitle = "This is a subtitle")

dosc91/mtqgam documentation built on Sept. 29, 2023, 9:38 a.m.