Check works in the corpus against the Retraction Watch database (via the Crossref update notices and OpenAlex) to identify retracted publications.
Updates the is_retracted and retraction_date columns in the
works table.
This enricher is idempotent: re-running it updates existing retraction data rather than duplicating it.
Usage
sm_enrich_retraction(
corpus,
verbose = TRUE,
api_key = Sys.getenv("OPENALEX_API_KEY"),
mailto = Sys.getenv("SCIMAPR_MAILTO"),
call = rlang::caller_env()
)Value
An sm_corpus object with updated is_retracted and
retraction_date columns in the works table, plus new provenance
rows for checked works only. Failed requests warn; when no work could
be checked they error without changing the corpus. Missing records are
reported separately. Existing retraction flags are never cleared.
Examples
# \donttest{
# Queries the OpenAlex and Crossref web APIs; the second DOI belongs to a
# retracted article.
if (requireNamespace("curl", quietly = TRUE) && curl::has_internet()) {
corpus <- sm_corpus(works = tibble::tibble(
work_id = c("W1", "W2"),
doi = c("10.1016/j.joi.2017.08.007", "10.1016/S0140-6736(97)11096-0")
))
enriched <- try(sm_enrich_retraction(corpus))
if (is_sm_corpus(enriched)) enriched$works[, c("doi", "is_retracted")]
}
#> ℹ 1 retracted of 2 checked; 1 not found in OpenAlex; 0 not checked.
#> # A tibble: 2 × 2
#> doi is_retracted
#> <chr> <lgl>
#> 1 10.1016/j.joi.2017.08.007 FALSE
#> 2 10.1016/S0140-6736(97)11096-0 TRUE
# }