convert2df: Import and Convert bibliographic export files and API...
In massimoaria/bibliometrix: Comprehensive Science Mapping Analysis

convert2df

R Documentation

Import and Convert bibliographic export files and API objects.

Description

It converts a SCOPUS, Clarivate Analytics WoS, Dimensions, Lens.org, PubMed and COCHRANE Database export files or pubmedR and dimensionsR JSON/XML objects into a data frame, with cases corresponding to articles and variables to Field Tags as used in WoS.

Usage

convert2df(
  file,
  dbsource = "wos",
  format = "plaintext",
  remove.duplicates = TRUE
)

Arguments

file

a character array containing a sequence of filenames coming from WoS, Scopus, Dimensions, Lens.org, and Pubmed. Alternatively, file can be an object resulting from an API query fetched from Dimensions, PubMed or OpenAlex databases:

a)	'wos'	Clarivate Analytics WoS (in plaintext '.txt', Endnote Desktop '.ciw', or bibtex formats '.bib');
b)	'scopus'	SCOPUS (exclusively in bibtex format '.bib');
c)	'dimensions'	Digital Science Dimensions (in csv '.csv' or excel '.xlsx' formats);
d)	'lens'	Lens.org (in csv '.csv');
e)	'pubmed'	an object of the class `pubmedR (package pubmedR)` containing a collection obtained from a query performed with pubmedR package;
f)	'dimensions'	an object of the class `dimensionsR (package dimensionsR)` containing a collection obtained from a query performed with dimensionsR package;
g)	'openalex'	OpenAlex .csv file;
h)	'openalex_api'	a data frame object returned by openalexR package, containing a collection of works resulting from a query fetched from OpenAlex database.

dbsource

is a character indicating the bibliographic database. dbsource can be dbsource = c('cochrane','dimensions','generic','isi','openalex', 'pubmed','scopus','wos', 'lens') . Default is dbsource = "isi".

format

is a character indicating the SCOPUS, Clarivate Analytics WoS, and other databases export file format. format can be c('api', 'bibtex', 'csv', 'endnote','excel','plaintext', 'pubmed'). Default is format = "plaintext".

remove.duplicates

is logical. If TRUE, the function will remove duplicated items checking by DOI and database ID.

Value

a data frame with cases corresponding to articles and variables to Field Tags in the original export file.

I.e We have three files download from Web of Science in plaintext format, file will be:

file <- c("filename1.txt", "filename2.txt", "filename3.txt")

data frame columns are named using the standard Clarivate Analytics WoS Field Tag codify. The main field tags are:

`AU`		Authors
`TI`		Document Title
`SO`		Publication Name (or Source)
`JI`		ISO Source Abbreviation
`DT`		Document Type
`DE`		Authors' Keywords
`ID`		Keywords associated by SCOPUS or WoS database
`AB`		Abstract
`C1`		Author Address
`RP`		Reprint Address
`CR`		Cited References
`TC`		Times Cited
`PY`		Year
`SC`		Subject Category
`UT`		Unique Article Identifier
`DB`		Database

for a complete list of field tags see: Field Tags used in bibliometrix

Examples


# Example:
# Import and convert a Web of Science collection form an export file in plaintext format:

## Not run: 
files <- 'https://www.bibliometrix.org/datasets/wos_plaintext.txt'

M <- convert2df(file = files, dbsource = 'wos', format = "plaintext")

## End(Not run)

massimoaria/bibliometrix documentation built on Dec. 12, 2024, 12:47 p.m.