NumericalTolerance

From WeBWorK_wiki
Revision as of 15:19, 14 May 2010 by Aubreyja (talk | contribs) (1 revision: import all default namespace pages from old wiki)
Jump to navigation Jump to search

Numerical Tolerance in Problems: PG Code Snippet

This code snippet shows the essential PG code to specify a numerical tolerance for student answers to a problem. Note that these are insertions, not a complete PG file. This code will have to be incorporated into the problem file on which you are working.

We can control the numerical tolerance expected of the student with MathObjects, or with old-style answer evaluators. Using MathObjects we can control tolerance by setting a "global" tolerance in the Context, as shown in the example below, or by specifying the tolerance that is used for specific MathObjects, as is indicated in the comments to the right. An example with the old-style evaluators appears below the MathObjects examples.

Problem Techniques Index

PG problem file Explanation
Context("Numeric");
Context()->flags->set(
  tolerance=>0.0001,
  tolType=>"absolute"
);

$ans = Compute("1.5708");

We need no changes to the tagging and description or initialization sections of the file. In the set-up section, we specify the tolerance flags in the Context. The tolType can be absolute (specifying a decimal distance from the correct answer that will be allowed) or relative (specifying a percent error that will be allowed).

Thus if the correct answer is 17, a tolerance of 0.01 will mean that the student answer must be in the interval (16.99,17.01) if the tolType is absolute, and in the interval (16.83,17.17) if tolType is relative (or omitted, as relative tolerance is the default).

Note that it is also possible to specify the tolerance for the evaluation in the definition of the answer, thereby setting the tolerance only for comparisons using that object. This is done by omitting the Context()->flags code and defining $ans with the following:

$ans = Compute("1.5708")->with(
  tolType=>'absolute',
  tolerance=>'.0001'
);
BEGIN_TEXT
Enter \(\frac{\pi}{2}\): \{ans_rule(8)\}
$BR
${BITALIC}(Enter your answer accurate to four 
decimal places.)$EITALIC
END_TEXT

The text section of the file is the same as usual.

ANS( $ans->cmp() );

And we check the answer as we expect. Alternatively, it is possible to specify the tolerance parameters as arguments to cmp() as follows. In this case it is not necessary to specify the tolerance in the Context or when defining the MathObject.

ANS( $ans->cmp(tolType=>'absolute',
               tolerance=>.0001) );

With old-style answer evaluators:

PG problem file Explanation
  $ans = "1.5708";

We need no changes to the tagging and description or initialization sections of the file. In the set-up section, we can specify the value that we're checking against.

  BEGIN_TEXT
  Enter \(\frac{\pi}{2}\): \{ans_rule(8)\}
  $BR
  ${BITALIC}(Enter your answer accurate to four 
  decimal places.)$EITALIC
  END_TEXT

The text section of the file is the same as usual.

  ANS( num_cmp( $ans, tol=>0.0001, 
  tolType=>"absolute" );

And we check the answer, specifying the tolerances we intend in the answer evaluator. The tol and tolType flags behave the same as in the MathObjects version of the problem.

Problem Techniques Index