Skip to contents

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 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 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>