% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/orm_ass.R
\name{orm_ass}
\alias{orm_ass}
\title{Abstract Sufficiency Score (ASS)}
\usage{
orm_ass(
  mx,
  text_col = "abstract",
  lang = getOption("orisma.lang", "en"),
  verbose = getOption("orisma.verbose", TRUE)
)
}
\arguments{
\item{mx}{An \code{orisma_matrix} object from \code{\link[=orm_extract]{orm_extract()}}.}

\item{text_col}{Character. Text field to score. Default \code{"abstract"},
falls back to \code{"title"} if abstract is mostly empty.}

\item{lang}{Character. \code{"en"} or \code{"es"}.}

\item{verbose}{Logical.}
}
\value{
The \code{orisma_matrix} object with added columns:
\code{ass_score} (0-5), \code{ass_label} (descriptive label),
\code{ass_level_reached} (highest level passed).
}
\description{
\code{orm_ass()} computes an \strong{Abstract Sufficiency Score} (0-5) for each
record, measuring how much preventively useful information the abstract
contains for an occupational health practitioner.

The score is \strong{cumulative and hierarchical} - a record cannot reach
level N without satisfying all previous levels:
\itemize{
\item \strong{0} Non-informative abstract for OHS purposes
\item \strong{1} Mentions a hazard or risk, but no occupational context
\item \strong{2} Mentions occupational/workplace context
\item \strong{3} Mentions exposure measurement or quantification
\item \strong{4} Mentions exposure in workers with some result
\item \strong{5} Mentions exposure, worker population, method AND control/prevention
}
}
