parse.md.qualtrics: Parse Qualtrics MaxDiff data and optionally set up a study...

View source: R/maxdiff-data-importexport.R

parse.md.qualtricsR Documentation

Parse Qualtrics MaxDiff data and optionally set up a study object

Description

In a Qualtrics exported data set, at the time of writing, there is no positive identification of which items in a data set are MaxDiff items vs other kinds of survey items. This function attempts to identify MaxDiff items using various tactics, and also infers properties of the MaxDiff design, such as the number of items, their text, and the number of task sets.

Usage

parse.md.qualtrics(
  file.qsv = NULL,
  itemSplit = "%-%",
  designHead = "Display Order",
  itemConfirm = NULL,
  friendly.names = NULL,
  returnList = FALSE
)

Arguments

file.qsv

The Qualtrics exported QSV (quasi-CSV) file.

itemSplit

The short string used by Quatrics to split item headers and text

designHead

String used by Qualtrics to identify columns in the design matrix

itemConfirm

Optional. A string that appears only in your MaxDiff item headers (e.g., tje question text) and not in any other items. This can help the parse routine identify the MaxDiff items.

friendly.names

TBW

returnList

TBW

Details

That information is needed to set up a "study object" that we typically name md.define. This function can optionally set up that object for you, and then the study object can be used by read.md.qualtrics() to actually import the data, as well as by other functions to estimate and plot the results (e.g., md.hb() and plot.md.range()).

Be sure to read all output carefully to make sure it matches your expectations. If the import fails, check the above requirements carefully and remove any respondents with incomplete data. Check that the exported data set matches the requirements. Compare the "qualtrics-pizza-maxdiff.csv" data set in this package to see whether your data appear similar in structure.

Additional details and examples are in Chapter 10 of Chapman & Rodden, "Quantitative User Experience Research".

Value

TBW

See Also

[read.md.qualtrics] to actually read in a data set, [parse.md.cho] for a similar function for Sawtooth Software .CHO files.


cnchapman/choicetools documentation built on May 28, 2023, 9:14 a.m.