From b80377b4ef0ac5171c50b49953f0f9783cf6c948 Mon Sep 17 00:00:00 2001 From: skodak Date: Thu, 22 Nov 2007 21:36:59 +0000 Subject: [PATCH] MDL-12312 fixed outdated aggregation help, added examples; merged from MOODLE_19_STABLE --- admin/settings/grades.php | 6 +-- grade/edit/tree/category_form.php | 6 +-- lang/en_utf8/help/grade/aggregation.html | 48 ++++++++++++++++-------- 3 files changed, 38 insertions(+), 22 deletions(-) diff --git a/admin/settings/grades.php b/admin/settings/grades.php index 32af0dbdd7..1ca7d8d565 100644 --- a/admin/settings/grades.php +++ b/admin/settings/grades.php @@ -56,13 +56,13 @@ $strnoforce = get_string('noforce', 'grades'); // Aggregation type $options = array(GRADE_AGGREGATE_MEAN =>get_string('aggregatemean', 'grades'), + GRADE_AGGREGATE_WEIGHTED_MEAN =>get_string('aggregateweightedmean', 'grades'), + GRADE_AGGREGATE_WEIGHTED_MEAN2 =>get_string('aggregateweightedmean2', 'grades'), + GRADE_AGGREGATE_EXTRACREDIT_MEAN=>get_string('aggregateextracreditmean', 'grades'), GRADE_AGGREGATE_MEDIAN =>get_string('aggregatemedian', 'grades'), GRADE_AGGREGATE_MIN =>get_string('aggregatemin', 'grades'), GRADE_AGGREGATE_MAX =>get_string('aggregatemax', 'grades'), GRADE_AGGREGATE_MODE =>get_string('aggregatemode', 'grades'), - GRADE_AGGREGATE_WEIGHTED_MEAN =>get_string('aggregateweightedmean', 'grades'), - GRADE_AGGREGATE_WEIGHTED_MEAN2 =>get_string('aggregateweightedmean2', 'grades'), - GRADE_AGGREGATE_EXTRACREDIT_MEAN=>get_string('aggregateextracreditmean', 'grades'), GRADE_AGGREGATE_SUM =>get_string('aggregatesum', 'grades')); $defaults = array('value'=>GRADE_AGGREGATE_MEAN, 'forced'=>false, 'adv'=>false); $temp->add(new admin_setting_gradecat_combo('grade_aggregation', get_string('aggregation', 'grades'), get_string('aggregationhelp', 'grades'), $defaults, $options)); diff --git a/grade/edit/tree/category_form.php b/grade/edit/tree/category_form.php index 7aa1a1c6ec..5c5958f9dc 100644 --- a/grade/edit/tree/category_form.php +++ b/grade/edit/tree/category_form.php @@ -32,13 +32,13 @@ class edit_category_form extends moodleform { $mform =& $this->_form; $options = array(GRADE_AGGREGATE_MEAN =>get_string('aggregatemean', 'grades'), + GRADE_AGGREGATE_WEIGHTED_MEAN =>get_string('aggregateweightedmean', 'grades'), + GRADE_AGGREGATE_WEIGHTED_MEAN2 =>get_string('aggregateweightedmean2', 'grades'), + GRADE_AGGREGATE_EXTRACREDIT_MEAN=>get_string('aggregateextracreditmean', 'grades'), GRADE_AGGREGATE_MEDIAN =>get_string('aggregatemedian', 'grades'), GRADE_AGGREGATE_MIN =>get_string('aggregatemin', 'grades'), GRADE_AGGREGATE_MAX =>get_string('aggregatemax', 'grades'), GRADE_AGGREGATE_MODE =>get_string('aggregatemode', 'grades'), - GRADE_AGGREGATE_WEIGHTED_MEAN =>get_string('aggregateweightedmean', 'grades'), - GRADE_AGGREGATE_WEIGHTED_MEAN2 =>get_string('aggregateweightedmean2', 'grades'), - GRADE_AGGREGATE_EXTRACREDIT_MEAN=>get_string('aggregateextracreditmean', 'grades'), GRADE_AGGREGATE_SUM =>get_string('aggregatesum', 'grades')); // visible elements diff --git a/lang/en_utf8/help/grade/aggregation.html b/lang/en_utf8/help/grade/aggregation.html index 5fcdc1a6b1..c4f9a4db99 100644 --- a/lang/en_utf8/help/grade/aggregation.html +++ b/lang/en_utf8/help/grade/aggregation.html @@ -12,51 +12,67 @@ the gradebook administrator. Caution in interpreting these "empty grades" is thu - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - + +
StrategyDescriptionStrategyDescriptionExample (A1..A3 assignment grades)
Mean of grades All grades summed and divided by the total number of grades.A1 70/100, A2 20/80, A3 10/10, category max 100:
+ (0.7 + 0.25 + 1.0)/3 = 0.65 --> 65/100
Weighted meanEach grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence + the importance of each item in the overall mean.A1 70/100 weight 10, A2 20/80 weight 5, A3 + 10/10 weight 3, category max 100:
(0.7*10 + 0.25*5 + 1.0*3)/18 = 0.625 --> 62.5/100
Simple weighted meanThe difference from Weighted mean is that weight is calculated as Maximum grade - Minimum grade + for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.A1 70/100, A2 20/80, A3 10/10, category max 100:
+ (0.7*100 + 0.25*80 + 1.0*10)/190 = 0.526 --> 52.6/100
Mean of grades (with extra credits)Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only + for backward compatibility with old activities. 
Median of grades The median is calculated by counting all the grades and selecting the grade that falls in the middle of that count (or the mean between the two middle grades if there is an even number of grades). The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).A1 70/100, A2 20/80, A3 10/10, category max 100:
+ 0.7 + 0.25 + 1.0 --> 0.25 --> 25/100
Smallest grade The result is the relatively smallest grade. It is usually used in combination with Aggregate only non-empty grades.A1 70/100, A2 20/80, A3 10/10, category max 100:
+ min(0.7 + 0.25 + 1.0) = 0.25 --> 25/100
Highest grade The result is the relatively highest grade.A1 70/100, A2 20/80, A3 10/10, category max 100:
+ max(0.7 + 0.25 + 1.0) = 1.0 --> 100/100
Mode of grades The mode is the grade that occurs the most frequently. It is more often used for non-numerical grades. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).
Weighted meanEach grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence - the importance of each item in the overall mean.
Simple weighted meanThe difference from Weighted mean is that weight is calculated as Maximun grade - Minumum grade - for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.
Mean of grades (with extra credits)Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only - for backward compatibility with old activities. 
Sum of grades The sum of all grade values. Scale grades are ignored. This is the only type that does not convert the grades to percentages internally. The Maximum grade of associated category item is calculated automatically as a sum of maximums from all aggregated items.A1 70/100, A2 20/80, A3 10/10:
+ 70 + 20 + 10 = 100/190
-- 2.39.5