orm_analyse: Compute ORISMA bibliometric indicators and analyses

In orisma: Occupational Risk Integrated Systematic Mapping and Analysis

Compute ORISMA bibliometric indicators and analyses

Description

orm_analyse() takes an extraction matrix and computes:

• WRDI - Worker-Risk Disconnection Index: the proportion of studies that characterise a risk without measuring direct worker exposure. A WRDI of 1 means all studies are purely technical (no worker data); 0 means all studies include direct worker exposure measurement.

• RCS - Risk Category Saturation Index: relative dominance of each risk category compared to a uniform-distribution baseline. RCS > 1 means the category is over-represented; RCS < 1 means it is under-represented.

• MGP - Material-Gap Profile: ratio of a material's known hazard potential (from the literature consensus) to its proportional coverage in the corpus. Detects hazardous materials that are academically under-studied.

It also computes co-occurrence matrices, temporal trends, and author networks for visualisation.

Usage

orm_analyse(
  mx,
  material_col = NULL,
  year_col = "year",
  lang = getOption("orisma.lang", "en"),
  verbose = getOption("orisma.verbose", TRUE)
)

Arguments

mx	An orisma_matrix object returned by orm_extract().
material_col	Character. Name of the column containing material information. If NULL (default), MGP is skipped with a warning.
year_col	Character. Column name for publication year. Default "year".
lang	Character. "en" or "es".
verbose	Logical. Print progress?

Value

A list (class orisma_result) with all indicators and analysis objects ready for orm_report() and visualisation functions.

Examples

## Not run: 
refs    <- orm_load("my_references/")
deduped <- orm_dedup(refs)
mx      <- orm_extract(deduped)
result  <- orm_analyse(mx)

# View the three core indicators
result$indicators

# View WRDI
result$WRDI

## End(Not run)

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