orm_ass: Abstract Sufficiency Score (ASS)

View source: R/orm_ass.R

orm_assR Documentation

Abstract Sufficiency Score (ASS)

Description

orm_ass() computes an 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 cumulative and hierarchical - a record cannot reach level N without satisfying all previous levels:

  • 0 Non-informative abstract for OHS purposes

  • 1 Mentions a hazard or risk, but no occupational context

  • 2 Mentions occupational/workplace context

  • 3 Mentions exposure measurement or quantification

  • 4 Mentions exposure in workers with some result

  • 5 Mentions exposure, worker population, method AND control/prevention

Usage

orm_ass(
  mx,
  text_col = "abstract",
  lang = getOption("orisma.lang", "en"),
  verbose = getOption("orisma.verbose", TRUE)
)

Arguments

mx

An orisma_matrix object from orm_extract().

text_col

Character. Text field to score. Default "abstract", falls back to "title" if abstract is mostly empty.

lang

Character. "en" or "es".

verbose

Logical.

Value

The orisma_matrix object with added columns: ass_score (0-5), ass_label (descriptive label), ass_level_reached (highest level passed).


orisma documentation built on May 19, 2026, 1:07 a.m.