orm_load: Load bibliographic references from one or multiple files /...

In orisma: Occupational Risk Integrated Systematic Mapping and Analysis

Load bibliographic references from one or multiple files / folders

Description

orm_load() is the entry point of every ORISMA analysis. It reads bibliographic files in RIS, BibTeX, or CSV format from a folder (or a vector of individual file paths), detects the format of each file automatically, combines all records into a single tidy data frame, and records the source database for each record.

All major bibliographic databases export to at least one supported format:

Database	Recommended format	Notes
Web of Science	RIS / Plain text	Max 1 000 records per batch
Scopus	RIS or CSV	Max 2 000 records per batch
PubMed	RIS	No limit
Dimensions	CSV or RIS	Max 2 500 per batch
EBSCO (CINAHL, BSC)	RIS	Up to 25 000
ProQuest	RIS or BibTeX	Max 100 per batch
Cochrane Library	RIS	No limit
Ovid / MEDLINE	RIS	Max 1 000 per batch
ScienceDirect	RIS	No limit
The Lens (free)	RIS or CSV	No limit

Usage

orm_load(
  path,
  lang = getOption("orisma.lang", "en"),
  verbose = getOption("orisma.verbose", TRUE)
)

Arguments

path	Character. Path to a folder containing reference files, or a character vector of individual file paths.
lang	Character. Language for console messages: "en" (default) or "es". Overrides getOption("orisma.lang").
verbose	Logical. Print progress messages? Default TRUE.

Value

A tibble (class orisma_refs) with standardised columns:

record_id

Internal unique identifier assigned by ORISMA

source_file

Name of the original file

source_db

Database inferred from file name or format

title

Article title

authors

Authors (semicolon-separated)

year

Publication year

doi

Digital Object Identifier (if available)

abstract

Abstract text

keywords

Author keywords

journal

Journal name

volume, issue, pages

Bibliographic location

document_type

Article, review, conference paper, etc.

Examples

## Not run: 
# Load all .ris and .bib files from a folder
refs <- orm_load("my_references/")

# Load specific files
refs <- orm_load(c("wos_results.ris", "scopus_results.csv"))

# Spanish messages
refs <- orm_load("mis_referencias/", lang = "es")

## End(Not run)

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