Subversion Repositories wimsdev

Rev

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>