Computes Aiken's V (Aiken, 1985), an index of content validity that uses the full rating scale rather than dichotomizing responses as in I-CVI. Aiken's V ranges from 0 to 1, where 1 indicates all experts gave the maximum rating and 0 indicates all gave the minimum.
Usage
aiken_v(
ratings,
lo = 1,
hi = 4,
na.rm = FALSE,
ci = FALSE,
n_boot = 2000,
ci_method = c("percentile", "bca"),
conf_level = 0.95,
seed = NULL
)Arguments
- ratings
A numeric matrix or data frame of expert ratings (rows = experts, columns = items). A numeric vector is also accepted, treated as a single item.
- lo
Numeric. Minimum possible rating on the scale. Default 1.
- hi
Numeric. Maximum possible rating on the scale. Default 4.
- na.rm
Logical. If
TRUE, missing ratings are excluded. Defaults toFALSE.- ci
Logical. If
TRUE, returns a data frame with bootstrap confidence intervals alongside the point estimate. Defaults toFALSE(returns a numeric vector, identical to the package's pre-0.2.0 behaviour).- n_boot
Integer. Number of bootstrap replicates when
ci = TRUE. Defaults to 2000 (Davison & Hinkley, 1997; Hesterberg, 2015).- ci_method
Character. One of
"percentile"(default; Efron & Tibshirani, 1993) or"bca"(bias-corrected and accelerated; DiCiccio & Efron, 1996).- conf_level
Numeric. Confidence level between 0 and 1. Defaults to 0.95.
- seed
Integer or
NULL. If supplied, passed toset.seed()for reproducible bootstrap samples. Defaults toNULL.
Value
When ci = FALSE (default), a named numeric vector of V values,
one per item (or a single numeric value if ratings is a vector).
When ci = TRUE, a data frame with one row per item and columns
item, aiken_v, ci_lower, ci_upper, ci_method, conf_level,
n_boot.
Details
Optional bootstrap confidence intervals are available via ci = TRUE.
Resampling is performed at the expert (row) level, matching the standard
inferential frame for inter-rater reliability analyses (Gwet, 2014).
Aiken's V is calculated as:
$$V = (\bar{X} - lo) / (hi - lo)$$
where \(\bar{X}\) is the mean expert rating across raters, and lo and
hi are the minimum and maximum possible scale values, respectively.
A common cutoff is V >= 0.70 for adequate content validity, though stricter thresholds are sometimes applied depending on panel size and research context. Unlike I-CVI, Aiken's V uses the full rating scale, so a rating of 4 contributes more than a rating of 3 (rather than both being counted equally as "relevant").
References
Aiken, L. R. (1985). Three coefficients for analyzing the reliability and validity of ratings. Educational and Psychological Measurement, 45(1), 131-142. doi:10.1177/0013164485451012
Davison, A. C., & Hinkley, D. V. (1997). Bootstrap methods and their application. Cambridge University Press. doi:10.1017/CBO9780511802843
DiCiccio, T. J., & Efron, B. (1996). Bootstrap confidence intervals. Statistical Science, 11(3), 189-228. doi:10.1214/ss/1032280214
Efron, B., & Tibshirani, R. J. (1993). An introduction to the bootstrap. Chapman and Hall. doi:10.1201/9780429246593
Gwet, K. L. (2014). Handbook of inter-rater reliability (4th ed.). Advanced Analytics, LLC.
Hesterberg, T. C. (2015). What teachers should know about the bootstrap: Resampling in the undergraduate statistics curriculum. The American Statistician, 69(4), 371-386. doi:10.1080/00031305.2015.1089789
Examples
ratings <- matrix(
c(4, 4, 3, 4, 4,
3, 4, 4, 4, 3,
2, 3, 3, 4, 3,
1, 2, 3, 2, 3),
nrow = 5,
dimnames = list(NULL, paste0("item", 1:4))
)
aiken_v(ratings)
#> item1 item2 item3 item4
#> 0.9333333 0.8666667 0.6666667 0.4000000
# 5-point scale
aiken_v(c(5, 4, 5, 5, 4), lo = 1, hi = 5)
#> [1] 0.9
# With bootstrap confidence intervals (new in v0.2.0)
aiken_v(ratings, ci = TRUE, n_boot = 1000, seed = 1)
#> item aiken_v ci_lower ci_upper ci_method conf_level n_boot
#> 1 item1 0.9333333 0.8000000 1.0000000 percentile 0.95 1000
#> 2 item2 0.8666667 0.7333333 1.0000000 percentile 0.95 1000
#> 3 item3 0.6666667 0.4666667 0.8666667 percentile 0.95 1000
#> 4 item4 0.4000000 0.2000000 0.6000000 percentile 0.95 1000