Read Dimensions CSV files

Parse Dimensions CSV export files into an sm_corpus object. Handles the standard Dimensions analytics platform CSV export format.

Usage

sm_read_dimensions(
  path,
  encoding = "UTF-8",
  engine = c("native", "bibliometrix", "auto"),
  verbose = TRUE,
  call = rlang::caller_env()
)

Arguments

path

Character scalar. Path to a Dimensions CSV file.

encoding

Character scalar. File encoding (default "UTF-8").

engine

Character scalar. One of "native" (built-in parser), "bibliometrix" (delegate to bibliometrix::convert2df()), or "auto" (try bibliometrix first, fall back to native).

verbose

Logical. Print progress messages?

call

Caller environment for error reporting.

Value

An sm_corpus object.

Implementation

The native parser reads the Dimensions CSV export using readr::read_csv(). Dimensions CSV files may begin with informational rows before the header; the parser skips lines that do not look like the header. Key columns matched (case-insensitive): Title, DOI, Authors, Source title (or Source Title), PubYear (or Publication Year), Times cited, Document Type (or Publication Type), Abstract, Dimensions ID, MeSH terms, Author Keywords, ISSN.

References

Aria, M. & Cuccurullo, C. (2017). bibliometrix: An R-tool for comprehensive science mapping analysis. Journal of Informetrics, 11(4), 959–975. doi:10.1016/j.joi.2017.08.007

See also

Other readers: sm_read_auto(), sm_read_bib(), sm_read_cochrane(), sm_read_endnote(), sm_read_lens(), sm_read_openalex_json(), sm_read_pubmed_xml(), sm_read_ris(), sm_read_scopus(), sm_read_wos(), sm_read_zotero()

Examples

if (FALSE) { # \dontrun{
corpus <- sm_read_dimensions("dimensions_export.csv")
corpus$works
} # }