CBC Functions

Top  Previous  Next

CBC Functions are only applicable in CBC (Choice-Based Conjoint) questionnaires.  The CBCDesign function is useful when advanced researchers want to customize the format for their CBC questions.

 

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.

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.

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.

CBCVersion ()

Returns the design version number and question name.  This function is useful when creating paper-and-pencil interviews.  (Example: D-1, T-CBCRAN1).  Only available within a CBC task.

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.

CBCTotalTasks()

Returns the total number of CBC tasks in the current exercise.  Must be used inside of a CBC question.

 

For additional flexibility in Sawtooth Scripting, see the Unverified Perl documentation.

 

 

 

 

 

 

Page link: http://www.sawtoothsoftware.com/help/lighthouse-studio/manual/index.html?cbcfunctions_2.html