% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/assoc.R
\name{gamma_gk}
\alias{gamma_gk}
\title{Goodman-Kruskal Gamma}
\usage{
gamma_gk(
  x,
  detail = FALSE,
  conf_level = 0.95,
  digits = 3L,
  .include_se = FALSE
)
}
\arguments{
\item{x}{A contingency table (of class \code{table}).}

\item{detail}{Logical. If \code{FALSE} (default), return the estimate
as a numeric scalar. If \code{TRUE}, return a named numeric vector
including confidence interval and p-value.}

\item{conf_level}{A number between 0 and 1 giving the confidence
level (default \code{0.95}). Only used when \code{detail = TRUE}. Set
to \code{NULL} to omit the confidence interval.}

\item{digits}{Number of decimal places used when printing the
result (default \code{3}). Only affects the \code{detail = TRUE} output.}

\item{.include_se}{Internal parameter; do not use.}
}
\value{
Same structure as \code{\link[=cramer_v]{cramer_v()}}: a scalar when
\code{detail = FALSE}, a named vector when \code{detail = TRUE}.
The p-value tests H0: gamma = 0 (Wald z-test).
}
\description{
\code{gamma_gk()} computes the Goodman-Kruskal Gamma statistic for a
two-way contingency table of ordinal variables.
}
\details{
Gamma is computed as \eqn{\gamma = (C - D) / (C + D)}, where
\eqn{C} and \eqn{D} are the numbers of concordant and
discordant pairs. It ignores tied pairs, making it appropriate
for ordinal variables with many ties.
Standard error formulas follow the DescTools implementations
(Signorell et al., 2024); see \code{\link[=cramer_v]{cramer_v()}} for full references.
}
\examples{
tab <- table(sochealth$education, sochealth$self_rated_health)
gamma_gk(tab)
gamma_gk(tab, detail = TRUE)

}
\seealso{
\code{\link[=kendall_tau_b]{kendall_tau_b()}}, \code{\link[=kendall_tau_c]{kendall_tau_c()}}, \code{\link[=somers_d]{somers_d()}},
\code{\link[=assoc_measures]{assoc_measures()}}
}
