Modifying Data - Create New Top K Category NETs (That is, Top K Boxes)

From Q
Jump to: navigation, search

This QScript creates new NET categories for the top k categories in Pick One and Pick One - Multi questions (sometimes called Top k Boxes). The top categories are automatically identified based on the values of the categories, taking account of any recoding that has been done. Categories which look like Don't Know options will not be included in the top boxes, and when such categories are identified the script will give you the option to remove them.

Example

Top2cat.png

Technical details

The top categories are identified by looking at the numeric Value for each category that is not selected as Missing Data in the Values, and choosing the highest. This takes into account any recoding that has been done.

This QScript:

  1. Asks you how many categories you wish to combine.
  2. Asks you if you want to consider questions whose categories suggest that they may be scale questions (for example, 5-point agreement scales).
  3. Asks you to select which questions to create NETs for.
  4. Give you the option to remove categories which look like Don't Know options. This is equivalent to setting the category as Missing Data.
  5. Asks whether you want the new NETs added at the beginning (top or left) or the question, or the end (bottom or right) of a question, or if you want them left in their default position (under the last category in the NET).
  6. Adds new top k NETs for each selected question.
  7. Produces a new folder in your Report showing which questions have been changed.

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 Functions for Combining Categories');
includeWeb('QScript Functions to Generate Outputs');

var bottom = false;
if (!topAndBottomBoxNETCreator(bottom))
    log("QScript cancelled.")

Prior to the 15th of December, 2015, this page was known as Modifying Rows and Columns - Create New Top K Category NETs (That is, Top K Boxes)

See also