Parse Lens.org scholarly CSV export files into an sm_corpus object.
Handles the standard Lens scholarly export format with columns for
Lens ID, Title, Authors, DOI, Source Title, Abstract, and more.
Usage
sm_read_lens(
path,
encoding = "UTF-8",
engine = c("native", "bibliometrix", "auto"),
verbose = TRUE,
call = rlang::caller_env()
)Arguments
- path
Character scalar. Path to a Lens CSV file.
- encoding
Character scalar. File encoding (default
"UTF-8").- engine
Character scalar. One of
"native"(built-in parser),"bibliometrix"(delegate tobibliometrix::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 Lens.org scholarly CSV export using
readr::read_csv(). Key columns matched (case-insensitive):
Lens ID, Title, Date Published, Year Published (or Publication Year),
DOI, Source Title, Authors, Abstract, Citing Works Count
(or Scholarly Citations Count), Document Type (or Publication Type),
Open Access Colour (or Color), Open Access Status, Is Open Access,
or exactly Open Access (in that priority order; never a licence), MeSH Terms,
Keywords, Source ISSN, Language.
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
Examples
corpus <- sm_read_lens(sm_example_files("example_lens.csv"), verbose = FALSE)
corpus
#>
#> ── <sm_corpus> ─────────────────────────────────────────────────────────────────
#> Works: 3 | Authors: 9 | Institutions: 0
#> Years: 2022 - 2024
#> Sources (journals): 3
#> Embeddings: none
#> Provenance: lens (3)
#> Status: Unlocked (last refreshed: never)
head(corpus$works)
#> # A tibble: 3 × 16
#> work_id doi title abstract year type source_id cited_by_count oa_status
#> <chr> <chr> <chr> <chr> <int> <chr> <chr> <int> <chr>
#> 1 W000000001 10.1… Spat… Spatial… 2023 Jour… S0000000… 42 NA
#> 2 W000000002 10.1… Mach… We deve… 2022 Jour… S0000000… 18 NA
#> 3 W000000003 10.1… Comp… This st… 2024 Revi… S0000000… 7 NA
#> # ℹ 7 more variables: language <chr>, pmid <chr>, arxiv_id <chr>,
#> # openalex_id <chr>, is_retracted <lgl>, retraction_date <date>,
#> # last_refreshed <dttm>