Check a data frame of references for retraction

Usage

check_refs(
  data,
  doi_col = NULL,
  pmid_col = NULL,
  title_col = NULL,
  author_col = NULL,
  year_col = NULL,
  sources = getOption("retraction.sources", "xera"),
  offline = FALSE,
  flag_nature = c("Retraction", "Expression of Concern"),
  allow_fuzzy = TRUE,
  resolve_ids = TRUE,
  progress = TRUE,
  strict = FALSE
)

Arguments

data: A data frame of references.
doi_col, pmid_col, title_col, author_col, year_col: Column names. When NULL (default) they are auto-detected from common names.
sources: Sources to query. A character vector of names from list_backends(), or "all". Defaults to getOption("retraction.sources", "xera").
offline: If TRUE, match against the local snapshot built by retraction_sync() instead of querying the network.
flag_nature: Notice labels that count as "flag this citation". Defaults to Retraction and Expression of Concern.
allow_fuzzy: Allow fuzzy title matching for references without a usable identifier.
resolve_ids: If TRUE, resolve PMID-only references to a DOI via OpenAlex before matching.
progress: Show a progress bar in interactive sessions.
strict: If TRUE, error when any reference cannot be checked (an unchecked row from a network or source failure) instead of returning it, so a failure cannot be mistaken for a clean result. Useful in CI.

Value

A retraction_result tibble.

Examples

# \donttest{
df <- data.frame(doi = "10.1016/S0140-6736(97)11096-0", title = "Ileal-lymphoid...")
check_refs(df)
#> 
#> ── retraction: 1 reference checked ─────────────────────────────────────────────
#> ✖ 1 retracted or flagged
#> ✔ 0 clean
#> 
#> ── Flagged citations ──
#> 
#> • row1: Ileal-lymphoid-nodular Hyperplasia, Non-specific Colitis, and Pervasive
#> Developmental Disorder in Children (retracted 2010-02-06; source: xera)
#> 
#> ℹ Full table: `as.data.frame(x)` or `tibble::as_tibble(x)`.
# }