Modifying Cell Content - Round Data

From Q
Jump to: navigation, search

This rule modifies the selected statistics to round the data to a specified number of decimal places, for use when exporting results (e.g., to Excel). This rule does not modify the number of decimal places that appear in Q (see Formatting Cells for instructions for modifying the number of decimals in Q).

Example

In this example, the data has been rounded to 0 decimal places.

RoundingValues.png

Technical details

  • This rule rounds to the nearest multiple of 10. For example, with no decimal places, it rounds to the nearest integer.
  • From time-to-time you may experience inconsistent results due to the influence that your operating system settings and your computer's process have on rounding.
  • Significance tests are conducted on the results prior to the modification.
  • You can choose to modify all numeric statistics shown on the table, or you can select a set of statistics to modify.
  • You can also choose whether or not marginal statistics (Statistics - Below and Statistics - Right) are included in the modification.
  • A footnote is added to explain which statistics have been modified in this way.

How to apply this rule

For the first time in a project

  • Select the table(s)/chart(s) that you wish to apply the rule to.
  • Start typing the name of the Rule into the Search features and data box in the top right of the Q window.
  • Click on the Rule when it appears in the QScripts and Rules section of the search results.

OR

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

Additional applications of the rule

  • Select a table or chart that has the rule and any table(s)/chart(s) that you wish to apply the rule to.
  • Click on the Rules tab (bottom-left of the table/chart).
  • Select the rule that you wish to apply.
  • Click on the Apply drop-down and choose your desired option.
  • Check New items to have it automatically applied to new items that you create. Use Edit > Project Options > Save as Template to create a new project template that automatically uses this rule.

Removing the rule

  • Select the table(s)/chart(s) that you wish to remove the rule from.
  • Press the Rules tab (bottom-right corner).
  • Press Apply next to the rule you wish to remove and choose the appropriate option.

How to modify the rule

  • Click on the Rules tab (bottom-left of the table/chart).
  • Select the rule that you wish to modify.
  • Click Edit Rule and make the desired changes. Alternatively, you can use the JavaScript below to make your own rule (see Customizing Rules).

JavaScript

includeWeb('Table JavaScript Utility Functions');
 
// List of statistics for the menu. Text-based stats, or stats which are
// already integers (eg Base n) are not included.
var not_selected_string = "(none)";
var stat_list = [not_selected_string].concat(_GLOBAL_STAT_LIST);
 
var stats_to_remove =  ["Base n", "Column n", "Column Comparisons",
                        "Column Names", "Column Population",
                        "Columns Compared", "Expected n", "Missing n", "n",
                        "n Observations", "Not duplicate", "Row n", "Text",
                        "Text With No Blanks", "Unique Text"];
 
stat_list = stat_list.filter(function (s) { return stats_to_remove.indexOf(s) == -1; });
 
 
// Decimal number control
var decimals_label = form.newLabel("Decimal places to round: ");
var decimals_box = form.newNumericUpDown("nd");
decimals_box.setDefault(1);
decimals_box.setIncrement(1);
decimals_box.setMinimum(0);
decimals_box.setMaximum(10);
decimals_box.lineBreakAfter = true;
 
// Apply to marginal statistics?
var marginals_check_box = form.newCheckBox("mcb", "Apply to marginal statistics");
marginals_check_box.lineBreakAfter = true;
marginals_check_box.setDefault(true);
 
// Apply to all statistics?
var all_stats_box = form.newCheckBox("ascb", "Apply to all statistics");
all_stats_box.lineBreakAfter = true;
 
 
var controls = [decimals_label, decimals_box, marginals_check_box, all_stats_box];
form.setInputControls(controls);
 
var all_stats = all_stats_box.getValue(); 
var num_decimals = decimals_box.getValue();
var do_marginals = marginals_check_box.getValue();
 
var all_selected_stats = table.statistics;
if (do_marginals) {
    if (rightTableExists())
        all_selected_stats = all_selected_stats.concat(right_table.statistics);
    if (belowTableExists())
        all_selected_stats = all_selected_stats.concat(below_table.statistics);
}
 
// If not applying to all stats then get the user to select which stats to use
var stats = [];
if (!all_stats) {
    var stat_select_label = form.newLabel("Apply only to:");
    stat_select_label.lineBreakAfter = true;
    controls.push(stat_select_label);
    var counter = 0;
    var new_stat_box, last_selection;
 
    var make_new_stat_box = function () {
        new_stat_box = form.newComboBox("sb" + counter, stat_list);
        new_stat_box.setDefault(not_selected_string);
        new_stat_box.lineBreakAfter = true;
        controls.push(new_stat_box);
        form.setInputControls(controls);
        last_selection = new_stat_box.getValue();
    };
 
    make_new_stat_box();
 
    while (last_selection != not_selected_string) {
        stats.push(last_selection);
        counter ++;
        make_new_stat_box();
    }
} else
    stats = all_selected_stats;
 
 
// Create messages to use in summary and footer 
var decimals_string = num_decimals + " decimal place" + (num_decimals == 1 ? "" : "s");
var summary_text = "Round to " + decimals_string + ": " 
                    + (all_stats ? "all statistics" : stats.slice(0, Math.min(3, stats.length)).join(", ") + (stats.length > 3 ? "..." : ""));
form.setSummary(summary_text);
form.setHeading("Round");
 
// Change table stats
 
roundTable(table, function (stat, round_stats) {
    table.set(stat, round_stats);
});
 
if (do_marginals) {
    if (rightTableExists()) {
        roundTable(right_table, function (stat, round_stats) {
            setMarginalStatistic(right_table, stat, round_stats);
        });
    }
    if (belowTableExists()) {
        roundTable(below_table, function (stat, round_stats) {
            setMarginalStatistic(below_table, stat, round_stats);
        });
    }
}
 
// Set footer
var trimmed_stats = stats.filter(function (s) { return all_selected_stats.indexOf(s) > -1 });
if (all_stats || trimmed_stats.length > 0) {
    var footer = table.extraFooters;
    var footer_message = (all_stats ? "All statistics" : trimmed_stats.join(", ")) 
                         + (all_stats || trimmed_stats.length > 1 ? " have " : " has ")
                         + "been rounded to " + decimals_string;
    footer.push(footer_message);
    table.extraFooters = footer;
}
 
// For each selected statistic, get its values, round them, and then
// fire a function that decides how to apply them to the table.
//
// apply_round_stats should be a function(stat, 2d_stats_array) {}
function roundTable(ttable, apply_round_stats) {
    ttable.statistics.forEach(function (stat) {
        if (stats.indexOf(stat) > -1) {
            var current_values = ttable.get(stat);
            if (typeof current_values[0][0] != "string") {
                apply_round_stats(stat, roundStats(current_values, num_decimals));
            }
        }
    });    
}

See also

Personal tools
Namespaces

Variants
Actions
Navigation
Categories
Toolbox