The simplest form of a quiz takes two arguments—the question and the answer.

$\mathrm{Quiz}\left(''What\; is\; 1\; +\; 1?''\, 2 \right)\;$

Because the above question is not algorithmic—given the input, there is no way to regenerate this and arrive at a different question—there is no way to practice variations of the same question.  The Algorithmic Questions section below demonstrates questions designed random variables that include a Try Another button.

The following example shows a different way of capturing the answer, rather than a generic input area, the response is to select a check box.

$\mathrm{Quiz}\left(''Is\; 1\; +\; 1\; =\; 2?''\, \mathrm{true}\, \'\mathrm{style}\'\=\mathrm{truefalse} \right)\;$

Another style of question, multiplechoice requires an initial value to define the choices.  Note that the default is for those choices to appear in a scrambled order.   The grade value '3' refers to the third item in the list, denoting the index of the correct answer in the choice list.

$\mathrm{Quiz}\left(''What\; is\; 1\; +\; 1?''\, 3\, \left[0\,1\,2\,3\,4\right]\, \'\mathrm{style}\'\=\'\mathrm{multiplechoice}\' \right)\;$

Other question types can also be given an initial value, which can simplify the formatting of math expressions.  $$

$\mathrm{Quiz}\left(''Calculate:''\, -\cos \left(x\right)\, \mathrm{Int}\left(\sin \left(x\right)\,x\right) \right)\;$

Plots can be used as initial values.

$$\begin{gathered} \mathrm{Quiz}\left(''Which\; of\; the\; following\; could\; be\; portions\; of\; the\; plot\; of\; sin(x)?''\, \left\{1\,2\right\}\, \\ \left[\mathrm{plot}\left(\sin \left(x\right)\,x\=0..\mathrm{rand}\left(2..3\right)\left(\right)\right)\, \\ \mathrm{plot}\left(\sin \left(x\right)\,x\=\mathrm{rand}\left(2..3\right)\left(\right)..5\right)\, \\ \mathrm{plot}\left(2\cdot \sin \left(x\right)\,x\=\mathrm{rand}\left(2..3\right)\left(\right)..\mathrm{rand}\left(4..7\right)\left(\right)\right)\right]\, \\ \mathrm{style}\=\mathrm{multipleselect}\, \\ \mathrm{gradebyindex}\=\mathrm{true}\, \\ \mathrm{size}\=\left[250\,150\right]\right)\; \end{gathered}$$

Algorithmic questions incorporate randomization so that a single source can generate an unlimited number of tests on the same topic.  

To generate an algorithmic quiz, you need to supply an initialization procedure.

$\mathrm{Quiz}\left(''Is\; the\; following\; number\; prime?''\, \mathrm{true}\, \mathbf{proc}\left(\right) \mathrm{nextprime}\left(\mathrm{rand}\left(2..20\right)\left(\right)\right) \mathbf{end}\, \'\mathrm{style}\'\=\mathrm{truefalse} \right)\;$

Note that when generating an algorithmic quiz, a Try Another button appears.  Clicking this button causes the question to be reinitialized, thus presenting a new variation of the question.

The initialization procedure will be passed all extra arguments given to the Quiz command.  Below we will add the parameter, r, to the initialization routine.  Calling Quiz with the extra argument, 100, will pass this along to the initializer, resulting in a different random number sequence.

$\mathrm{Quiz}\left(''Is\; the\; following\; number\; prime?''\, \mathrm{true}\, \mathbf{proc}\left(r\right) \mathrm{nextprime}\left(\mathrm{rand}\left(r..r\+20\right)\left(\right)\right) \mathbf{end}\, \'\mathrm{style}\'\=\mathrm{truefalse}\, 100 \right)\;$

This repeats the same command above, only changing the extra argument.

$\mathrm{Quiz}\left(''Is\; the\; following\; number\; prime?''\, \mathrm{true}\, \mathbf{proc}\left(r\right) \mathrm{nextprime}\left(\mathrm{rand}\left(r..r\+20\right)\left(\right)\right) \mathbf{end}\, \'\mathrm{style}\'\=\mathrm{truefalse}\, 1000 \right)\;$

So far, the second parameter has been a fixed result.  For math-response questions, a procedure can be passed to grade the result.  The procedure accepts the following parameters:

$$\begin{gathered} \mathrm{Quiz}\left( ''Factor\; the\; expression\; completely:''\, \\ \mathbf{proc}\left(\mathrm{Resp}\, \mathrm{Ans}\right) \mathrm{evalb}\left(\mathrm{factor}\left(\mathrm{Ans}\right) \= \mathrm{Resp}\right) \mathbf{end}\, \\ \mathbf{proc}\left(\right) \mathbf{local} r ≔ \mathrm{rand}\left(1..3\right)\left(\right)\; \mathrm{expand}\left( r\left(\right)\cdot x \cdot \left(r\left(\right)\cdot x\+r\left(\right)\right) \cdot \left(r\left(\right)\cdot x\+r\left(\right)\right) \right)\; \mathbf{end} \right)\; \end{gathered}$$

When using a grading procedure to check the solution to a multiple-choice question, note that the default is to test against the index of the pre-scrambled choice.  Here the grading code compares against indices {1,4} as the correct solution.

$$\begin{gathered} \mathrm{Quiz}\left(''Pick\; 0\; and\; 3:''\, \\ \left(r\right)\to \mathrm{evalb}\left( r \= \left\{1\,4\right\}\right)\, \\ \left[\mathrm{C0}\,\mathrm{C1}\, \mathrm{C2}\, \mathrm{C3}\, \mathrm{C4}\right]\, \'\mathrm{style}\' \= \'\mathrm{multipleselect}\'\right) \end{gathered}$$

When the 'gradebyindex' option is set to false, the values of the choices will be given as the response variable.  

$$\begin{gathered} \mathrm{Quiz}\left(''Pick\; 0\; and\; 3:''\, \\ \left(r\right)\to \mathrm{evalb}\left( r \= \left\{\mathrm{C0}\,\mathrm{C3}\right\}\right)\, \\ \left[\mathrm{C0}\,\mathrm{C1}\, \mathrm{C2}\, \mathrm{C3}\, \mathrm{C4}\right]\, \'\mathrm{style}\' \= \'\mathrm{multipleselect}\'\, \mathrm{gradebyindex}\=\mathrm{false}\right) \end{gathered}$$

Random values can be inserted in the question text by naming variables with a $ prefix and placing them in the question text.  

$$\begin{gathered} \mathrm{Quiz}\left(''Is\; \$P\; prime?''\, \\ \mathrm{true}\, \\ \mathbf{proc}\left( \right) \mathrm{Quiz}:-\mathrm{Set}\left( \= \mathrm{nextprime}\left(\mathrm{rand}\left(2..20\right)\left(\right)\right) \right)\; \mathbf{end}\, \\ \'\mathrm{style}\' \= \mathrm{truefalse} \right)\; \end{gathered}$$

A better version of this isprime question would give both prime and non-prime values.  In this case we need an algorithm to check the result.   Here are two ways to implement such a question:

1. This variation uses a procedure to generate and return the initial value.   That initial value is passed as the second argument to the grading procedure, which does the comparison and returns true for a correct result and false for an incorrect result.

$$\begin{gathered} \mathrm{Quiz}\left(''Is\; the\; following\; number\; prime?''\, \\ \left(\mathrm{response}\,\mathrm{initval}\right)\to \mathrm{evalb}\left( \mathrm{response} \= \mathrm{isprime}\left(\mathrm{initval}\right) \right)\, \\ \left(\right) \to \mathrm{rand}\left(2..20\right)\left(\right)\, \\ \'\mathrm{style}\' \= \mathrm{truefalse}\right)\; \end{gathered}$$

2. In this variation, we replace $P with the generated number.   Because the initial-value generator returns NULL, our grading procedure will receive NULL as the second argument, so we have to fetch it using Quiz:-Get in order to do the comparison.

$$\begin{gathered} \mathrm{Quiz}\left(''Is\; \$P\; prime?''\, \\ \left(\mathrm{response}\right)\to \mathrm{response} \= \mathrm{isprime}\left(\mathrm{Quiz}:-\mathrm{Get}\left(\right)\right)\, \\ \mathbf{proc}\left(\right) \mathrm{Quiz}:-\mathrm{Set}\left( \= \mathrm{rand}\left(2 .. 20\right)\left(\right)\right)\; \mathbf{end} \mathbf{proc}\, \\ \'\mathrm{style}\' \= \mathrm{truefalse}\right)\; \end{gathered}$$

The Quiz:-Get command can be used to query the variable, and Quiz:-Set will set the value.   The variable named in calls to Set should be prefixed with a $ to match the question text.  The question text may reference $A or ${A}, but the Set and Get commands should always reference the form without curly brackets, as $A.  Also, since $ is a special character in Maple, references to $ names in SetVar and GetVar must be enclosed in left single quotes (see "name").

$$\begin{gathered} \mathrm{Quiz}\left(''Which\; is\; a\; plot\; of\; \$\{FUNC\}?''\, 1\, \\ \mathbf{proc}\left(\right) \\ \mathbf{local} A ≔ \left[\sin \left(x\right)\,\cos \left(x\right)\,\tan \left(x\right)\right]\left[\mathrm{rand}\left(1..3\right)\left(\right)\right]\; \\ \mathrm{Quiz}:-\mathrm{Set}\left(\=A\right)\; \\ \left[\mathrm{plot}\left(A\right)\,\mathrm{plot}\left(-A\right)\,\mathrm{plot}\left(\mathrm{\π}\*A\,x\=-2\*\mathrm{\π}..2\*\mathrm{\π}\right)\right]\: \\ \mathbf{end}\, \\ \mathrm{style}\=\mathrm{multiplechoice}\, \\ \mathrm{plotsize}\=\left[250\,150\right]\right)\; \end{gathered}$$

The special variable, `$RESPONSE`, is automatically set to the value entered by the user.  By using `$RESPONSE` in conjunction with other pre-defined variables, the grading procedure can be written to take no arguments, as is the situation for writing a grading procedure within Maple T.A.

$$\begin{gathered} \mathrm{Quiz}\left( \\ ''There\; are\; \$\{A\}\; balls\; of\; different\; colors\; in\; a\; sack.\; How\; many\; distinct\; combinations\; of\; \$\{B\}\; balls\; can\; you\; remove\; from\; the\; sack?''\, \\ \mathbf{proc}\left(\right) \\ \mathbf{uses} \mathrm{Grading}:-\mathrm{Quiz}\; \\ \mathrm{evalb}\left(\mathrm{Get}\left(\mathrm{`\$RESPONSE`}\right)\=\mathrm{binomial}\left(\mathrm{Get}\left(\right)\, \mathrm{Get}\left(\right)\right)\right)\; \\ \mathbf{end}\, \\ \mathbf{proc}\left(\right) \\ \mathbf{uses} \mathrm{MapleTA}:-\mathrm{Builtin}\, \mathrm{Grading}:-\mathrm{Quiz}\; \\ \mathrm{Set}\left(\=\mathrm{range}\left(5\,10\right)\right)\; \\ \mathrm{Set}\left(\=\mathrm{range}\left(1\,4\right)\right)\; \\ 1\; \\ \mathbf{end}\right)\; \end{gathered}$$

For certain fundamental concepts it is necessary to "dumb down" Maple.  Sometimes Maple is too smart, and it will automatically do favors for you, such as collecting terms in a polynomial or adding constants.  The "InertForm" package gives you a way to represent expressions that won't be automatically simplified.  The Quiz command can make use of this inert-form notation for displaying expressions and grading responses.

Inert-form represents the core operators and functions in the following form:

In the following question, we use this notation to prevent reduction of fractions.  We specify the 'inertform' option so that the Quiz command can apply appropriate formatting when displaying the question.

$$\begin{gathered} \mathrm{Grading}:-\mathrm{Quiz}\left(''Which\; fractions\; are\; reduced\; to\; lowest\; terms?''\,1\, \\ \left[ 1\/3\, \mathrm{`\%/`}\left(4\,6\right)\, \mathrm{`\%/`}\left(9\,3\right) \right]\, \\ \mathrm{style}\=\'\mathrm{multipleselect}\'\, \'\mathrm{inertform}\'\=\mathrm{true} \right)\; \end{gathered}$$

This is also relevant to the response being graded in a free-form math question.  

$$\begin{gathered} \mathrm{Grading}:-\mathrm{Quiz}\left(''Reduce\; this\; fraction\; to\; lowest\; terms:''\, \\ \mathbf{proc}\left( \mathrm{resp}\, \mathrm{ans} \right) \\ \mathrm{evalb}\left( \mathrm{resp}\colon\colon \mathrm{specfunc}\left(\mathrm{`\%/`}\right) \\ \mathbf{and} \left[\mathrm{op}\left(\mathrm{resp}\right)\right] \= \left[\mathrm{op}\left(\mathrm{InertForm}:-\mathrm{Value}\left(\mathrm{ans}\right)\right)\right] \right)\; \\ \mathbf{end} \mathbf{proc}\, \\ \mathbf{proc}\left( \right) \\ \mathbf{local} i ≔ \mathrm{rand}\left(2..5\right)\left(\right)\; \\ \mathrm{`\%/`}\left(i\*\mathrm{rand}\left(2..4\right)\left(\right)\,i\*\mathrm{rand}\left(5..7\right)\left(\right)\right)\; \\ \mathbf{end} \mathbf{proc}\, \\ \'\mathrm{inertform}\' \= \mathrm{true} \right)\; \end{gathered}$$

Because the answer is being delivered to the grading procedure in inert form, there is no chance for automatic simplification to happen along the way.  You can't cheat by typing in the given expression and have it auto-simplify behind the scenes.  

The grading code checks to see that the response was a divide form,`%/`, and that the operands of the response match the simplified operands of a reduced fraction equivalent.

Maple T.A. is an easy-to-use web-based system for creating tests and assignments, and automatically assessing student responses and performance.  The "maple-graded" style of question can be imported into Maple and run via the Quiz command.

The MapleTA:-Import command will read a course module zip file and import all of its questions into a Record-based data structure that closely mirrors the XML in the course-module manifest.  A sample structure might look like the following (omitting optional fields):

TAQuestion := Record("name" = "  Quadratic Factor Question  ", "mode" = "Maple", "text" = "    Factor the following algebraic expression x² + ${A}x + ${B}. Your answer should be in the form (x+a)(x+b).  ", "algorithm" = "  $a=rint(1,10);$b=rint(2,10);$A=int($a+$b);$B=int($a*$b);$factor=maple(\"factor(x^2+${A}*x+${B})\"); ", "mapleAnswer" = "    $factor;  ",         "maple" =  "    evalb(($ANSWER)-($RESPONSE)=0);  "  ):

This imported structure is recognized by the Quiz command and it builds the appropriate question in Maple.

$\mathrm{Quiz}\left( \mathrm{TAQuestion} \right)\;$

A course module usually contains multiple questions.

$\mathrm{cmfile} ≔ \mathrm{cat}\left(\mathrm{kernelopts}\left(\mathrm{mapledir}\right)\,''/data/help/MapleTA/coursemodule.zip''\right)\:$

$\mathrm{cmquestions} ≔ \left[ \mathrm{MapleTA}:-\mathrm{Import}\left( \mathrm{cmfile} \right) \right]\:$

$\mathrm{numelems}\left(\mathrm{cmquestions}\right)\;$

$\mathrm{Quiz}\left( \mathrm{cmquestions}\left[1\right] \right)\;$

$\mathrm{Quiz}\left(\mathrm{cmquestions}\left[3\right] \right)\;$

Similarly, all Quiz-based questions can be exported back to Maple T.A.   The Quiz command takes an 'output' = 'mapleta' option that will generate a Record structure as described above.  This Record can then be passed to the MapleTA:-Export command to generate a course module suitable for importing into Maple T.A.

As an example, let's define a question and see how it looks.  

$$\begin{gathered} \mathrm{qinit} ≔ \mathbf{proc}\left(\right) \\ \mathbf{local} p ≔ \mathrm{nextprime}\left( \mathrm{rand}\left(2..7\right)\left(\right) \right)\; \\ \mathrm{Grading}:-\mathrm{Quiz}:-\mathrm{Set}\left( \= p \right)\; \\ \left[ p\*\mathrm{rand}\left(1..2\right)\left(\right) \+ 1\, \\ p\*\mathrm{rand}\left(3..4\right)\left(\right) \+ 1\, \\ p\*\mathrm{rand}\left(1..2\right)\left(\right) \+ 0\, \\ p\*\mathrm{rand}\left(1..2\right)\left(\right) \+ 2\, \\ p\*\mathrm{rand}\left(1..2\right)\left(\right) - 1 \right]\; \\ \mathbf{end}\: \end{gathered}$$

$\mathrm{Grading}:-\mathrm{Quiz}\left(''For\; which\; values\; of\; X\; does\; (\; X\; mod\; \$P)\; =\; 1''\,\left[1\,2\right]\,\mathrm{qinit}\,\mathrm{style}\=\mathrm{multipleselect}\right) \;$

Now, let's use the same question parameters, but specify the 'output' option.  We will also give the question a name so it can be easily identified inside Maple T.A.

$$$$\begin{gathered} Q ≔ \mathrm{Grading}:-\mathrm{Quiz}\left(''For\; which\; values\; of\; X\; does\; (\; X\; mod\; \$P)\; =\; 1''\,\left[1\,2\right]\,\mathrm{qinit}\, \\ \mathrm{style}\=\mathrm{multipleselect}\,\mathrm{output}\=\mathrm{mapleta}\,\mathrm{name}\=''Imported\; MS\; 15\; (mod)''\right) \end{gathered}$$

This can be exported as a course module:

$$\begin{gathered} \mathbf{if} \mathrm{FileTools}:-\mathrm{Exists}\left(''sample.zip''\right) \mathbf{then} \\ \mathrm{FileTools}:-\mathrm{Remove}\left(''sample.zip''\right)\; \\ \mathbf{end} \mathbf{if}\; \end{gathered}$$

$\mathrm{MapleTA}:-\mathrm{Export}\left( Q\, ''sample.zip'' \right)\;$

Grading:-Quiz, Grading:-QuizBuilder, MapleTA:-Export, MapleTA:-Import, Maple T.A. Integration