Package: orisma
Type: Package
Title: Occupational Risk Integrated Systematic Mapping and Analysis
Version: 0.1.0
Authors@R: c(
    person(
        given = "Raúl",
        family = "Aguilar Elena",
        role = c("aut", "cre"),
        email = "raguilar@universidadviu.com",
        comment = c(ORCID = "0000-0001-8656-8155")
    ),
    person(
        given = "Ana",
        family = "Delgado-Garcia",
        role = "aut",
        email = "a.delgado@usal.es"
    )
    )
Description: A complete pipeline for systematic bibliometric mapping of
    occupational health and safety (OHS) evidence. Starting from reference
    files exported from major bibliographic databases such as Web of Science,
    Scopus, PubMed, Dimensions, EBSCO, and others, 'orisma' automates
    ingestion, deduplication, relevance filtering, occupational risk category
    extraction, bibliometric analysis, and report generation. The package is
    related to bibliometric science mapping and evidence synthesis workflows
    described by Aria and Cuccurullo (2017) <doi:10.1016/j.joi.2017.08.007>,
    Westgate (2019) <doi:10.1002/jrsm.1374>, and Lajeunesse (2016)
    <doi:10.1111/2041-210X.12472>, but adds a domain-specific occupational
    safety and health layer.
    The package implements three original bibliometric indicators:
    (1) the Worker-Risk Disconnection Index (WRDI), measuring the
    proportion of studies that characterise an occupational risk without
    including direct worker exposure data; (2) the Risk Category Saturation
    Index (RCS), measuring the relative over- or under-representation of
    each risk category relative to a uniform baseline; and (3) the
    Material-Gap Profile (MGP), measuring the ratio between a material's
    known hazard potential and its coverage in the occupational health
    literature.
    Two additional preventive intelligence indicators are provided:
    (4) the Abstract Sufficiency Score (ASS, 0-5), a cumulative hierarchical
    index of the preventively useful information contained in an abstract;
    and (5) the Bridge Article Score (0-5), identifying studies that
    simultaneously address technology, hazardous agent, worker population,
    exposure measurement, and preventive recommendations.
    Risk categories are extracted using a built-in occupational risk
    dictionary of 58 categories anchored in ISO 45001:2018, INSST, NIOSH,
    and EU-OSHA frameworks, organised in six blocks: Safety, Industrial
    Hygiene, Ergonomics, Psychosociology, Biological Hazards, and Emerging
    Technologies. The dictionary is user-extensible.
    Outputs include bilingual HTML reports, occupational risk sheets,
    priority reading rankings, guided extraction matrices for systematic
    review, and reproducibility certificates with MD5 hashes.
License: MIT + file LICENSE
Encoding: UTF-8
Language: en-GB
RoxygenNote: 7.3.3
URL: https://github.com/Aguilar-Elena/orisma
BugReports: https://github.com/Aguilar-Elena/orisma/issues
Depends: R (>= 4.1.0)
Imports: cli (>= 3.4.0), digest (>= 0.6.29), dplyr (>= 1.1.0), ggplot2
        (>= 3.4.0), ggrepel (>= 0.9.0), glue (>= 1.6.0), jsonlite (>=
        1.8.0), magrittr (>= 2.0.0), pheatmap (>= 1.0.12), readr (>=
        2.1.0), stringdist (>= 0.9.8), stringr (>= 1.5.0), synthesisr
        (>= 0.3.0), tidyr (>= 1.3.0), tools, utils
Suggests: knitr, rmarkdown, rsvg, testthat (>= 3.0.0)
VignetteBuilder: knitr
LazyData: true
NeedsCompilation: no
Packaged: 2026-05-12 20:14:07 UTC; okashi
Author: Raúl Aguilar Elena [aut, cre] (ORCID:
    <https://orcid.org/0000-0001-8656-8155>),
  Ana Delgado-Garcia [aut]
Maintainer: Raúl Aguilar Elena <raguilar@universidadviu.com>
Repository: CRAN
Date/Publication: 2026-05-18 18:10:09 UTC
