bws3.design: Designing choice sets for Case 3 best-worst scaling
In support.BWS3: Tools for Case 3 Best-Worst Scaling

Description Usage Arguments Details Value References See Also Examples

View source: R/bws3.design.R

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).

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

`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.

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.

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`).