% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/plot_reg_combine.R
\name{plot_reg_combine}
\alias{plot_reg_combine}
\title{Side-by-side forest plots: univariate vs multivariable}
\usage{
plot_reg_combine(
  tbl_uni,
  tbl_multi,
  title_uni = NULL,
  title_multi = NULL,
  caption = NULL,
  ref_line = NULL,
  order_y = NULL,
  log_x = FALSE,
  point_color = "#6B7280",
  errorbar_color = "#6B7280",
  point_size = 2.8,
  point_stroke = 0.55,
  ci_linewidth = 0.55,
  base_size = 12,
  show_ref = NULL,
  sig_color = "#0072B2",
  sig_errorbar_color = "#0072B2",
  xlim_uni = NULL,
  breaks_uni = NULL,
  xlim_multi = NULL,
  breaks_multi = NULL,
  alpha = 0.05,
  show_adjustment_note = TRUE
)
}
\arguments{
\item{tbl_uni}{A univariate \code{gtregression} object.}

\item{tbl_multi}{A multivariable \code{gtregression} object.}

\item{title_uni, title_multi}{Optional panel titles.}

\item{caption}{Optional combined plot caption. If \code{NULL}, notes are
added automatically for adjusted \code{multi_reg()} objects and displayed
reference categories.}

\item{ref_line}{Optional numeric reference line. If \code{NULL}, uses 0 for
linear models and 1 otherwise.}

\item{order_y}{Optional character vector to customize exposure ordering.}

\item{log_x}{Logical. If \code{TRUE}, use a log-scaled x-axis for ratio
measures. The default \code{FALSE} uses a linear x-axis.}

\item{point_color, errorbar_color}{Base colors for non-significant rows.}

\item{point_size}{Diameter of estimate points in millimetres.}

\item{point_stroke}{Outline width of estimate points.}

\item{ci_linewidth}{Line width of confidence intervals.}

\item{base_size}{Base font size for the plot theme.}

\item{show_ref}{Logical or \code{NULL}. The default \code{NULL} inherits the
setting used to create the supplied tables. If \code{TRUE}, include
reference levels as \code{(Ref.)}. If \code{FALSE}, binary exposures are
shown as compact rows for the estimated non-reference category;
affirmative levels such as \code{Yes} or \code{1} are displayed using the
variable name.}

\item{sig_color, sig_errorbar_color}{Optional colors for significant rows.
If \code{NULL}, base colors are reused.}

\item{xlim_uni, breaks_uni}{Optional x-axis limits and breaks for the
univariate panel.}

\item{xlim_multi, breaks_multi}{Optional x-axis limits and breaks for the
multivariable panel.}

\item{alpha}{Significance level for linear models when \code{p.value} is
available.}

\item{show_adjustment_note}{Logical; if \code{TRUE}, add a default caption
describing \code{adjust_for} variables from \code{tbl_multi} when available.}
}
\value{
A \code{patchwork} object with two \code{ggplot2} panels.
}
\description{
Creates two aligned forest plots from compatible \code{gtregression}
regression objects such as crude and adjusted outputs from \code{uni_reg()},
\code{multi_reg()}, \code{cox_reg()}, or \code{surv_reg()}.
}
