bws2.questionnaire {support.BWS2}

Converting an orthogonal main-effect design into Case 2 best–worst scaling questions

Description

This function converts an orthogonal main-effect design into a series of Case 2 best–worst scaling questions.

Usage

bws2.questionnaire(choice.sets, attribute.levels = NULL, 
  position = c("left", "center", "right"))

Arguments

choice.sets

A data frame or matrix containing an orthogonal main-effect design.

attribute.levels

A list containing the names of attributes and their levels.

position

A character showing the position where attribute levels are shown in questions.

Details

The bws2.questionnaire() function converts an orthogonal main-effect design (OMED) into a series of Case 2 best–worst scaling (BWS) questions and then displays the resultant questions on an R console.

An OMED is assigned to the argument choice.sets, which may be generated by R functions such as oa.design() in DoE.base or manually copied from text books or websites related to experimental designs.

Attributes and their levels are assigned to the argument attribute.levels in list format. For example, suppose that profiles have four attributes, each of which has three levels: attribute A with levels A1, A2, and A3; attribute B with levels B1, B2, and B3; attribute C with levels C1, C2, and C3; and attribute D with levels D1, D2, and D3. In this case, the argument is set as follows:

attribute.levels = list(
A = c("A1", "A2", "A3"),
B = c("B1", "B2", "B3"),
C = c("C1", "C2", "C3"),
D = c("D1", "D2", "D3"))

The argument position is used to change the position of the attribute column in the resultant questions. When setting position = "left", the attribute column is located on the left-hand side as follows:

Q1
Attribute Best Worst
A1 [ ] [ ]
B1 [ ] [ ]
C1 [ ] [ ]
D1 [ ] [ ]

When setting position = "center", the attribute column is located in the center as follows:

Q1
Best Attribute Worst
[ ] A1 [ ]
[ ] B1 [ ]
[ ] C1 [ ]
[ ] D1 [ ]

When setting position = "right", the attribute column is located on the right-hand side as follows:

Q1
Best Worst Attribute
[ ] [ ] A1
[ ] [ ] B1
[ ] [ ] C1
[ ] [ ] D1

Value

BWS questions converted from the design are returned.

Author(s)

Hideo Aizaki

See Also

support.BWS2-package, bws2.dataset, oa.design

Examples

## See examples in bws2.dataset()