Choice Modeling - Diagnostic - Trace Plots

From Q
Jump to: navigation, search

Takes a Hierarchical Bayes (Stan) output and produces trace plots of the mean and standard deviation parameters for the distribution from which individual coefficients are sampled. For more information on how to interpret this output, see this blog post, which was written for the closely-related MaxDiff analysis.

Example

Technical details

Whenever Hierarchical Bayes analysis is run with multiple classes, an attempt will be made to match class labels between chains (note that it is often not possible to match class labels). If this succeeds, or if only one chain was specified, one set of mean and standard deviation parameters will be shown for each class. If this attempt is unsuccessful, the trace plots will not be able to be displayed.

How to apply this QScript

  • Start typing the name of the QScript into the Search features and data box in the top right of the Q window.
  • Click on the QScript when it appears in the QScripts and Rules section of the search results.

OR

  • Select Automate > Browse Online Library.
  • Select this QScript from the list.

Customizing the QScript

This QScript is written in JavaScript and can be customized by copying and modifying the JavaScript.

Customizing QScripts in Q4.11 and more recent versions

  • Start typing the name of the QScript into the Search features and data box in the top right of the Q window.
  • Hover your mouse over the QScript when it appears in the QScripts and Rules section of the search results.
  • Press Edit a Copy (bottom-left corner of the preview).
  • Modify the JavaScript (see QScripts for more detail on this).
  • Either:
    • Run the QScript, by pressing the blue triangle button.
    • Save the QScript and run it at a later time, using Automate > Run QScript (Macro) from File.

Customizing QScripts in older versions

  • Copy the JavaScript shown on this page.
  • Create a new text file, giving it a file extension of .QScript. See here for more information about how to do this.
  • Modify the JavaScript (see QScripts for more detail on this).
  • Run the file using Automate > Run QScript (Macro) from File.

JavaScript

includeWeb("QScript R Output Functions");

main();

function main() {

    // The following 2 variables contain information specific to this diagnostic.
    var required_class = "FitChoice";
    var output_name_suffix = "trace.plots";
    
    var item = checkSelectedItemClass(required_class);
    if (item == null)
        return false;
    var r_name = stringToRName(item.referenceName);

    // The following lines contain the R code to run
    var expression = "r.name <- flipChoice::TracePlots(" + r_name + ")";

    return createROutput(item, expression, output_name_suffix);
}

Acknowledgements

Uses the rstan R package.

References

McLean, M. W. (2018, July 24). How to Use Hierarchical Bayes for Choice Modeling in Displayr [Blog post]. Accessed from https://www.displayr.com/how-to-hierarchical-bayes-choice-model-displayr/.

Yap, J. (2018, January 16). Checking Convergence When Using Hierarchical Bayes for MaxDiff [Blog post]. Accessed from https://www.displayr.com/convergence-hb-maxdiff/.


See also