Identify use of a reporting guideline from a PMC XML file. — rt_reporting

Detects whether an article states that it followed a reporting guideline (the EQUATOR-network checklists such as CONSORT, PRISMA, STROBE, ARRIVE, STARD, TRIPOD, COREQ, SQUIRE, CHEERS) and which one. Detection is precision-first: a guideline acronym is counted only when it appears in a reporting context (a reporting or adherence verb, or a guideline noun such as "statement", "checklist" or "guideline"), so a bare citation does not count.

Usage

rt_reporting_pmc(filename, remove_ns = TRUE)

Arguments

filename: The filename of the PMC XML file to analyze.
remove_ns: Ignored since version 1.2.0 and kept for backward compatibility. Default XML namespaces are now always removed, so a namespaced PMC XML file gives the same result as a plain one.

Value

A tibble with the article IDs, whether a reporting-guideline statement was found (`is_reporting_pred`), the guideline(s) named (`reporting_guideline`), the matched statement (`reporting_text`) and `is_success`.

Examples

# \donttest{
filepath <- system.file(
  "extdata", "PMID32171256-PMC7071725.xml", package = "rtransparency"
)
rt_reporting_pmc(filepath)
#> # A tibble: 1 × 9
#>   pmid  pmcid_pmc pmcid_uid doi   filename is_reporting_pred reporting_guideline
#>   <chr> <chr>     <chr>     <chr> <chr>    <lgl>             <chr>              
#> 1 3217… PMC70717… 7071725   10.1… /home/r… FALSE             ""                 
#> # ℹ 2 more variables: reporting_text <chr>, is_success <lgl>
# }