R/stat_normal_qq.R

In gglm: Grammar of Graphics for Linear Model Diagnostic Plots

#' @title stat_normal_qq
#'
#' @description Normal QQ plot.
#'
#' @param alpha Adjust transparency of points.
#' @param ... Currently ignored. For extendability.
#'
#' @return A `ggplot2` layer for plotting a Normal Q-Q plot.
#' @examples
#' data(mtcars)
#' model <- lm(mpg ~ cyl + disp + hp, data = mtcars)
#' ggplot2::ggplot(data = model) + stat_normal_qq()
#' @export
#' @importFrom rlang .data

stat_normal_qq <- function(alpha = 0.5,
                           ...) {
  list(
    ggplot2::geom_qq_line(mapping = ggplot2::aes(sample = .data$.resid / stats::sd(.data$.resid)),
                          linetype = "dashed"),
    ggplot2::stat_qq(mapping = ggplot2::aes(sample = .data$.resid / stats::sd(.data$.resid)),
                     alpha = alpha),
    ggplot2::labs(title = "Normal Q-Q",
                  x = "Theoretical Quantiles",
                  y = "Standardized Residuals")
  )
}