Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Calculated question : adding new math functions

From MoodleDocs

The calculated question type could benefit of the EvalMath module to increase the math functions useable in the Calculated, Simple calculated et Multiple choice calculated question types.

Available functions

Calculated questions can use more than simple arithmetic operators. The following functions are allowed in versions 1.5 and newer. In 2,9 we should continue to support the previous functions unless they can be unsafe. All functions will use either the EvalMath code or a more specific CalculatedEvalMath code. In the following table to be improved as ... there is some ambiguity on columns names (

 # means that the function exists. 
 new means that the function needs to be created in EvalMath or only in  CalculatedEvalMath. (... to be explained more clearly )
  OK  will be used in test column to confirm that this property has been coded and testing code have been added in  2.9
  NO i.e. no more supported in 2,9
Function 1,5+ Eval

Math

Calc coded tested Explanation
abs # # # Absolute value
acos # # # Arc cosine -- output in radians.
acosh # # # Inverse hyperbolic cosine -- output in radians.
asin # # # Arc sine -- output in radians.
asinh # # # Inverse hyperbolic sine.-- output in radians.
atan2 # Arc tangent of two variables -- pass in two values like (y, x), and you'll get the atan(y/x), adjusted to the proper quadrant. (Note: The variables are in the reverse order to atan2(x,y) in Excel) Output is radians.
atan # # # Arc tangent -- output in radians.
atanh # # # Inverse hyperbolic tangent-- output in radians.
bindec # Binary to decimal
ceil # # # Round fractions up
cos # # # Cosine -- in radians!!! Convert your degree measurement to radians before you take the cos of it.
cosh # # # Hyperbolic cosine -- in radians!!! Convert your degree measurement to radians before you take the cosh of it.
decbin # Decimal to binary
decoct # new Decimal to octal
deg2rad # new Converts the number in degrees to the radian equivalent
exp # # # Calculates the exponent of e
expm1 new Returns exp(number) - 1, computed in a way that is accurate even when the value of number is close to zero
floor # # # Round fractions down
fmod new Returns the floating-point modulus of two numbers - i.e. the remainder when the first is divided by the second.
is_finite # new Finds whether a value is a legal finite number
is_infinite # ?? Finds whether a value is infinite
is_nan # ?? Finds whether a value is not a number
log10 # new Base-10 logarithm
log1p # new Returns log(1 + number), computed in a way that is accurate even when the value of number is close to zero
log # # #
Natural logarithm (ln) # # #
max # # # Find highest value
min # # # Find lowest value
octdec # new Octal to decimal
pi() # # # Get value of pi - the function does not take an argument, like in Excel.
pow (numberToRaise, NumberRaisedTo) # new
power (numberToRaise, NumberRaisedTo) # new Exponential expression
rad2deg # Converts the radian number to the equivalent number in degrees
rand # new Generate a random integer
rand_int # Generate a random integer
rand_float # Generate a random float
round # # # Rounds a float
sin # # # Sine -- in radians!!! Convert your degree measurement to radians before you take the sin of it.
sinh # # # Hyperbolic sine -- in radians!!! Convert your degree measurement to radians before you take the sinh of it.
sqrt # # # Square root
tan # # # Tangent -- in radians!!! Convert your degree measurement to radians before you take the tan of it.
tanh # # # Hyperbolic tangent -- in radians!!! Convert your degree measurement to radians before you take the tanh of it.

to be completed --Pierre Pichet (talk) 12:12, 12 December 2014 (AWST)