% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/zplot.R
\name{plot.zplot_brma}
\alias{plot.zplot_brma}
\title{Plot Zplot Results}
\usage{
\method{plot}{zplot_brma}(
  x,
  plot_type = "base",
  probs = c(0.025, 0.975),
  max_samples = 10000,
  plot_fit = TRUE,
  plot_extrapolation = TRUE,
  plot_ci = TRUE,
  plot_thresholds = TRUE,
  from = -6,
  to = 6,
  by.hist = 0.5,
  length.out.hist = NULL,
  by.lines = 0.05,
  length.out.lines = NULL,
  dots_hist = NULL,
  dots_fit = NULL,
  dots_extrapolation = NULL,
  dots_thresholds = NULL,
  ...
)
}
\arguments{
\item{x}{a zplot_brma object.}

\item{plot_type}{graphics system: \code{"base"} or \code{"ggplot"}.
Defaults to \code{"base"}.}

\item{probs}{quantiles for credible intervals. Defaults to \code{c(.025, .975)}.}

\item{max_samples}{maximum posterior samples for density estimation.
Defaults to 10000. Use \code{Inf} to use all posterior samples.}

\item{plot_fit}{whether to show fitted density (with bias adjustments).
Defaults to \code{TRUE}.}

\item{plot_extrapolation}{whether to show extrapolated density (bias removed).
Defaults to \code{TRUE}.}

\item{plot_ci}{whether to show credible interval bands. Defaults to \code{TRUE}.}

\item{plot_thresholds}{whether to show significance threshold lines.
Defaults to \code{TRUE}.}

\item{from, to}{z-value range for plotting. Defaults to \code{-6} and \code{6}.}

\item{by.hist}{bin width for histogram. Defaults to 0.5.}

\item{length.out.hist}{number of histogram bins (alternative to \code{by.hist}).}

\item{by.lines}{step size for density lines. Defaults to 0.05.}

\item{length.out.lines}{number of density points (alternative to \code{by.lines}).}

\item{dots_hist}{graphical parameters for histogram (list).}

\item{dots_fit}{graphical parameters for fit lines (list).}

\item{dots_extrapolation}{graphical parameters for extrapolation lines (list).}

\item{dots_thresholds}{graphical parameters for threshold lines (list).}

\item{...}{additional graphical parameters passed to components.}
}
\value{
\code{NULL} invisibly for base graphics, or a ggplot2 object.
}
\description{
Plots a zplot visualization showing the histogram of
observed z-statistics overlaid with model-implied densities.
}
\details{
The plot displays two density curves:
\describe{
\item{Fit (black)}{Model-implied density including publication bias adjustments.
This represents the expected distribution of z-statistics given the estimated
selection process.}
\item{Extrapolation (blue)}{Bias-corrected curve representing the hypothetical
distribution without selective reporting, scaled by the expected suppressed
studies under selection models. This curve is not normalized to integrate
to one when selection implies missing studies.}
}
}
\seealso{
\code{\link[=hist.zplot_brma]{hist.zplot_brma()}}, \code{\link[=lines.zplot_brma]{lines.zplot_brma()}}, \code{\link[=summary.zplot_brma]{summary.zplot_brma()}}
}
