% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/psych_scores.R
\name{who5_score}
\alias{who5_score}
\title{WHO-5 scoring}
\usage{
who5_score(
  data,
  col_map = list(),
  na_action = c("keep", "omit", "error"),
  missing_prop_max = 0.2,
  impute = c("none", "mean"),
  prefix = "WHO5",
  low_cutoff_percent = 50,
  verbose = TRUE
)
}
\arguments{
\item{data}{Data frame containing questionnaire item columns.}

\item{col_map}{Named list mapping canonical item IDs to column names; defaults assume items are already named.}

\item{na_action}{How to handle rows with missing items: \code{keep}, \code{omit}, or \code{error}.}

\item{missing_prop_max}{Maximum allowed proportion of missing items per row before the score is set to \code{NA}.}

\item{impute}{Imputation strategy for missing items when under the threshold: \code{none} or \code{mean} (row-wise mean).}

\item{prefix}{Prefix for output column names.}

\item{low_cutoff_percent}{Percentage threshold for low well-being flag.}

\item{verbose}{Logical; if \code{TRUE}, emits informational messages about column resolution and scoring progress via \code{hm_inform()}.}
}
\value{
A tibble of score columns only: \code{WHO5_raw}, \code{WHO5_percent}, \code{WHO5_low_wellbeing}. Input columns are not included.
}
\description{
WHO-5 scoring
}
\examples{
df <- data.frame(who5_01 = 0, who5_02 = 1, who5_03 = 2, who5_04 = 3, who5_05 = 4)
who5_score(df)
}
\references{
\insertRef{topp2015who5}{HealthMarkers}
}
