Skip to contents

Identify disclosure of generative-AI use from a TXT file.

Source: R/rt_ai.R
rt_ai.Rd

Detects whether an article discloses the use (or non-use) of generative AI or AI-assisted tools in preparing the manuscript, from a plain-text (typically PDF-derived) file. Unlike [rt_ai_pmc()] it applies **no publication-year gate**: a plain-text file carries no reliable publication date, so `is_ai_pred` is always `TRUE` or `FALSE` (never `NA`). AI-use disclosure became an expected practice only in 2023, so the caller is responsible for restricting analysis to articles from 2023 onward. Plain text also lacks the section structure the PMC detector uses to confine the scan to back matter, acknowledgments and declaration sections, so an article that uses AI purely as a research method is more likely to be flagged than under [rt_ai_pmc()].

Usage

rt_ai(filename)

Arguments

filename

The name of the TXT file as a string.

Value

A tibble with the filename, the PMID (if present in the file name), whether an AI-use disclosure was found (`is_ai_pred`) and the matched statement (`ai_text`).

See also

[rt_ai_pmc()] for the PMC XML detector, which applies the 2023 publication-year gate.

Examples

# \donttest{
# Write a short example article to a temporary text file.
filepath <- file.path(tempdir(), "PMID00000000-PMC0000000.txt")
writeLines(
  "The authors used ChatGPT to assist with drafting this manuscript.",
  filepath
)

# Identify and extract an AI-use disclosure.
rt_ai(filepath)
#> # A tibble: 1 × 4
#>   article                     pmid     is_ai_pred ai_text                       
#>   <chr>                       <chr>    <lgl>      <chr>                         
#> 1 PMID00000000-PMC0000000.txt 00000000 TRUE       "The authors used ChatGPT to …
# }