Subversion Repositories wimsdev

Rev

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