This article covers the export end of the workflow, which turns a
retrieval into a reading list in a reference manager or into input for a
science-mapping tool. Every step runs without an API key, on
example_records, the bundled harvest of 138 real journal
articles. It stands in for a harvest of your own because Scopus records
may not be redistributed. The article
vignette("scopusflow") describes where it comes from.
Before exporting anything, it helps to see what the set contains.
summary() reports the size, the span of years, the number
of distinct sources, the citation spread and the most-cited record.
<scopus_records> summary
138 records, from 2015 to 2024.
90 sources, 127 with a DOI.
Cited 7015 times in total, median 24 per record.
Most frequent source: ACS Applied Materials & Interfaces.
Most cited: Graphene for batteries, supercapacitors and beyond.
Eleven of those 138 records arrived without a DOI, so the summary counts 127 with one. That is ordinary in a live harvest, and the sections below show how each export handles it.
A record set is a tibble with an added class, so it works in
tidyverse or base R workflows as it is. as_tibble() and
as.data.frame() make the conversion explicit when a
downstream tool expects a plain frame.
| entry_number | scopus_id | doi | title | authors | year | date | publication | citations | query |
|---|---|---|---|---|---|---|---|---|---|
| 1 | NA | 10.15541/jim20140527 | Enhanced Capacitive Properties of All-solid-state Symmetric Graphene Supercapacitors by Incorporating Nitrogen-doping and SnO2 Nanoparticles | Jianhua Yu | 2015 | 2015-01-01 | Journal of Inorganic Materials | 1 | graphene supercapacitor |
| 2 | NA | NA | Fabrication and Characterization of a Vertically-Oriented Graphene Supercapacitor | Patrick R Rice | 2015 | 2015-01-01 | DigitalCommons - CalPoly (California State Polytechnic University) | 0 | graphene supercapacitor |
| 3 | NA | 10.1021/am509065d | Flexible and Stackable Laser-Induced Graphene Supercapacitors | Zhiwei Peng | 2015 | 2015-01-13 | ACS Applied Materials & Interfaces | 469 | graphene supercapacitor |
| 4 | NA | 10.1016/j.electacta.2015.02.019 | Heavily nitrogen doped, graphene supercapacitor from silk cocoon | Vikrant Sahu | 2015 | 2015-02-04 | Electrochimica Acta | 195 | graphene supercapacitor |
| 5 | NA | 10.1002/smll.201403383 | Graphene-Based Integrated Photovoltaic Energy Harvesting/Storage Device | Chih-Tao Chien | 2015 | 2015-02-19 | Small | 108 | graphene supercapacitor |
| 6 | NA | 10.1016/j.jpowsour.2015.03.015 | Nanoporous graphene materials by low-temperature vacuum-assisted thermal process for electrochemical energy storage | Hao Yang | 2015 | 2015-03-05 | Journal of Power Sources | 47 | graphene supercapacitor |
| title | year |
|---|---|
| Enhanced Capacitive Properties of All-solid-state Symmetric Graphene Supercapacitors by Incorporating Nitrogen-doping and SnO2 Nanoparticles | 2015 |
| Fabrication and Characterization of a Vertically-Oriented Graphene Supercapacitor | 2015 |
| Flexible and Stackable Laser-Induced Graphene Supercapacitors | 2015 |
A harvest can keep more than the columns above. With
fields = "extended", scopus_fetch() and
scopus_fetch_plan() also keep the document type, source
type, volume, issue, pages, ISSN, PubMed identifier and open-access
status the Search API sends with every record. Under the
COMPLETE view, they keep the abstract too. These fields are
part of the responses the harvest already receives, so they cost no
extra quota. The bundled harvest came from OpenAlex and carries none of
them, so this step is shown but not run.
plan <- scopus_plan('"graphene supercapacitor"', years = 2015:2024,
field = "TITLE-ABS-KEY", partition = "year")
records <- scopus_fetch_plan(plan, fields = "extended")
summary(records)
articles <- records[records$doc_type %in% c("ar", "re"), ]doc_type holds the code ‘Scopus’ gives a record’s
document type, such as ar for an article, re a
review or cp a conference paper. For a set retrieved this
way, summary() also counts the document types and reports
how many records ‘Scopus’ labels errata (er) or retracted
(tb). In ‘Scopus’, an erratum covers retraction notices as
well as corrections. Such labels do not screen a set for retractions,
since ‘Scopus’ does not label every retracted item (Ortega &
Delgado-Quirós, 2024). A review should still check its included
records against the Retraction
Watch database.
Errata can also be left out of the search itself.
scopus_query() brackets the rest of the query before it
adds AND NOT DOCTYPE(er), so the exclusion applies to the
whole of it under either operator order that
vignette("designing-queries") describes.
scopus_query(
scopus_query("graphene", "graphite", .op = "OR", .field = "TITLE-ABS-KEY"),
"DOCTYPE(er)", .op = "AND NOT"
)[1] "(TITLE-ABS-KEY(graphene) OR TITLE-ABS-KEY(graphite)) AND NOT DOCTYPE(er)"
Reference managers such as Zotero import most reliably from DOIs.
scopus_extract_dois() pulls them out, normalises them and
removes duplicates, so the same article imports once even when its DOI
was stored with a resolver prefix or in a different case.
[1] 127
[1] "10.15541/jim20140527" "10.1021/am509065d"
[3] "10.1016/j.electacta.2015.02.019" "10.1002/smll.201403383"
[5] "10.1016/j.jpowsour.2015.03.015" "10.1103/physrevb.91.125415"
The same cleaning applies to a plain vector of DOIs from any source.
The first two entries below collapse to one, because the comparison
ignores case and resolver prefixes. dedupe = FALSE keeps
every occurrence, for instance to count how often a DOI recurs across
retrievals.
[1] "10.1/A" "10.2/B"
[1] "10.1/A" "10.1/a" "10.2/B"
The list is written to a single-column CSV only when a path is given. The file holds a header and one DOI per line, as its first lines show.
out <- file.path(tempdir(), "reference-set.csv")
scopus_extract_dois(example_records, file = out)
writeLines(head(readLines(out), 6))"doi"
"10.15541/jim20140527"
"10.1021/am509065d"
"10.1016/j.electacta.2015.02.019"
"10.1002/smll.201403383"
"10.1016/j.jpowsour.2015.03.015"
A DOI list is enough for an import-by-identifier, but a record
carries more than its DOI. as_ris() and
as_bibtex() render the set in the two interchange formats
that reference managers read, for use in Zotero, EndNote or a LaTeX
bibliography. Each record becomes one entry, with its authors split
out.
TY - JOUR
TI - Enhanced Capacitive Properties of All-solid-state Symmetric Graphene Supercapacitors by Incorporating Nitrogen-doping and SnO2 Nanoparticles
AU - Jianhua Yu
PY - 2015
T2 - Journal of Inorganic Materials
DO - 10.15541/jim20140527
DB - Scopus
ER -
TY - JOUR
TI - Fabrication and Characterization of a Vertically-Oriented Graphene Supercapacitor
AU - Patrick R Rice
PY - 2015
T2 - DigitalCommons - CalPoly (California State Polytechnic University)
DB - Scopus
ER -
The first two entries of 138 are shown. The second has no DOI, so its
entry has no DO line and still imports on its title, author
and year. A ‘Scopus’ name such as Zhang F. is exported as
Zhang, F., so that a reference manager or BibTeX reads
Zhang as the family name. Nearly all the bundled records put the given
name first, and those names are written as they stand. The source title
goes under T2, the tag ‘Scopus’ itself uses for it.
Every bundled record is a journal article, exported as
JOUR and @article. A harvest retrieved with
fields = "extended" carries the document type ‘Scopus’
gives each record. A conference paper is then exported as
CPAPER and @inproceedings, a chapter as
CHAP and @incollection and a book as
BOOK and @book. The entries of such a harvest
also carry the volume, issue, pages and ISSN, and under
view = "COMPLETE" the abstract. A COMPLETE
harvest exports its author keywords as well, with or without the
extended fields. Screening and de-duplication tools read the abstract
and the keywords. ?as_bibtex lists where each field
goes.
as_ris() and as_bibtex() write the whole
set only when a file is given.
as_bibliometrix() re-maps the records to the tagged
column layout that the bibliometrix package and the
wider ISI convention expect.
| AU | TI | PY | SO | TC | DB |
|---|---|---|---|---|---|
| JIANHUA YU | ENHANCED CAPACITIVE PROPERTIES OF ALL-SOLID-STATE SYMMETRIC GRAPHENE SUPERCAPACITORS BY INCORPORATING NITROGEN-DOPING AND SNO2 NANOPARTICLES | 2015 | JOURNAL OF INORGANIC MATERIALS | 1 | SCOPUS |
| PATRICK R RICE | FABRICATION AND CHARACTERIZATION OF A VERTICALLY-ORIENTED GRAPHENE SUPERCAPACITOR | 2015 | DIGITALCOMMONS - CALPOLY (CALIFORNIA STATE POLYTECHNIC UNIVERSITY) | 0 | SCOPUS |
| ZHIWEI PENG | FLEXIBLE AND STACKABLE LASER-INDUCED GRAPHENE SUPERCAPACITORS | 2015 | ACS APPLIED MATERIALS & INTERFACES | 469 | SCOPUS |
| VIKRANT SAHU | HEAVILY NITROGEN DOPED, GRAPHENE SUPERCAPACITOR FROM SILK COCOON | 2015 | ELECTROCHIMICA ACTA | 195 | SCOPUS |
| CHIH-TAO CHIEN | GRAPHENE-BASED INTEGRATED PHOTOVOLTAIC ENERGY HARVESTING/STORAGE DEVICE | 2015 | SMALL | 108 | SCOPUS |
| HAO YANG | NANOPOROUS GRAPHENE MATERIALS BY LOW-TEMPERATURE VACUUM-ASSISTED THERMAL PROCESS FOR ELECTROCHEMICAL ENERGY STORAGE | 2015 | JOURNAL OF POWER SOURCES | 47 | SCOPUS |
The fields follow the conventions
bibliometrix::convert2df() applies to a ‘Scopus’ export.
Each author is written as the surname and initials without full stops,
so Zhang F. becomes ZHANG F, and the authors
of a record are joined by ;. UT holds the EID,
which the bundled records lack. A harvest retrieved under
view = "COMPLETE" also fills DE with the
author keywords, and one retrieved with fields = "extended"
fills DT, VL and IS with the
document type, volume and issue.
From there, the usual bibliometrix entry points apply. This step needs that package, so it is shown but not run.
if (requireNamespace("bibliometrix", quietly = TRUE)) {
results <- bibliometrix::biblioAnalysis(m)
summary(results, k = 10)
}As noted on the as_bibliometrix() help page, this
reconstructs the core descriptive fields only. Analyses that need full
affiliations or cited references still call for a complete ‘Scopus’ CSV
or BibTeX export read with bibliometrix::convert2df().
To pick the work up in a later session, save the records and read
them back. The .rds form preserves the types and class
exactly, while .csv is portable plain text.
path <- file.path(tempdir(), "records.rds")
write_scopus_records(example_records, path)
identical(read_scopus_records(path), example_records)[1] TRUE