Diff for /loncom/html/adm/help/tex/adaptive_hints.tex between versions 1.1 and 1.2

version 1.1, 2004/06/09 13:55:21 version 1.2, 2004/09/14 22:00:41
Line 14  String Hint condition Line 14  String Hint condition
 The syntax used to describe the foil(s) and the foil answer(s) differ for the five types:  The syntax used to describe the foil(s) and the foil answer(s) differ for the five types:
 1. Formula Hint condition  1. Formula Hint condition
 The formulahint tag takes three parameters: answer, name, and samples. The "name" is the unique name given to the hint condition. The formula answer for which you wish to provide conditional is included in the answer parameter. The samples parameter includes the points (or range of points) over which sampling of the student's submitted answer and the formula included in the formula hint answer parameter are to be compared. The syntax is the same as used to specify sampling points in the samples parameter of the formula reponse tag itself. The formula submitted by the student is evaluated at the sample points for the hint and the calculated values are compared with the corresponding values determined by evaluating the "hint" answer at the same sampling points. A close correspondence between the two sets of values will trigger the hint action specified in the <hintpart > tag.  The formulahint tag takes three parameters: answer, name, and samples. The "name" is the unique name given to the hint condition. The formula answer for which you wish to provide conditional is included in the answer parameter. The samples parameter includes the points (or range of points) over which sampling of the student's submitted answer and the formula included in the formula hint answer parameter are to be compared. The syntax is the same as used to specify sampling points in the samples parameter of the formula reponse tag itself. The formula submitted by the student is evaluated at the sample points for the hint and the calculated values are compared with the corresponding values determined by evaluating the "hint" answer at the same sampling points. A close correspondence between the two sets of values will trigger the hint action specified in the <hintpart > tag.
   \begin{verbatim}
 <problem >  <problem >
  <script type="loncapa/perl" ># Enter computations here    <script type="loncapa/perl" ># Enter computations here 
  $x1 = random(2,4,1);   $x1 = random(2,4,1);
Line 46  The formulahint tag takes three paramete Line 47  The formulahint tag takes three paramete
   </hintgroup >         </hintgroup >     
  </formularesponse >   </formularesponse >
 </problem >  </problem >
   \end{verbatim}
   
 2. Numerical Response condition  2. Numerical Response condition
 The numericalhint tag takes four parameters: answer, name, unit and format. The "name" is the unique name given to the hint condition. The numerical answer for which you wish to provide conditional is included in the answer parameter. Student submission of that answer in combination with the "unit" parameter in the hint condition will trigger the hint action specified in the <hintpart > tag.  The numericalhint tag takes four parameters: answer, name, unit and format. The "name" is the unique name given to the hint condition. The numerical answer for which you wish to provide conditional is included in the answer parameter. Student submission of that answer in combination with the "unit" parameter in the hint condition will trigger the hint action specified in the <hintpart > tag.
   
   \begin{verbatim}
 <problem > <startouttext />A car travels 10 km in 10 min. What is the speed of the car?<endouttext />  <problem > <startouttext />A car travels 10 km in 10 min. What is the speed of the car?<endouttext />
   <numericalresponse format="1f" unit="km/hr" answer="60">    <numericalresponse format="1f" unit="km/hr" answer="60">
    <responseparam description="Numerical Tolerance" default="2%" type="tolerance" name="tol" />     <responseparam description="Numerical Tolerance" default="2%" type="tolerance" name="tol" />
Line 64  The numericalhint tag takes four paramet Line 67  The numericalhint tag takes four paramet
      </hintgroup >       </hintgroup >
    </numericalresponse >     </numericalresponse >
 </problem >  </problem >
   \end{verbatim}
   
 3. Option Response Hint condition  3. Option Response Hint condition
 There are two types of option response hint conditions: one for standalone foils and one for concept groups. In both cases the option hint tag includes two parameters: answer and name for standalone foils, and concept and name for foils grouped together in a concept group. For the answer parameter, the names and submitted values for each of the foils that are being included in the hint condition are provided in a hash, i.e., in the format: ('Foil1'=>'True','Foil2'=>'False'). In the case of a conditional hint for a concept group, the format of the concept parameter is also a hash that links the name of each concept group included in the hint condition to either 'correct' or 'incorrect' - e.g., <optionhint concept="('buoyancy'=>'correct','density'=>'correct')" name="fluids" / > If 'correct' is specified for a named concept then when the conditional hint is evaluated answers for each of the foils selected by a student must be correct for the hint action to be triggered. If anything other than 'correct' is provided in the concept hash in the optionhint tag then then students answers will be compared with the set answers for the foils in the concept group and as long as at least one answer is incorrect (i.e., the concept group was not correctly answered) then the corresponding hint action will be triggered.  There are two types of option response hint conditions: one for standalone foils and one for concept groups. In both cases the option hint tag includes two parameters: answer and name for standalone foils, and concept and name for foils grouped together in a concept group. For the answer parameter, the names and submitted values for each of the foils that are being included in the hint condition are provided in a hash, i.e., in the format: ('Foil1'=>'True','Foil2'=>'False'). In the case of a conditional hint for a concept group, the format of the concept parameter is also a hash that links the name of each concept group included in the hint condition to either 'correct' or 'incorrect' - e.g., <optionhint concept="('buoyancy'=>'correct','density'=>'correct')" name="fluids" / > If 'correct' is specified for a named concept then when the conditional hint is evaluated answers for each of the foils selected by a student must be correct for the hint action to be triggered. If anything other than 'correct' is provided in the concept hash in the optionhint tag then then students answers will be compared with the set answers for the foils in the concept group and as long as at least one answer is incorrect (i.e., the concept group was not correctly answered) then the corresponding hint action will be triggered.
 (a) optionresponse  (a) optionresponse
   
   \begin{verbatim}
 <problem >  <problem >
  <startouttext />For each of the following rock types, indicate whether or not the rock is a volcanic rock.<endouttext / >   <startouttext />For each of the following rock types, indicate whether or not the rock is a volcanic rock.<endouttext / >
  <optionresponse max="10" randomize="yes" >   <optionresponse max="10" randomize="yes" >
