FactorialSurvey: Design and Analysis of Factorial Survey (Vignette) Experiments

An integrated workflow for factorial survey (vignette) experiments. Constructs D-efficient sets of vignettes from a factorial structure and reports their D- and A-efficiency following Kuhfeld, Tobias and Garratt (1994) <doi:10.1177/002224379403100408>, allocates them to blocks and to respondents in carryover-balanced orders, renders them as prose, and writes them out for survey platforms. Simulates responses to evaluate statistical power before fielding. Estimates beta regression models for bounded ratings and logit models for yes/no responses, with standard errors clustered by respondent, and derives average marginal effects, marginal willingness to pay and the expected willingness to pay for complete policy scenarios. The latter is the mean of willingness to pay truncated at zero, Hanemann (1989) <doi:10.2307/1242685>, applied to factorial surveys as in Tanaka et al. (2027) <doi:10.1016/j.tra.2026.105293>. Efficient designs and optimal blocking use the exchange algorithms of Fedorov (1972, ISBN:0122507509) as implemented in 'AlgDesign'. Presentation orders follow Williams (1949) <doi:10.1071/CH9490149>. Beta regression follows Ferrari and Cribari-Neto (2004) <doi:10.1080/0266476042000214501>. Bounded ratings are mapped to the open unit interval following Smithson and Verkuilen (2006) <doi:10.1037/1082-989X.11.1.54>.

Version: 0.3.0
Depends: R (≥ 4.1)
Imports: stats, tools, utils, AlgDesign, betareg, ggplot2 (≥ 3.4.0), sandwich
Suggests: openxlsx, margins, testthat (≥ 3.0.0), withr, knitr, rmarkdown
Published: 2026-11-20
DOI: 10.32614/CRAN.package.FactorialSurvey (may not be active yet)
Author: Katsuya Tanaka ORCID iD [aut, cre, cph]
Maintainer: Katsuya Tanaka <katsuyat at gmail.com>
BugReports: https://github.com/tanakak/FactorialSurvey/issues
License: MIT + file LICENSE
URL: https://github.com/tanakak/FactorialSurvey
NeedsCompilation: no
Language: en-GB
Materials: README, NEWS
CRAN checks: FactorialSurvey results

Documentation:

Reference manual: FactorialSurvey.html , FactorialSurvey.pdf
Vignettes: Getting started with FactorialSurvey (source, R code)

Downloads:

Package source: FactorialSurvey_0.3.0.tar.gz
Windows binaries: r-devel: not available, r-release: not available, r-oldrel: not available
macOS binaries: r-release (arm64): not available, r-oldrel (arm64): not available, r-release (x86_64): not available, r-oldrel (x86_64): not available

Linking:

Please use the canonical form https://CRAN.R-project.org/package=FactorialSurvey to link to this page.