Rev 14672 | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
23 | reyssat | 1 | !set typelist1=!trim\ |
2 | default,Auto,automatic determination of some basic types\ |
||
3297 | bpr | 3 | raw,Raw text,control of comparison by options\ |
23 | reyssat | 4 | numeric,Number, with tolerance of precision\ |
5 | function,Numerical function, function with numerical tests\ |
||
1965 | bpr | 6 | equation,Numerical equation,equation with numerical tests\ |
3297 | bpr | 7 | exp|algexp litexp formal,Mathematical expression, with formal comparison\ |
8 | text|case nocase,Text, words or sentences\ |
||
4537 | bpr | 9 | multiple|checkbox click menu radio mark flashcard multipleclick,Controlable multiple choices,buttons or menus\ |
23 | reyssat | 10 | |
11 | !set typelist2=!trim\ |
||
12 | atext,Approximative text, with identification of singular and plural etc.\ |
||
13419 | bpr | 13 | chemformula,Raw formula of a molecule,in chemistry\ |
11065 | bpr | 14 | chemdraw,Draw a molecule\ |
15 | chemclick,Select atoms or bonds in a molecule\ |
||
23 | reyssat | 16 | chemeq,Chemical equation, with balance analysis\ |
3385 | bpr | 17 | chset,Set of characters,\ |
3297 | bpr | 18 | clickfill|clickfill dragfill,Drag-and-drop objets,text and image\ |
11065 | bpr | 19 | clicktile,Click and color tiles,\ |
20 | clock,Clock\ |
||
11162 | bpr | 21 | complex,Complex number,comparison is done numerically\ |
23 | reyssat | 22 | compose,Compose, using given components\ |
23 | coord,Click on image, recognition of coordinates and various regions\ |
||
11753 | reyssat | 24 | correspond,Correspondence, establish the correspondence between pairs of objects\ |
3385 | bpr | 25 | crossword,Crosswords\ |
4518 | bpr | 26 | chessgame,Déplacement de pièces sur un échiquier\ |
2097 | bpr | 27 | geogebra,Dynamic geometry,use applet GeoGebra\ |
28 | jmolclick,Click on 3D atoms, use applet Jmol\ |
||
6584 | bpr | 29 | jsxgraph,Dynamic geometry,use JSXGraph\ |
30 | jsxgraphcurve, JSXgraph Draw, permettant des tracés avec des formes prédéfinies ou libres\ |
||
2616 | bpr | 31 | keyboard,Text, with keyboard\ |
23 | reyssat | 32 | matrix,Matrix, mathematical\ |
33 | numexp,Rational numbers, fractional writing\ |
||
3350 | bpr | 34 | puzzle,Make in order an image, as in a puzzle\ |
23 | reyssat | 35 | range,Number within a given range, anything within the range is accepted\ |
36 | reorder,Reordering, given list of objects\ |
||
3297 | bpr | 37 | set|set fset aset,Finite set,literal, formal or approximative\ |
23 | reyssat | 38 | sigunits,Sigunits,number with unit and significant digits\ |
39 | symtext,Symtext,advanced tool of text identification\ |
||
40 | units,Number with unit, for physics\ |
||
41 | vector,Vector,formal comparison of components\ |
||
42 | wlist,List of words,\ |
||
43 | |||
44 | |||
45 | !set namelist=Basic types, Specific or advanced types |
||
46 | !set symtextlist=text atext raw compose |
||
47 | |||
11284 | obado | 48 | <h2>User replies to an exercise</h2> |
23 | reyssat | 49 | |
50 | There are two basic ways in which an OEF exercise accepts user replies: |
||
51 | multiple choices and freestyle replies. User answers will be analyzed |
||
52 | according to the nature of the types. It is also possible to show |
||
53 | !href cmd=help&special_parm=feedback feedbacks |
||
54 | to the user when the answer meeds a specified condition (usually to warn a |
||
55 | typical error). |
||
56 | |||
11284 | obado | 57 | <h3>Multiple choices</h3> |
58 | <p>A multiple choice is defined by giving a list of good choices (one or |
||
59 | several) and another list of bad choices.</p> |
||
60 | <p>Up to $choicelim simultaneous multiple choice questions can be asked for |
||
23 | reyssat | 61 | one exercise, under the current implementation. The number of good and bad |
62 | choices within one multiple choice question is unlimited (except a limit on |
||
11284 | obado | 63 | the length of the string imposed by WIMS).</p> |
64 | <p>See |
||
23 | reyssat | 65 | !href cmd=help&special_parm=oef help on OEF format |
11284 | obado | 66 | for the syntax to define a multiple choice.</p> |
3797 | bpr | 67 | |
11284 | obado | 68 | <h3 id="freestyle">Freestyle answers</h3> |
69 | <p>A freestyle answer is one which is typed by the user. |
||
70 | Up to $answerlim simultaneous freestyle answers can be asked for one |
||
71 | exercise, under the current implementation.</p> |
||
72 | The syntax is as follows: |
||
12122 | bpr | 73 | <code> |
74 | \answer{Text}{\reponse}{type=...}{option=...}{weight=...} |
||
75 | </code> |
||
76 | <p>The last 2 fields are optional. |
||
77 | The length of <span class="tt">Text</span> is limited |
||
78 | to $max_promptlen characters. |
||
79 | </p> |
||
6133 | bpr | 80 | <h3>The parameter <span class="tt wims_code_words">type</span></h3> |
23 | reyssat | 81 | <p> |
82 | Each freestyle answer can independently take one of the following types. |
||
6133 | bpr | 83 | </p> |
8825 | bpr | 84 | !for k=1 to 2 |
11284 | obado | 85 | <h4>$(namelist[$k])</h4> |
8825 | bpr | 86 | !set n=!linecnt $(typelist$k) |
23 | reyssat | 87 | <ul> |
88 | !for j=1 to $n |
||
8825 | bpr | 89 | !set l=!line $j of $(typelist$k) |
23 | reyssat | 90 | !distribute item $l into name,title |
91 | !set desc=!item 3 to -1 of $l |
||
3297 | bpr | 92 | !set name=!replace internal | by , in $name |
93 | !set name1=!item 2 to -1 of $name |
||
94 | !set name=!item 1 of $name |
||
95 | !default name1=$name |
||
23 | reyssat | 96 | !if $name isitemof $special_parm or all isitemof $special_parm |
11284 | obado | 97 | <li id="_$name"> |
23 | reyssat | 98 | !read help/anstype/$name.phtml |
99 | !if $name iswordof $symtextlist |
||
11284 | obado | 100 | <p><b>Remark</b>. |
23 | reyssat | 101 | This type of reply accepts the symtext option. If the word |
5903 | bpr | 102 | <span class="tt wims_code_words">symtext</span> is declared in the option of the reply, the analysis of |
23 | reyssat | 103 | the reply will be exactly as for |
104 | !href cmd=help&special_parm=reply,symtext#_symtext symtext |
||
105 | , in particular with no preliminary processing of the texts. And all the |
||
106 | symtext options will be understood in this case. |
||
6133 | bpr | 107 | </p> |
23 | reyssat | 108 | !endif |
109 | !else |
||
6250 | bpr | 110 | <li> |
23 | reyssat | 111 | !href cmd=help&special_parm=reply,$name#_$name $title |
5903 | bpr | 112 | (<span class="tt wims_code_words">$name1</span>) $desc. |
23 | reyssat | 113 | !endif |
6133 | bpr | 114 | </li> |
23 | reyssat | 115 | !next j |
116 | </ul> |
||
117 | !next i |
||
118 | |||
3797 | bpr | 119 | !read help/$lang/embedans.phtml |
120 | |||
11284 | obado | 121 | <h3 id="weight">The optional parameter <span class="tt wims_code_words">weight</span></h3> |
122 | |||
3797 | bpr | 123 | It is possible to give a weight to answers. |
23 | reyssat | 124 | <p> |
8825 | bpr | 125 | Example : |
6133 | bpr | 126 | </p> |
3797 | bpr | 127 | <pre>\answer{}{1}{type=numeric}{weight=8} |
128 | \answer{}{1}{type=numeric}{weight=2} |
||
129 | </pre> |
||
6133 | bpr | 130 | <p> |
8825 | bpr | 131 | Le niveau de sévérité sera aussi pris en compte lors du |
3797 | bpr | 132 | calcul fait et le pourcentage sera pris sur un pourcentage fixé |
8825 | bpr | 133 | par le niveau de sévérité. |
6133 | bpr | 134 | </p><p> |
5903 | bpr | 135 | One can put variables in <span class="tt wims_code_words">weight</span> |
136 | if they are defined before <span class="tt wims_code_variable">\statement</span>. |
||
6133 | bpr | 137 | |
11284 | obado | 138 | <p>Example :</p> |
3797 | bpr | 139 | <pre> |
140 | \text{w = \t = 1 ? 1 : 2} |
||
5377 | bpr | 141 | \answer{}{1}{type=numeric}{weight=\w} |
3797 | bpr | 142 | \answer{}{1}{type=numeric}{weight=3} |
143 | </pre> |
||
144 | |||
11284 | obado | 145 | <h3 id="option">Le paramètre optionnel <span class="tt wims_code_words">option</span></h3> |
8825 | bpr | 146 | Dans le cas de plusieurs options, elles sont séparées par des espaces. |
13575 | bpr | 147 | For example, <span class="tt wims_code_words">option=split noanalyzeprint</span>. |
8825 | bpr | 148 | |
5903 | bpr | 149 | Les options possibles à la suite d'une instruction <span class="tt wims_code_variable">answer</span> |
150 | ou <span class="tt wims_code_variable">condition</span> sont |
||
3797 | bpr | 151 | <ul> |
13575 | bpr | 152 | <li><span class="tt wims_code_words">option=default=" "</span>: The option <span class="tt wims_code_words">default</span> is common for all free answers : |
11284 | obado | 153 | This option can take |
154 | the form <span class="tt wims_code_words">default="default_value"</span>. If the |
||
155 | user gives an empty reply, it is the default_value that will take place. |
||
14858 | bpr | 156 | Un message d'avertissement s'affiche au moment où la réponse est envoyée |
157 | que l'on peut supprimer en rajoutant |
||
158 | <span class="tt wims_code_words">nocheck</span> dans les mots d'option. |
||
11284 | obado | 159 | </li><li> |
160 | <span class="tt wims_code_words">option=split</span>: In case of type <span class="tt wims_code_words">correspond</span>, <span class="tt wims_code_words">checkbox</span> or <span class="tt wims_code_words">mark</span>, |
||
161 | there will be partial score. |
||
162 | </li><li> |
||
163 | <span class="tt wims_code_words">option=nonstop</span> : In case of step exercises, |
||
164 | following questions are asked even if the answer is false. |
||
165 | </li> |
||
166 | <li><span class="tt wims_code_words">option=noanalyzeprint</span>: Le texte automatique d'analyse de réponses n'est |
||
167 | pas affiché. C'est donc à l'auteur de l'exercice de fournir un feedback convenable. |
||
168 | Cela est utile dans certains types comme le type <span class="tt wims_code_words">mark</span> où le texte automatique |
||
169 | est souvent inadéquat. Le score subsiste ainsi que l'indication sur la justesse de la réponse. |
||
170 | </li><li> |
||
171 | Following the instruction <span class="tt wims_code_words">condition</span>, |
||
172 | <span class="tt wims_code_words">option=hide</span>: The condition is used to analyze the |
||
173 | answer but will not be printed. |
||
174 | </li> |
||
3797 | bpr | 175 | </ul> |
11194 | bpr | 176 | Other options are usable in particular answer types. For precision, return to |
177 | the documentation of the answer type. |
||
178 | !read help/option.phtml |
||
6133 | bpr | 179 | |
11284 | obado | 180 | <h2>Testing conditions</h2> |
181 | <p>Under certain circumstances, it is desired that freestyle answers be tested |
||
8825 | bpr | 182 | by special conditions (questions with multiple good answers, exercises |
23 | reyssat | 183 | asking for examples, answers determined by inequalities, etc). This can be |
11284 | obado | 184 | done in the following way.</p> <p> |
23 | reyssat | 185 | If the good answer to a freestyle question is an undefined variable, the |
186 | answer to this question will be fed into this variable. The latter can then |
||
187 | be used to implement testing conditions. The score given to the exercise is |
||
188 | then determined by the number of testing conditions which are met, rather |
||
189 | than the number of answers which meet the good answers. |
||
6133 | bpr | 190 | </p><p> |
23 | reyssat | 191 | Up to $condlim simultaneous conditions can be defined for one |
192 | exercise, under the current implementation. The syntax is as follows. |
||
6133 | bpr | 193 | </p><pre> |
23 | reyssat | 194 | \condition{prompt text}{testing conditions}{weight=...} |
4091 | bpr | 195 | </pre> |
23 | reyssat | 196 | (The last field is optional.) |
197 | <p> |
||
5903 | bpr | 198 | Here are some examples of testing conditions. (<span class="tt wims_code_variable">ans1</span> and |
199 | <span class="tt wims_code_variable">ans2</span> are undefined variables appearing in freestyle answers, as |
||
23 | reyssat | 200 | described above.) |
201 | !href target=wims_mhelp cmd=help&special_parm=if Complete list of relations |
||
11284 | obado | 202 | </p> |
23 | reyssat | 203 | $table_header |
3797 | bpr | 204 | $table_hdtr<th>Condition</th><th>meaning</th></tr> |
4091 | bpr | 205 | $table_tr<td><tt class="wims_code_variable">ans1>=0 and \ans1<=1</tt></td> |
5903 | bpr | 206 | <td>Good if <span class="tt wims_code_words">ans1</span> is within the interval [0,1].</td></tr> |
6133 | bpr | 207 | $table_tr<td class="tt wims_code_variable">ans1=1 or \ans1=3 or \ans1=5</td> |
5903 | bpr | 208 | <td>Good if <span class="tt wims_code_words">ans1</span> is 1, 3 or 5.</td></tr> |
6133 | bpr | 209 | $table_tr<td class="tt wims_code_words">(\ans1)*(\ans2)=6 and (\ans1)+(\ans2)=5</td> |
8825 | bpr | 210 | <td>Good if <span class="tt wims_code_words">ans1</span> and <span class="tt wims_code_words">ans2</span> are the two |
3797 | bpr | 211 | roots of the polynomial x<sup>2</sup>-5x+6.</td></tr> |
6133 | bpr | 212 | $table_tr<td class="tt wims_code_words">sin(\ans1)=0</td> |
5903 | bpr | 213 | <td>Good if <span class="tt wims_code_words">ans1</span> is a multiple of $m_pi.</td></tr> |
6133 | bpr | 214 | $table_end |
11284 | obado | 215 | <p>See |
23 | reyssat | 216 | !href cmd=help&special_parm=oef help on oef format |
11284 | obado | 217 | for the syntax for defining replies.</p> |