orm_run_guarded: Run ORISMA with a relevance-control layer

In orisma: Occupational Risk Integrated Systematic Mapping and Analysis

Run ORISMA with a relevance-control layer

Description

Runs ORISMA after applying orm_relevance_guard(). This is useful for real-world bibliographic searches where broad database queries may retrieve technically related but non-occupational or off-topic records.

Usage

orm_run_guarded(
  refs,
  topic = NULL,
  exclude_non_relevant = TRUE,
  min_records = 50,
  topic_regex = NULL,
  occupational_regex = NULL,
  noise_regex = NULL,
  mode = c("conservative", "flag", "strict"),
  ...
)

Arguments

refs	A data frame of references, usually produced by orm_load().
topic	Topic label passed to orm_relevance_guard() and orm_run().
exclude_non_relevant	Logical. If TRUE, records flagged as non-relevant are excluded before running the main ORISMA pipeline.
min_records	Minimum number of records required after filtering. If the filter leaves fewer records, the function stops to avoid accidental over-filtering.
topic_regex	Optional topic regex.
occupational_regex	Optional occupational relevance regex.
noise_regex	Optional noise regex.
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.
...	Additional arguments passed to orm_run().

Value

An ORISMA result object with an added relevance_guard component.

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