ListAnswers

From WeBWorK_wiki
Revision as of 01:50, 27 November 2010 by Pearson (talk | contribs) (Update documentation links)
Jump to navigation Jump to search

Lists of Answers

This is the PG code to check lists of objects entered into one answer blank as answers to a problem.

For lists of answers entered into multiple answer blanks, please see MultiAnswerProblems

Problem Techniques Index

PG problem file Explanation
DOCUMENT();
loadMacros(
"PGstandard.pl",
"MathObjects.pl"
);
TEXT(beginproblem());

Initialization: Load the macro file MathObjects.pl.

Context("Numeric");

$factors = List(Compute("x+2"),Compute("x+3"));
$roots = List( -3, -2 );

# If there were only one solution
# $roots = List(4);

# If there were no solutions
# $roots = List("NONE");

Setup: We need make no changes or additions to the tagging and description section of the PG file, or to the problem initialization section (unless we need to load some macros for the type of problem that we're creating). In the problem set-up section of the file, we include the definition of the list(s) that we're expecting as an answer.

Note that the argument of the List call are the objects in the list, which can be any MathObjects. Here we create a list of Formulas and a list of Reals (the numbers that we use in the second list will be promoted to Real MathObjects when the List is created).

If, for example, there were no real roots, we should set $roots = List("NONE"); so that students who enter a list of roots will not receive an error message about entering the wrong type of answer. If we were to use $roots = String("NONE"); instead, students who enter anything other than a string (e.g., a list of numbers) will receive an error message.

Similarly, if there were only one root at x=4, we would use $roots = List(4); instead of $roots = Real(4); to avoid sending error messages to students who enter multiple answers or NONE.

Context()->texStrings;
BEGIN_TEXT
What are the factors of \(x^2 + 5 x + 6\)?
$BR
Factors = \{ ans_rule(25) \}
$BR
${BITALIC}(Enter the factors as a comma-separated
list.)$EITALIC
$PAR
What are the roots of this equation?
$BR
Roots = \{ ans_rule(15) \}
$BR
${BITALIC}(Enter the roots in a comma-separated
list, ${BBOLD}ordered from smallest to 
largest$EBOLD.)$EITALIC
END_TEXT
Context()->normalStrings;

Main text: We ask for the answers as we'd expect. It's generally a good idea to make sure that it's clear what we expect students to enter (in this case, a comma-separated list). To point out the obvious, there's no reason in this case to make only one of the requested lists have a specific order... except that it lets us see how to do it in this example problem.

ANS( $factors->cmp() );
ANS( $roots->cmp(ordered=>1) );

ENDDOCUMENT();

Answer Evaluation: We can just check the answers against the correct List answers. To force the students' list answers to match the order of the correct answer, we include the ordered=>1 flag in the cmp() call. The default is ordered=>0 for unordered answers.

Other commonly used options include showHints=>1, showLengthHints=>1, partialCredit=>1 as arguments to the cmp() call. For all options, see the entries for "MathObjects-based Answer Checkers" and "Flags for Union()->cmp and List()->cmp" on MathObjectsAnswerCheckers.html

Problem Techniques Index