This package contains tools for designing surveys and conducting power analyses for choice based conjoint survey experiments in R.
Installation
The current version is not yet on CRAN, but you can install it from Github using the {remotes} library:
# install.packages("remotes")
remotes::install_github("jhelvy/conjointTools")Load the library with:
Make experiment designs
The first step in designing an experiment is to define the attributes and levels for your experiment. Many of the functions in {conjointTools} are more convenient to use if you define these as a separate object. For example, let’s say you’re designing a conjoint experiment about apples. You might have the following attributes and levels:
# Define the attributes and levels
levels <- list(
price = seq(1, 4, 0.5), # $ per pound
type = c('Fuji', 'Gala', 'Honeycrisp', 'Pink Lady', 'Red Delicious'),
freshness = c('Excellent', 'Average', 'Poor')
)With these levels defined, making the design of experiment is straightforward using the makeDoe() function:
# Make a full-factorial design of experiment
doe <- makeDoe(levels)
head(doe)
#> price type freshness
#> 1 1 1 1
#> 2 2 1 1
#> 3 3 1 1
#> 4 4 1 1
#> 5 5 1 1
#> 6 6 1 1You can also make an “optimized” fractional-factorial design based on different criteria. For example, to make a “D-optimal” design, add the type = "D" argument and specify the number of trials you want to use from the full factorial design:
# Make a full-factorial design of experiment
doe <- makeDoe(levels, type = "D", nTrials = 50)Once you’ve made your design, you can easily re-code it using the actual labels in your levels object using recodeDesign():
# Re-code levels
doe <- recodeDesign(doe, levels)
head(doe)
#> price type freshness
#> 1 1.0 Fuji Excellent
#> 2 2.5 Fuji Excellent
#> 3 4.0 Fuji Excellent
#> 4 1.5 Gala Excellent
#> 5 2.0 Gala Excellent
#> 6 3.0 Gala ExcellentMake conjoint surveys
A survey can be generated by randomly sampling from the design of experiment. The makeSurvey() function also eliminates the possibility of duplicate alternatives appearing in the same choice question:
survey <- makeSurvey(
doe = doe, # Design of experiment
nResp = 2000, # Total number of respondents (upper bound)
nAltsPerQ = 3, # Number of alternatives per question
nQPerResp = 6 # Number of questions per respondent
)
dim(survey)
#> [1] 36000 7
head(survey)
#> respID qID altID obsID price type freshness
#> 1 1 1 1 1 2.0 Fuji Average
#> 2 1 1 2 1 1.5 Gala Excellent
#> 3 1 1 3 1 3.0 Pink Lady Excellent
#> 4 1 2 1 2 1.5 Fuji Average
#> 5 1 2 2 2 2.0 Honeycrisp Poor
#> 6 1 2 3 2 1.0 Honeycrisp PoorThe resulting data frame includes the following additional columns:
-
respID: Identifies each survey respondent. -
qID: Identifies the choice question answered by the respondent. -
altID:Identifies the alternative in any one choice observation. -
obsID: Identifies each unique choice observation across all respondents.
Simulate choices
You can simulate choices for a given survey using the simulateChoices() function. By default, random choices are simulated:
data <- simulateChoices(
survey = survey,
altID = "altID",
obsID = "obsID"
)
head(data)
#> respID qID altID obsID price type freshness choice
#> 1 1 1 1 1 2.0 Fuji Average 0
#> 2 1 1 2 1 1.5 Gala Excellent 1
#> 3 1 1 3 1 3.0 Pink Lady Excellent 0
#> 4 1 2 1 2 1.5 Fuji Average 1
#> 5 1 2 2 2 2.0 Honeycrisp Poor 0
#> 6 1 2 3 2 1.0 Honeycrisp Poor 0You can also pass a list of parameters to define a utility model that will be used to simulate choices. In the example below, the choices are simulated using a utility model with the following parameters:
- 1 continuous
priceparameter - 4 discrete parameters for
type - 2 discrete parameters for
freshness
data <- simulateChoices(
survey = survey,
altID = "altID",
obsID = "obsID",
pars = list(
price = 0.1,
type = c(0.1, 0.2, 0.3, 0.4),
freshness = c(0.1, -0.1))
)You can also simulate data with more complex models, such as mixed logit models where parameters follow a normal or log-normal distribution across the population, or interaction between parameters. In the example below, the choices are simulated using a utility model with the following parameters:
- 1 continuous “price” parameter
- 4 discrete parameters for “type”
- 2 random normal discrete parameters for “freshness”
- 2 interaction parameters between “price” and “freshness”
The randN() function is use to make the 2 freshness parameters follow a normal distribution with a specified mean (mu) and standard deviation (sigma).
Conduct a power analysis
The simulated choice data can be used to conduct a power analysis by estimating multiple models with different sample sizes. The estimateModels() function achieves this by partitioning the simulated choice data into multiple sizes (defined by the nbreaks argument) and then estimating a user-defined choice model on each data subset. In the example below, 10 different sample sizes are used to estimate 10 models.
models <- estimateModels(
nbreaks = 10,
data = data,
pars = c("price", "type", "freshness"),
choice = "choice",
obsID = "obsID"
)The resulting models object is a data.table where each row represents a separate simulation. The columns are:
-
sampleSize: The same size used in the simulation. -
data: The subset of data used in the estimated model. -
model: The estimated model object.
All models are estimated using the {logitr} package.
While the models data.table is a rather complex object in that it contains columns of lists, helper functions can be used to extract information of interest. For example, the estimated coefficients and standard errors from each model can be extracted using the getModelResults() function:
results <- getModelResults(models)
head(results)
#> sampleSize coef est se
#> 1: 200 price -0.07093766 0.0616323
#> 2: 200 typeGala 0.01852680 0.1909831
#> 3: 200 typeHoneycrisp -0.18315704 0.2019748
#> 4: 200 typePink Lady 0.03520526 0.1888064
#> 5: 200 typeRed Delicious -0.09550322 0.2008047
#> 6: 200 freshnessExcellent 0.01345243 0.1576876Here is a summary of the standard errors for each sample size:
library(ggplot2)
ggplot(results) +
geom_hline(yintercept = 0.05, color = "red", linetype = 2) +
geom_point(aes(x = sampleSize, y = se, color = coef)) +
expand_limits(y = 0) +
theme_bw()
Citation Information
If you use this package for in a publication, I would greatly appreciate it if you cited it - you can get the citation by typing citation("conjointTools") into R:
citation("conjointTools")
#>
#> To cite conjointTools in publications use:
#>
#> John Paul Helveston (2021). conjointTools: Tools For Designing
#> Conjoint Survey Experiments.
#>
#> A BibTeX entry for LaTeX users is
#>
#> @Manual{,
#> title = {conjointTools: Tools For Designing Conjoint Survey Experiments},
#> author = {John Paul Helveston},
#> year = {2021},
#> note = {R package version 0.0.6},
#> url = {https://jhelvy.github.io/conjointTools/},
#> }