bws3.design {support.BWS3}

Designing choice sets for Case 3 best-worst scaling

Description

This function creates a design for Case 3 best-worst scaling (BWS) from a full/fractional factorial design (FFD) and a balanced incomplete block design (BIBD).

Usage

bws3.design(bibd, ffd, attribute.levels)

Arguments

bibd

A data frame or matrix containing a BIBD.

ffd

A data frame or matrix containing a FFD.

attribute.levels

A list containing the names of the attributes and their levels.

Details

This function creates the choice sets for Case 3 BWS according to Louviere et al. (2015): candidate alternatives (profiles) are created using a FFD; and then the profiles are assigned to the choice sets using a BIBD. The FFD and BIBD used in the function must satisfy the following:

1) The level values in the FFD and those in the BIBD are serial integer values starting from 1.

2) The number of columns of the BIBD is equal to or larger than three.

3) The number of treatments in the BIBD is equal to the number of rows of the FFD.

4) The number of columns of the FFD is equal to the number of attributes.

5) The order of columns (from left to right) of the FFD corresponds to the order of component names in the list assigned to the argument attribute.levels.

Value

This function returns an object of S3 class "cedes" which is a list of the following components (see also the help for rotation.design in the support.CEs package):

alternatives

A list of objects, alt.j: the j-th alternative in each choice set created by the function. Each alt.j includes the variables BLOCK, QES, ALT, and attribute variables corresponding to the argument attribute.levels.

design.information

Information related to the design for Case 3 BWS created by the function. This list includes objects such as the number of blocks into which the design is divided (nblocks), the number of questions per block (nquestions), the number of alternatives per choice set (nalternatives), and the number of attributes per alternative (nattributes).

References

See the help page for support.BWS3-package.

See Also

bws3.dataset, bws3.response, support.BWS3-package, rotation.design

Examples

# See the section Examples in the help page for the function bws3.response.