% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/zplot.R
\name{hist.zplot_brma}
\alias{hist.zplot_brma}
\title{Histogram of Z-Statistics}
\usage{
\method{hist}{zplot_brma}(
  x,
  plot_type = "base",
  from = -6,
  to = 6,
  by = 0.5,
  length.out = NULL,
  add = FALSE,
  plot_thresholds = TRUE,
  dots_thresholds = NULL,
  dots_hist = NULL,
  dots_all = NULL,
  ...
)
}
\arguments{
\item{x}{a zplot_brma object.}

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

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

\item{by}{bin width. Defaults to 0.5.}

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

\item{add}{whether to add to existing plot. Defaults to \code{FALSE}.}

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

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

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

\item{dots_all}{graphical parameters passed to all components (list).}

\item{...}{additional graphical parameters.}
}
\value{
\code{NULL} invisibly for base graphics, or a ggplot2 object.
}
\description{
Plots a histogram of observed z-values from the meta-analysis.
}
\details{
Z-statistics are computed as effect size divided by standard error
(\code{yi / sei}). Histogram bins are adjusted to align with significance
thresholds when selection model priors are present.
}
\seealso{
\code{\link[=plot.zplot_brma]{plot.zplot_brma()}}, \code{\link[=lines.zplot_brma]{lines.zplot_brma()}}
}
