CBC Functions

Sawtooth Script:

Description:

CBCAttributeLabel

 (ExerciseName_CBCQuestionName,

 AttributePosition#)

Returns the attribute label for the given attribute row position.  Useful if the attribute position is randomized in the design.

CBCAttributeValue
(ExerciseName_CBCQuestionName,
ConceptPosition#, LevelTextPosition#)

Returns the attribute value for the given attribute concept position and level position. Useful if the attribute position is randomized in the design. For merged rows etc. a 0 will be returned.

CBCColumnWidth(ExerciseName_CBCQuestionName)

Returns the CSS needed to define the column widths for the CBC task.

CBCDesignLevelText (ExerciseName_CBCQuestionName,

 ConceptPosition#, LevelTextPosition#)

Returns the level text for the specified CBC question in the specified concept position and level position within the task.  This function is used when researchers want to customize the format of their CBC questions.

CBCDesignLevelValue (ExerciseName_CBCQuestionName,

 ConceptPosition#, LevelTextPosition#)

Returns the level value for the specified CBC question in the specified concept position and level position within the task. Useful if the attribute position is randomized in the design.  For merged rows etc. a 0 will be returned.

CBCDesignConceptValue

 (ExerciseName_CBCQuestionName,

 ConceptPosition#)

Returns the actual concept number from the design that is being displayed to the screen in ConceptPosition#.  Position numbers will only differ if concept sorting is in place.  This function is used when researchers want to customize the format of their CBC questions.

CBCNone ()

Returns the "None" text for the CBC question (traditional "None" option only) and is only used in Shelf Facing Display CBC questions. This function is different than other Sawtooth Script.  See Location Specific Functions.

CBCVersion ()

Returns the design version number and question name.  This function is useful when creating paper-and-pencil interviews.  (Example: D - 1, T - ExerciseName_Random1).  Only available within a CBC task. This function is different than other Sawtooth Script.  See Location Specific Functions.

CBCCurrentTask()

Returns the index number for the ith CBC task in the exercise.  For the first task it will return a 1, the second one a 2, etc.  Must be used inside of the CBC question. This function is different than other Sawtooth Script.  See Location Specific Functions.

CBCTotalTasks()

Returns the total number of CBC tasks in the current exercise.  Must be used inside of a CBC question. This function is different than other Sawtooth Script.  See Location Specific Functions.