orm_risk_sheet: Generate an occupational risk sheet

View source: R/orm_risk_sheet.R

orm_risk_sheetR Documentation

Generate an occupational risk sheet

Description

orm_risk_sheet() generates a structured, actionable risk sheet for occupational health practitioners. It synthesises ORISMA outputs into a single HTML document that can be used as supporting evidence in a workplace risk assessment.

The sheet is regulation-neutral: it does not include country-specific regulations or limit values, as these vary by jurisdiction. The practitioner applies the relevant national/regional regulation based on the risk categories identified.

Content:

  • Context analysis (dominant topic of the corpus)

  • Priority traffic light (RED/AMBER/GREEN/GREY) per risk category

  • Evidence summary with confidence level

  • Knowledge gap alerts

  • WRDI interpretation with confidence score

  • Methodological section (bases, deduplication, WRDI definition, limits)

Usage

orm_risk_sheet(
  result,
  topic = "Occupational risk analysis",
  search_strategy = NULL,
  inclusion_criteria = NULL,
  out_dir = "orisma_output",
  lang = getOption("orisma.lang", "en"),
  min_records = 1L,
  context_rcs_threshold = 15,
  verbose = getOption("orisma.verbose", TRUE)
)

Arguments

result

An orisma_result object.

topic

Character. Technology or domain being assessed.

search_strategy

Character or NULL. Description of the search strategy used (databases, keywords, date range). If NULL, a placeholder is used.

inclusion_criteria

Character or NULL. Description of inclusion/ exclusion criteria applied. If NULL, ORISMA defaults are described.

out_dir

Character. Output directory.

lang

Character. "en" or "es".

min_records

Integer. Min records for a category to appear. Default 1.

context_rcs_threshold

Numeric. RCS threshold for context detection. Default 15.

verbose

Logical.

Value

Invisibly returns the path to the generated HTML risk sheet.


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