|
From: <mo...@us...> - 2003-10-13 21:17:40
|
Update of /cvsroot/aimmath/AIM/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv7927
Modified Files:
AuthoringPackages.html AuthoringTtH.html AuthoringTtH.tex
Log Message:
updated documentation
Index: AuthoringPackages.html
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/AuthoringPackages.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** AuthoringPackages.html 29 Sep 2003 21:13:19 -0000 1.3
--- AuthoringPackages.html 13 Oct 2003 21:17:34 -0000 1.4
***************
*** 34,43 ****
<li><a href="aim/Number.html"><b>Number</b></a> - utilities for dealing with the representations of integers (Roman
numerals, converting numbers to words, etc)</li>
! <li><a href="Random.html"><b>Random</b></a> - This package defines some utility functions for generating random questions. The Rand() command is an all purpose recursive random-thing-maker.</li>
! <li><b>Keys()</b> - an authoring utility that makes it easy to generate quiz question
! selector functions</li>
<li><b>Nice</b> - `Nice/Monomial`(), `Nice/Binomial`(), `Nice/Trinomial`() are
utilities that produce "nice" monomials, binomials, and
trinomials similar to those usually found in textbook questions.</li>
</ul>
</BODY>
--- 34,46 ----
<li><a href="aim/Number.html"><b>Number</b></a> - utilities for dealing with the representations of integers (Roman
numerals, converting numbers to words, etc)</li>
! <li><a href="Random.html"><b>Random</b></a> - defines some utility functions for generating random questions. The Rand() command is an all purpose recursive random-thing-maker.</li>
! <li><a href="aim/AnswerHints.html"><b>AnswerHints</b></a> - This package
! defines utilities useful for detecting common mathematical errors in
! students' answers</li>
<li><b>Nice</b> - `Nice/Monomial`(), `Nice/Binomial`(), `Nice/Trinomial`() are
utilities that produce "nice" monomials, binomials, and
trinomials similar to those usually found in textbook questions.</li>
+ <li><b>Keys()</b> - an authoring utility that makes it easy to generate quiz question
+ selector functions</li>
</ul>
</BODY>
Index: AuthoringTtH.html
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/AuthoringTtH.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** AuthoringTtH.html 27 Sep 2003 20:47:23 -0000 1.1
--- AuthoringTtH.html 13 Oct 2003 21:17:34 -0000 1.2
***************
*** 1,6 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
<html>
! <meta name="GENERATOR" content="TtH 3.40">
<style type="text/css"> div.p { margin-top: 7pt;}</style>
<style type="text/css"><!--
--- 1,6 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
! "http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
[...1015 lines suppressed...]
!
! <div class="p"><!----></div>
! <HR NOSHADE SIZE=1></blockquote>
!
! <div class="p"><!----></div>
! <h2><a name="tth_sEc7">
! 7</a> Question Selector Utilities</h2>
<div class="p"><!----></div>
***************
*** 2603,2606 ****
by <a href="http://hutchinson.belmont.ma.us/tth/">
T<sub><font size="-1">T</font></sub>H</a>,
! version 3.40.<br />On 27 Sep 2003, 16:34.</small>
</html>
--- 2705,2708 ----
by <a href="http://hutchinson.belmont.ma.us/tth/">
T<sub><font size="-1">T</font></sub>H</a>,
! version 3.30.<br />On 12 Oct 2003, 20:58.</small>
</html>
Index: AuthoringTtH.tex
===================================================================
RCS file: /cvsroot/aimmath/AIM/doc/AuthoringTtH.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** AuthoringTtH.tex 27 Sep 2003 20:47:23 -0000 1.1
--- AuthoringTtH.tex 13 Oct 2003 21:17:34 -0000 1.2
***************
*** 1038,1042 ****
\code{vector([Rand(x}$_{\code{1}}$%
\code{),...,Rand(x}$_{\code{k}}$%
! \code{)])} is returned.
\begin{Ex}
--- 1038,1052 ----
\code{vector([Rand(x}$_{\code{1}}$%
\code{),...,Rand(x}$_{\code{k}}$%
! \code{)])} is returned. Similarly \code{ListVec(x}$_{%
! \code{1}}$\code{,...,x}$_{%
! \code{k}}$\code{)} returns the Maple list
! \code{[Rand(x}$_{\code{1}}$%
! \code{),...,Rand(x}$_{\code{k}}$%
! \code{)]} and \code{SeqVec(x}$_{%
! \code{1}}$\code{,...,x}$_{%
! \code{k}}$\code{)} returns the Maple sequence
! \code{Rand(x}$_{\code{1}}$%
! \code{),...,Rand(x}$_{\code{k}}$%
! \code{)}.
\begin{Ex}
***************
*** 1882,1885 ****
--- 1892,1957 ----
number $x$. Thus the student can enter any string that correctly represents
the decimal representation of the fraction $x$ and receive full credit.
+
+ \section{The AnswerHints Package}
+
+ AiM provides automatic feedback to students for common syntax errors in their
+ answer. However the question author might also like to provide feedback
+ on common mathematical errors in syntactically correct student answers.
+ The \code{AnswerHints} package contains functions that check for common
+ mathematical errors in a student's answer. This package currently contains only
+ one routine, but it is hoped that the number of utilities provided will increase
+ in the future.
+
+ \subsection{Checking for sign errors}
+
+ The call \code{`Hints/CheckSigns`(ans,rightans)} returns true if it can
+ determine if \code{ans} differs from the \code{rightans} only by having the
+ wrong signs in zero or more subexpressions. Note that this routine will also
+ return true if \code{ans} is equal to \code{rightans}. This is usually not a
+ problem, however, since the most obvious way to use such a utility is to call
+ it in the solution proc after it has already been determined (perhaps by more
+ sophisticated methods) that the answer is incorrect, as in the following
+ example.
+
+ \begin{Example}
+ We are feeling generous today, so let's give the student a half credit and a
+ hint if their answer differs from the correct answer only by incorrect signs
+ in one or more places.
+
+ \begin{codeblock}
+ \begin{verbatim}
+ l> f,a,x,rightans
+ h> f:=a*exp(a*x-a);
+ rightans:=subs(a=-1,f);
+ t> Simplify $@f@$ if $a=-1$.
+ s> [proc(ans)
+ if `aim/Test`(ans,rightans) then
+ return 1.0
+ elif `Hints/CheckSigns`(ans,rightans) then
+ `aim/t`("{\\it Check your signs!}");
+ return 0.5
+ else
+ return 0.0
+ fi;
+ end,
+ rightans
+ ]
+ end>
+ \end{verbatim}
+ \end{codeblock}
+
+ This will produce the question:
+
+ \begin{question}
+ Simplify $ae^{ax-a}$ if $a=-1$.
+ \end{question}
+
+ The student will receive half credit and a warning to check their signs for any
+ of the following answers:
+
+ $$-e^{-x-1},-e^{x+1},-e^{x-1},e^{-x+1},e^{-x-1},e^{x+1},e^{x-1}$$
+
+ \end{Example}
+
\section{Question Selector Utilities}
|
