% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/orm_relevance_guard.R
\name{orm_relevance_guard}
\alias{orm_relevance_guard}
\title{Relevance guard for occupational risk evidence mapping}
\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{
\item{data}{A data frame of bibliographic records.}

\item{topic}{Optional topic label used to derive a topic-specific regular expression.}

\item{topic_regex}{Optional regular expression defining the target technology/topic.}

\item{occupational_regex}{Optional regular expression defining occupational relevance.}

\item{noise_regex}{Optional regular expression defining likely off-topic biomedical/clinical noise.}

\item{title_col}{Optional title column name. If \code{NULL}, it is detected automatically.}

\item{abstract_col}{Optional abstract column name. If \code{NULL}, it is detected automatically.}

\item{keywords_col}{Optional keywords column name. If \code{NULL}, it is detected automatically.}

\item{mode}{Relevance filtering mode. \code{"flag"} excludes only records outside
the target topic and marks uncertain records for review. \code{"conservative"}
excludes off-topic and likely non-occupational biomedical/clinical records.
\code{"strict"} also excludes records with weak occupational context.}
}
\value{
The input data frame with additional relevance-control columns.
}
\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.
}
