Calculation Specification

Purpose

Assesses the student's ability to carry out a simple calculation.  The parameters of the calculation  can be set to vary each time the question is viewed, allowing for randomisation between reuses of the question.

The question's lead-in allows for placeholders for the parameters, so the text of the lead-in is accurate.  

Pre-Exam

Calculation questions support the standard preamble and postamble for Rogo questions, except that the Marking Method is fixed at 'allow partial marks'.  

Calculation questions use placeholders variables to display parameters.  They denote these variables using the symbols $A, $B, $C etc.  The variables can then be used in various prompt fields in the question.

Take as an example the calculation of response rate to a survey.  800 questionnaires have been sent out and between 200 and 600 have been returned.  The precise number returned is randomly calculated.

The lead-in for this question use variables to compose the text:

 

Variables

This section allows the setter to specify the variables used in the calculation.  In this case $A represents the total number of questionnaires sent out, which is fixed, and $B indicates the random response rate:

 

Each variable must have several parameters specified:

  • Min, Max:  Limits on what value the variable can take
    • The Min and Max can be specified as parameters.  for instance, if you wanted to vary the number of questionnaires sent out, then you could use the actual variable as an upper limit of the range:

:

 

    • Both these values can be linked answers from previous calculation questions, allowing setters to link questions together. Click on the Variable Link icon  to do this.  You can select any variable used in any question, or even the answer that the student gave.
      If Min = Max, then the variable is essentially fixed and behaves as a reusable constant 
    • Decimals:  governs to how many places the value is displayed.  The default is 0 (i.e. the variable behaves as an integer)
    • Increment: a decimal value indicating how granular the random variation is between Min and Max.  This is mandatory.  Set to 0 if the variable is fixed.

Additional variables can be added by clicking Add More Options...  

Other use of Variables

Variables may be used in the Notes, Scenario and General Feedback section of the question.

Answer

This specifies the calculation that gives the correct answer.  Rogo will perform this calculation and compare the student answer with it.  It will then award marks accordingly.

In this case, Rogo is using a built-in function round to round-off the answer to one decimal place.  The student will therefore be expected to supply an answer to that accuracy. (See the section below on Tolerance for how answers are converted to marks).  

Formulae should be be entered using Excel-type notation.  You may also show the units for the answer.

Add More Answers

This button allows the setter to add 'alternative' answers, especially when they may be expressed using different units.  For instance, if one was seeking a probability, one could either express that as a percentage or as a value between 0 and 1.  Adding another answer allows the student to express it in the most natural form to them.  It will only check answers against formulae that have been specified for the units that the student chooses.:  all other formulae are ignored, so it is important to enter them correctly.

Display units for question

If this is unchecked, then the student has to supply units as part of their answer (this is marked).  If checked, units are displayed in a dropdown and the student simply choose the units.

Functions

Rogo supports the following built in functions:

Function
Description
abs([x])Absolute value
acos([x])Arc cosine
acosh([x])Inverse hyperbolic cosine
asin([x])Arc sine
asinh([x])Inverse hyperbolic sine
atan2([y],[x])Arc tangent of two variables
atan([x])Arc tangent
atanh([x])Inverse hyperbolic tangent
ceil([x])Round fractions up
cos([x])Cosine
cosh([x])Hyperbolic cosine
deg2rad([x])Converts the number in degrees to the radian equivalent
exp([x])Calculates the exponent of e (the Neperian or Natural logarithm base)
expm1([x])Returns exp(number) - 1, computed in a way that is accurate even when the value of number is close to zero
floor([x])Round fractions down
fmod([x],[y])Returns the floating point remainder (modulo) of the division of the arguments
log10([x])Base-10 logarithm
log1p([x])Returns log(1 + number), computed in a way that is accurate even when the value of number is close to zero
log([x],[base])logarithm (the [base] parameter is optional defaults to 'e' and so to the natural logarithm if not provided)
max([x],[y],...)Find highest value
min([x],[y],...)Find lowest value
pi()Get value of pi
pow([x],[exp])Exponential expression
round([x],[decimals])Rounds a float to [decimals] number of places
sin([x])Sine
sinh([x])Hyperbolic sine
sqrt([x])Square root
tan([x])Tangent
tanh([x])Hyperbolic tangent

Tolerance and Precision

These govern how close the answer has to be to the calculated answer to get marks. 

The Tolerance has two components.  

  • Tolerance for Full marks specifies how close the answer has to be to the actual answer to get the full marks
  • Tolerance for Partial Marks:  if Use Partial Marking is specified, then answers within this tolerance with gain the partial marks.  This tolerance should be higher than the Tolerance for Full Marks

Precision governs exactly what the student can submit as an answer. This will be displayed on the screen as a prompt to the student and Rogo will not accept an answer that is not specified to this precision.  Precision should be equal to or smaller than the tolerance for full marks, otherwise one could be forced to submit too imprecise an answer to qualify for any marks.

Completing the Question

The student sees the question as follows:

 

The lead in contains the values of the variables $A (800)and $B (318).  The answer box shows the units that the student is expected to provide the answer in.

The student will be expected to enter an answer to the stipulated precision.  

Marking

Marks are only awarded if the student's answer is within tolerance of Rogo's calculated answer.  In this case, the student gets 2 marks if within the tolerance for full marks, 1 mark of with the tolerance for partial marks, and zero otherwise: