Difference between revisions of "NumericalTolerance"

From WeBWorK_wiki
Jump to navigation Jump to search
m (1 revision: import all default namespace pages from old wiki)
m (Fix some formatting)
Line 13: Line 13:
 
<table cellspacing="0" cellpadding="2" border="0">
 
<table cellspacing="0" cellpadding="2" border="0">
 
<tr valign="top">
 
<tr valign="top">
<th> PG problem file </th>
+
<th>PG problem file</th>
<th> Explanation </th>
+
<th>Explanation</th>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
<tr valign="top">
 
<tr valign="top">
 
<td style="background-color:#ffffdd;border:black 1px dashed;">
 
<td style="background-color:#ffffdd;border:black 1px dashed;">
Line 21: Line 24:
 
Context("Numeric");
 
Context("Numeric");
 
Context()-&gt;flags-&gt;set(
 
Context()-&gt;flags-&gt;set(
tolerance=&gt;0.0001,
+
tolerance =&gt; 0.0001,
tolType=&gt;"absolute"
+
tolType =&gt; "absolute",
 
);
 
);
   
$ans = Compute("1.5708");
+
$ans = Compute(1.5708);
 
</pre>
 
</pre>
 
</td>
 
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#ffffcc;padding:7px;">
 
<td style="background-color:#ffffcc;padding:7px;">
 
<p>
 
<p>
Line 39: Line 43:
 
</p>
 
</p>
 
<pre>
 
<pre>
$ans = Compute("1.5708")-&gt;with(
+
$ans = Compute(1.5708)-&gt;with(
tolType=&gt;'absolute',
+
tolType =&gt; 'absolute',
tolerance=&gt;'.0001'
+
tolerance =&gt; .0001,
 
);
 
);
 
</pre>
 
</pre>
 
</td>
 
</td>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
<tr valign="top">
 
<tr valign="top">
 
<td style="background-color:#ffdddd;border:black 1px dashed;">
 
<td style="background-color:#ffdddd;border:black 1px dashed;">
Line 56: Line 63:
 
END_TEXT
 
END_TEXT
 
</pre>
 
</pre>
  +
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#ffcccc;padding:7px;">
 
<td style="background-color:#ffcccc;padding:7px;">
 
<p>
 
<p>
Line 62: Line 71:
 
</td>
 
</td>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
<tr valign="top">
 
<tr valign="top">
 
<td style="background-color:#eeddff;border:black 1px dashed;">
 
<td style="background-color:#eeddff;border:black 1px dashed;">
Line 67: Line 79:
 
ANS( $ans->cmp() );
 
ANS( $ans->cmp() );
 
</pre>
 
</pre>
  +
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#eeccff;padding:7px;">
 
<td style="background-color:#eeccff;padding:7px;">
 
<p>
 
<p>
 
And we check the answer as we expect. Alternatively, it is possible to specify the tolerance parameters as arguments to <code>cmp()</code> as follows. In this case it is not necessary to specify the tolerance in the Context or when defining the MathObject.
 
And we check the answer as we expect. Alternatively, it is possible to specify the tolerance parameters as arguments to <code>cmp()</code> as follows. In this case it is not necessary to specify the tolerance in the Context or when defining the MathObject.
 
<pre>
 
<pre>
ANS( $ans->cmp(tolType=&gt;'absolute',
+
ANS($ans->cmp(
tolerance=&gt;.0001) );
+
tolType =&gt; 'absolute',
  +
tolerance =&gt; .0001,
  +
));
 
</pre>
 
</pre>
 
</p>
 
</p>
 
</td>
 
</td>
 
</tr>
 
</tr>
</table>
 
   
  +
<!--===============================-->
  +
  +
</table>
 
<p>
 
<p>
 
With old-style answer evaluators:
 
With old-style answer evaluators:
Line 85: Line 101:
 
<table cellspacing="0" cellpadding="2" border="0">
 
<table cellspacing="0" cellpadding="2" border="0">
 
<tr valign="top">
 
<tr valign="top">
<th> PG problem file </th>
+
<th>PG problem file</th>
<th> Explanation </th>
+
<th>Explanation</th>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
<tr valign="top">
 
<tr valign="top">
 
<td style="background-color:#ffffdd;border:black 1px dashed;">
 
<td style="background-color:#ffffdd;border:black 1px dashed;">
Line 94: Line 113:
 
</pre>
 
</pre>
 
</td>
 
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#ffffcc;padding:7px;">
 
<td style="background-color:#ffffcc;padding:7px;">
 
<p>
 
<p>
Line 99: Line 119:
 
</p>
 
</p>
 
</td>
 
</td>
  +
  +
<!--===============================-->
  +
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 110: Line 133:
 
END_TEXT
 
END_TEXT
 
</pre>
 
</pre>
  +
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#ffcccc;padding:7px;">
 
<td style="background-color:#ffcccc;padding:7px;">
 
<p>
 
<p>
Line 116: Line 141:
 
</td>
 
</td>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
<tr valign="top">
 
<tr valign="top">
 
<td style="background-color:#eeddff;border:black 1px dashed;">
 
<td style="background-color:#eeddff;border:black 1px dashed;">
 
<pre>
 
<pre>
ANS( num_cmp( $ans, tol=&gt;0.0001,
+
ANS(num_cmp($ans,
tolType=&gt;"absolute" );
+
tol =&gt; 0.0001,
  +
tolType =&gt; "absolute",
  +
));
 
</pre>
 
</pre>
  +
</td>
  +
<!------------------------------------------->
 
<td style="background-color:#eeccff;padding:7px;">
 
<td style="background-color:#eeccff;padding:7px;">
 
<p>
 
<p>
Line 128: Line 158:
 
</td>
 
</td>
 
</tr>
 
</tr>
  +
  +
<!--===============================-->
  +
 
</table>
 
</table>
  +
 
<p style="text-align:center;">
 
<p style="text-align:center;">
 
[[IndexOfProblemTechniques|Problem Techniques Index]]
 
[[IndexOfProblemTechniques|Problem Techniques Index]]

Revision as of 20:47, 20 July 2012

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