Audits the open-access (OA) status distribution of works in a corpus.
Uses the statuses of sm_oa_statuses(); every recognised status except
closed is open. Missing and unrecognised values are unknown.
The open percentage uses all works as the denominator and agrees with
sm_summary_works() to one decimal place.
The result includes counts and percentages for each OA category, as well as a coverage metric.
Usage
sm_audit_oa(corpus, call = rlang::caller_env())
# S3 method for class 'sm_audit_oa'
print(x, ...)Value
An sm_audit_oa S3 object containing:
- distribution
Tibble with columns
oa_status,count,pct, and logicalis_open(NAfor unknown statuses).- pct_open
Percentage of works with an open status in
sm_oa_statuses().- coverage
Proportion of works with a known OA status.
- n_works
Total number of works.
Examples
corpus <- sm_example_corpus()
oa <- sm_audit_oa(corpus)
print(oa)
#>
#> ── <sm_audit_oa> ───────────────────────────────────────────────────────────────
#> Open access: 56.5%
#> Coverage: 100% of works have known OA status
#> Total works: 200
#>
#>
#> ── OA status distribution
#> closed: 87 (43.5%)
#> gold: 35 (17.5%)
#> green: 32 (16%)
#> bronze: 24 (12%)
#> hybrid: 22 (11%)
#>
#>
#> ── Limitations
#> • OA status may change over time as embargo periods expire or publishers change
#> their access policies.
#> • 'Green' OA indicates a version is available in a repository but it may not be
#> the version of record.
#> • 'Bronze' OA indicates free-to-read on the publisher site without a formal
#> open license; access may be revoked.
#> • OA status data depends on Unpaywall/OpenAlex coverage, which may not include
#> all repositories.