Line 104  textbook.<endouttext / > Line 111  textbook.<endouttext / >
   </hintgroup >    </hintgroup >
  </optionresponse >   </optionresponse >
 </problem >  </problem >
   \end{verbatim}
   
 (b) optionresponse with concept groups  (b) optionresponse with concept groups
   
   \begin{verbatim}
 <problem >  <problem >
  <startouttext />Choose the likely plate boundary type, where you are most likely to encounter each of the following geologic features or phenomena.<endouttext / >   <startouttext />Choose the likely plate boundary type, where you are most likely to encounter each of the following geologic features or phenomena.<endouttext / >
  <optionresponse max="10" randomize="yes" >   <optionresponse max="10" randomize="yes" >
Line 173  textbook.<endouttext / > Line 184  textbook.<endouttext / >
    </hintgroup >     </hintgroup >
  </optionresponse >   </optionresponse >
 </problem >  </problem >
   \end{verbatim}
   
 4. Radiobutton Hint condition  4. Radiobutton Hint condition
   
  The radiobutton hint tag takes two parameters: answer and name.  The name is   The radiobutton hint tag takes two parameters: answer and name.  The name is
 the name of the hint condition, and the answer is an array. The first element of the array will be 'foil'; the remaining elements are the names of the foils that you require to have been checked by the student for the hint to be displayed. For example, if you create a radiobutton response problem with six foils named: granite, gabbro, gneiss, shale, sandstone and schist, and you want your hint named: igneous to be displayed when either granite or basalt had been checked your radiobutton hint would be as follows:  the name of the hint condition, and the answer is an array. The first element of the array will be 'foil'; the remaining elements are the names of the foils that you require to have been checked by the student for the hint to be displayed. For example, if you create a radiobutton response problem with six foils named: granite, gabbro, gneiss, shale, sandstone and schist, and you want your hint named: igneous to be displayed when either granite or basalt had been checked your radiobutton hint would be as follows:
       
   \begin{verbatim}
  <radiobuttonhint answer="('foil','granite','gabbro')"   <radiobuttonhint answer="('foil','granite','gabbro')"
 name="igneous" ></radiobuttonhint >  name="igneous" ></radiobuttonhint >
   In order to trigger display of this hint you also need to create a    In order to trigger display of this hint you also need to create a
Line 186  name="igneous" ></radiobuttonhint > Line 200  name="igneous" ></radiobuttonhint >
   <startouttext />This type of rock is composed of interlocking crystals, a    <startouttext />This type of rock is composed of interlocking crystals, a
 characteristic of igneous rocks.<endouttext / >  characteristic of igneous rocks.<endouttext / >
  </hintpart >   </hintpart >
   \end{verbatim}
   
   The complete radiobutton response would look as follows:    The complete radiobutton response would look as follows:
     
   \begin{verbatim}
 <problem >  <problem >
  <startouttext />   <startouttext />
  Which of the following is a sedimentary rock?   Which of the following is a sedimentary rock?
Line 248  characteristic of foliated metamorphic r Line 265  characteristic of foliated metamorphic r
   </hintgroup >    </hintgroup >
  </radiobuttonresponse >   </radiobuttonresponse >
 </problem >  </problem >
   \end{verbatim}
   
 5. String Hint condition  5. String Hint condition
 The radiobutton hint tag takes two parameters: answer and name. The name is the name of the hint condition, and the answer is a text string. The type parameter allows you to choose between case sensitive, case insensitive, and case insensitive in any order. A simple example is shown below.  The radiobutton hint tag takes two parameters: answer and name. The name is the name of the hint condition, and the answer is a text string. The type parameter allows you to choose between case sensitive, case insensitive, and case insensitive in any order. A simple example is shown below.
   
   \begin{verbatim}
 <problem >  <problem >
  <startouttext />Which US state has Lansing as its capital?<endouttext / >   <startouttext />Which US state has Lansing as its capital?<endouttext / >
   <stringresponse answer="Michigan" type="ci" >    <stringresponse answer="Michigan" type="ci" >
Line 272  The radiobutton hint tag takes two param Line 292  The radiobutton hint tag takes two param
   </hintgroup >    </hintgroup >
  </stringresponse >   </stringresponse >
 </problem >   </problem > 
   \end{verbatim}
   
   

Removed from v.1.1  
changed lines
  Added in v.1.2


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>