orm_relevance_guard: Relevance guard for occupational risk evidence mapping

View source: R/orm_relevance_guard.R

orm_relevance_guardR Documentation

Relevance guard for occupational risk evidence mapping

Description

Adds a relevance-control layer before ORISMA analysis. The function identifies whether each record is relevant to the target topic, whether it contains an occupational context, whether it is likely to be biomedical or clinical noise, and whether it should be excluded from the main occupational analysis.

Usage

orm_relevance_guard(
  data,
  topic = NULL,
  topic_regex = NULL,
  occupational_regex = NULL,
  noise_regex = NULL,
  title_col = NULL,
  abstract_col = NULL,
  keywords_col = NULL,
  mode = c("conservative", "flag", "strict")
)

Arguments

data

A data frame of bibliographic records.

topic

Optional topic label used to derive a topic-specific regular expression.

topic_regex

Optional regular expression defining the target technology/topic.

occupational_regex

Optional regular expression defining occupational relevance.

noise_regex

Optional regular expression defining likely off-topic biomedical/clinical noise.

title_col

Optional title column name. If NULL, it is detected automatically.

abstract_col

Optional abstract column name. If NULL, it is detected automatically.

keywords_col

Optional keywords column name. If NULL, it is detected automatically.

mode

Relevance filtering mode. "flag" excludes only records outside the target topic and marks uncertain records for review. "conservative" excludes off-topic and likely non-occupational biomedical/clinical records. "strict" also excludes records with weak occupational context.

Value

The input data frame with additional relevance-control columns.


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