Recoding - Recoding Lower Values (Capping)

From Q
Jump to: navigation, search

This QScript allows you to recode questions so that any value less than a specified value is recoded to that value. You will be asked to specify the questions to recode.

Example

If you enter a value of 10, all values less than 10 will be recoded as 10 for the questions that you select.

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 Selection Functions');
includeWeb('QScript Functions to Generate Outputs');
includeWeb('QScript Value Attributes Functions');

main();

function main() {

    var selected_datafiles = dataFileSelection();

    var relevant_questions = getAllQuestionsByTypes(selected_datafiles, ["Number", "Number - Multi"]);

    try {
        // Question selection
        var selected_questions = selectManyQuestions("Please select the questions to recode:", relevant_questions).questions;
        var num_selected = selected_questions.length;

        // Recoding input
        var message = "Recode all values less than this value to this value (e.g., if you enter a value of 10, all values less than 10 will be recoded as 10):";
        var min = prompt(message);
    } catch (e) {
        return false;
    }

    // Recoding
    for (var j = 0; j < num_selected; j++)
        recodeLowValues(selected_questions[j], min, min);

    generateGroupOfSummaryTables("Redcoded questions", selected_questions);
    log('A group of tables showing the recoded questions has been added to your report.')
}


See also