DataCheckMark2Cube: create a cube of data from the results of a "pick-1" (aka...

View source: R/BootRatio.R

DataCheckMark2CubeR Documentation

create a cube of data from the results of a "pick-1" (aka Check-1 or "Best That Apply", BeTA) data task (i.e., describe one object with one descriptor from a finite list of descriptors).

Description

DataCheckMark2Cube: Create a cube of data from the results of a pick one descriptor to describe stimuli. The result of the check mark task is a data frame stored in DataChecks. These data correspond to participants matching one descriptor to each stimulus of a set of stimuli, this task is called pick-1, check-1, or BeTA (BEst That Apply). The Stimuli are the columns of DataChecks, the Participants are the rows of DataChecks, and the Descriptors are the numbers in DataChecks (i.e., 5 for X[2,3] means that Participant 2, chose Descriptor 5 for Stimulus 3).

Usage

DataCheckMark2Cube(DataChecks, NameOfDescriptor = NULL)

Arguments

DataChecks

A Stimuli by Participants table of checks The Stimuli are the columns of DataChecks, The Participants are the rows of DataChecks, The Descriptors are the numbers in DataChecks (i.e., 5 for X[2,3] means that Participant 2, chose Descriptor 5 for Stimulus 3)

NameOfDescriptor

a length K vector of names of the descriptors. if NULL (default) descriptors are named Descriptor-1 to Descriptor-K.

Value

a Stimuli * Descriptors * Participants brick (i.e., an array) of counts.

Author(s)

Hervé Abdi

Examples

# use the colorOfMusic data set. See help(colorOfMusic)
data("colorOfMusic")
cubeOfMusic <- DataCheckMark2Cube(
colorOfMusic$participantsChoice, colorOfMusic$colorInformation[,1])
# cubeOfMusic is an array with dimensions:
# 10 (colors) * 9 (pieces of music) * 22 (participant)

HerveAbdi/PTCA4CATA documentation built on July 17, 2022, 5:41 a.m.