Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Grade calculations.

Grade calculations

From MoodleDocs
Revision as of 10:58, 22 January 2008 by Helen Foster (talk | contribs) (→‎Making your Calculation: image resizing)

Enabling Calculations

To enable calculations for you gradebook:

  1. Login as teacher or other user with permission to edit grades.
  2. Go to course.
  3. Click on Grades in the Administration block.
  4. Click the "Turn Editing On" button on the top right corner.
  5. Click the "Show Calculations" icon on the middle top.
  6. Click the little calculator symbol under Course Total column which will bring you to the calculations page.
"Show Calculations" Icon
Little Calculator Symbol

Assigning ID Numbers

ID numbers are similar to nicknames for each grade item. In a calculation, instead of referring back to a whole assignment name, we can substitute it for it's ID number which becomes a lot easier. Think of it as substituting 143 as X and then using X for various math problems.

ID numbers on the bottom of the page. Use simple to remember numbers or variables like 1, X, or Quiz1. Remember to click "Add id numbers"!

Understanding Calculation Functions

Click the yellow question mark next to the word "Calculation". This will bring a pop-up explaining the various functions that can be used in calculations and how to use them.

Every calculation must start with an equal sign (=). Following is a list of the functions supported by the calculation. The comma (,) character is used to separate arguments within function brackets. The comma can also be used to separate different functions.

  • average([[item1]], [[item2]]...): Returns the average of a sample
  • max([[item1]], [[item2]]...): Returns the maximum value in a list of arguments
  • min([[item1]], [[item2]]...): Returns the minimum value in a list of arguments
  • mod(dividend, divisor): Calculates the remainder of a division
  • pi(): Returns the value of the number Pi
  • power(base, power): Raises a number to the power of another
  • round(number, count): Rounds a number to a predefined accuracy
  • sum([[item1]], [[item2]]...): Returns the sum of all arguments

A number of mathematical functions is also supported:

  • sin
  • sinh
  • arcsin
  • asin
  • arcsinh
  • asinh
  • cos
  • cosh
  • arccos
  • acos
  • arccosh
  • acosh
  • tan
  • tanh
  • arctan
  • atan
  • arctanh
  • atanh
  • sqrt
  • abs
  • ln
  • log
  • exp

Making your Calculation

Example calculation

Back on the calculations page, start typing the various functions and the ID numbers chosen for your calculation.

  1. Start with an equal sign (=)
  2. Choose a function; Example: =sum()
  3. Plug in your ID numbers enclosed in 2 hard brackets; Example: =sum([[item1]][[item2]][[item3]])
  4. Separate each ID number with a comma; Example: =sum([[item1]],[[item2]],[[item3]])
  5. Click the "Save Changes" button.

See also