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