File:
[LON-CAPA] /
capa /
capa51 /
Manual /
s-PrototypeSet.tex
Revision
1.1:
download - view:
text,
annotated -
select for diffs
Fri Jul 14 18:30:33 2000 UTC (24 years, 1 month ago) by
albertel
Branches:
MAIN
CVS tags:
version_2_9_X,
version_2_9_99_0,
version_2_9_1,
version_2_9_0,
version_2_8_X,
version_2_8_99_1,
version_2_8_99_0,
version_2_8_2,
version_2_8_1,
version_2_8_0,
version_2_7_X,
version_2_7_99_1,
version_2_7_99_0,
version_2_7_1,
version_2_7_0,
version_2_6_X,
version_2_6_99_1,
version_2_6_99_0,
version_2_6_3,
version_2_6_2,
version_2_6_1,
version_2_6_0,
version_2_5_X,
version_2_5_99_1,
version_2_5_99_0,
version_2_5_2,
version_2_5_1,
version_2_5_0,
version_2_4_X,
version_2_4_99_0,
version_2_4_2,
version_2_4_1,
version_2_4_0,
version_2_3_X,
version_2_3_99_0,
version_2_3_2,
version_2_3_1,
version_2_3_0,
version_2_2_X,
version_2_2_99_1,
version_2_2_99_0,
version_2_2_2,
version_2_2_1,
version_2_2_0,
version_2_1_X,
version_2_1_99_3,
version_2_1_99_2,
version_2_1_99_1,
version_2_1_99_0,
version_2_1_3,
version_2_1_2,
version_2_1_1,
version_2_1_0,
version_2_12_X,
version_2_11_X,
version_2_11_5,
version_2_11_4_uiuc,
version_2_11_4_msu,
version_2_11_4,
version_2_11_3_uiuc,
version_2_11_3_msu,
version_2_11_3,
version_2_11_2_uiuc,
version_2_11_2_msu,
version_2_11_2_educog,
version_2_11_2,
version_2_11_1,
version_2_11_0_RC3,
version_2_11_0_RC2,
version_2_11_0_RC1,
version_2_11_0,
version_2_10_X,
version_2_10_1,
version_2_10_0_RC2,
version_2_10_0_RC1,
version_2_10_0,
version_2_0_X,
version_2_0_99_1,
version_2_0_2,
version_2_0_1,
version_2_0_0,
version_1_99_3,
version_1_99_2,
version_1_99_1_tmcc,
version_1_99_1,
version_1_99_0_tmcc,
version_1_99_0,
version_1_3_X,
version_1_3_3,
version_1_3_2,
version_1_3_1,
version_1_3_0,
version_1_2_X,
version_1_2_99_1,
version_1_2_99_0,
version_1_2_1,
version_1_2_0,
version_1_1_X,
version_1_1_99_5,
version_1_1_99_4,
version_1_1_99_3,
version_1_1_99_2,
version_1_1_99_1,
version_1_1_99_0,
version_1_1_3,
version_1_1_2,
version_1_1_1,
version_1_1_0,
version_1_0_99_3,
version_1_0_99_2,
version_1_0_99_1,
version_1_0_99,
version_1_0_3,
version_1_0_2,
version_1_0_1,
version_1_0_0,
version_0_99_5,
version_0_99_4,
version_0_99_3,
version_0_99_2,
version_0_99_1,
version_0_99_0,
version_0_6_2,
version_0_6,
version_0_5_1,
version_0_5,
version_0_4,
version5-1-2-first_release,
stable_2002_spring,
stable_2002_july,
stable_2002_april,
stable_2001_fall,
loncapaMITrelate_1,
language_hyphenation_merge,
language_hyphenation,
conference_2003,
bz6209-base,
bz6209,
STABLE,
HEAD,
GCI_3,
GCI_2,
GCI_1,
CAPA_5-1-6,
CAPA_5-1-5,
CAPA_5-1-4_RC1,
BZ4492-merge,
BZ4492-feature_horizontal_radioresponse,
BZ4492-feature_Support_horizontal_radioresponse,
BZ4492-Support_horizontal_radioresponse
- added the manual
1: \hrule
2: \section{Prototype Set with Three Problems}
3: \vskip 0.2in
4: \hrule
5: \vskip 0.2in
6: \subsection{\bf General Description.}
7:
8:
9: The source code for a class's problems are contained
10: in files named {\sl set$x$.qz} where {\em x} is the problem set
11: number. These files usually incorporate information from other
12: files (problem libraries) using the import command, {\tt /IMP}.
13: The example\footnote{\fbox{Boxed} items denote
14: Clicking on a Button selection}
15: below was assembled with {\sf Quizzer} by (1) selecting \fbox{File} in the main menu
16: then (2) choosing \fbox{New}.
17: You will then be prompted to choose the {\sl capa.config} file for the class you are
18: working in, for example {\sl /usr/users/teacher/CAPA5/nsc121s9/capa.config}.
19: In the new window, (3) click \fbox{Std. Header} then (4) \fbox{Import}
20: three times, each time selecting a problem to be imported from the {\sl /demolibrary /type00/sample-prob$xx$}. Each time you import a problem you will be
21: asked to set the weight of the problem and the number of tries allowed.
22: Finally, (5) click
23: \fbox{Endline}. Note: each time you click on one of the
24: buttons, you will be prompted if your cursor is in the correct position. Make
25: sure the cursor is at the beginning of a blank line and not within header
26: and question text.
27:
28: \index{sample problem set}
29: \begin{capacode}
30: //CAPA system software is copyrighted by Michigan State University.
31: //By using these materials, the User agrees to:
32: //1) Protect the source code files from unauthorized copying.
33: //2) Limit access of the source material to teaching staff.
34: //3) The User is free to mix, cut and paste, modify, adapt, delete,
35: // improve, etc. the problems and graphics for his/her own use.
36: //
37: /IMP "/demolibrary/Tools/StdMacros"
38: /IMP "/demolibrary/Tools/StdUnits"
39: /IMP "/demolibrary/Tools/StdConst"
40: /IMP "/demolibrary/Tools/GreekWeb2"
41: /IMP "HWTop"
42: //
43: //
44: /BEG prob_val=1
45: /LET try_val=99
46: /LET hint_val=1
47: /DIS("/demolibrary/type00/sample-prob01")
48: /IMP "/demolibrary/type00/sample-prob01"
49: /DIS(stdline)
50: //
51: /BEG prob_val=1
52: /LET try_val=99
53: /LET hint_val=1
54: /DIS("/demolibrary/type00/sample-prob02")
55: /IMP "/demolibrary/type00/sample-prob02"
56: /DIS(stdline)
57: //
58: /BEG prob_val=1
59: /LET try_val=99
60: /LET hint_val=1
61: /DIS("/demolibrary/type00/sample-prob03")
62: /IMP "/demolibrary/type00/sample-prob03"
63: /DIS(stdline)
64: /END(stdendline)
65: \end{capacode}
66: \capa\ processes the above set in a number of ways. By choosing \fbox{Create .dvi} and
67: selecting a student by entering {\tt A87654321}, one obtains the result
68: displayed on the following page.
69: This set is similar to {\sl nsc121s9/set2.qz} in the distribution.
70: \\
71: \\
72: \\
73:
74: \index{sample problems!tex output}
75:
76: {
77: \parbox[t]{3.9in}{
78: \noindent{\large\bf Student, Jaimie .\hfill Section {\Large 1}}\newline
79: \vskip -.1in
80: \noindent {\large \it Sample \capa Questions \hfill Set 2}\newline
81: \vskip -.16in
82: \noindent{\bf nsc121s9} Due Fri, May 28, 1999 at 10:00\hfill CAPA\_ID 8239
83: \vskip .05in \pagestyle{empty}
84:
85: /demolibrary/type00/sample-prob01
86: {\par \bf 1.} [1pt]
87: Find the area of a rectangle with a length of 8.0$\, cm$ and width of 4.0$\, cm$.
88: \vskip .05in \hrule width2in height0.6pt \hfill \vskip .02in
89: /demolibrary/type00/sample-prob02
90: {\par \bf 2.} [1pt]
91: The graph below shows the function \\ \centerline{$Y=ax$}
92: Make a careful determination of the value of $a$.
93: \epsfxsize=3.6in \epsffile{/demolibrary/Graphics/Gtype00/Ym39x.ps}
94: \vskip .05in \hrule width2in height0.6pt \hfill \vskip .02in
95: /demolibrary/type00/sample-prob03
96: {\par \bf 3.} [1pt]
97: A mass M = 0.13$\, kg$ is on a smooth horizontal surface with negligible
98: friction. It is attached to a spring with spring constant k = 15.3$\, N/m$.
99: The mass is displaced from its equilibrium position by a distance of
100: 0.14$\, m$ and then released from rest.
101: (Give all of the correct answers, i.e., A or BC or ABC...)
102: \begin{choicelist}
103: \item[] A) The amplitude doesn't vary with time
104: \item[] B) The motion of M is simple harmonic motion.
105: \item[] C) The frequency of oscillation is independent of k.
106: \end{choicelist}
107: \vskip .05in \hrule width2in height0.6pt \hfill \vskip .02in
108: \vskip .05in \hrule width3.55in height0.6pt \hfill \vskip -.07in \noindent {\tiny College of Natural Science, Michigan State University \dotfill {CAPA\copyright msu}}
109: \index{HWTop file!sample output}
110: }\hspace*{.3in}\parbox[t]{2.9 in}{ \footnotesize {\tt <==} The first 3-lines
111: on the left are generated by the HWTop file. This file uses definition in
112: the StdMacros file so that the order of /IMP in the set{\em x}.qz is important.
113:
114: \vspace*{0.2in}
115: \index{/DIS!sample output}
116: {\tt <==} This line shows the path of the imported problem. It is essential
117: for classifying the content of a library. It is also useful while debugging
118: a set. Before printing for students, just change the {\tt /DIS...} to a comment,
119: i.e., to {\tt //DIS...} in the {\sl set$x$.qz} file.
120:
121: \vspace*{1.2in}
122: \index{sample problems!graphics}
123: {\tt <==} The paths for {\sl .ps} or {\sl .gif} version of the picture are specified
124: in the problem file. This is one of 14 pictures randomly selected for
125: students as will be seen below from the problem code.
126:
127: \vspace*{01.4in}
128: \index{problem value}
129: {\tt <==} The point value here is set by the {\tt /BEG prob\_val=2} at the start
130: of Problem 3. [Note: {\tt /BEG} is just an alias for {\tt /LET}
131:
132: \vspace*{0.7in}{\tt <==} This type of problem should have at least 4
133: statements unless it is in an exam where students have just one try.
134: That is, at least one of the three statements should have two choices for
135: \capa\ to randomize from.
136: Therefore, there may be several versions of each of the statements (see problem
137: code in ``Problem 3'' section.)
138:
139: }
140:
141: \newpage
142:
143:
144: \index{Tools directory!StdMacros}
145: \index{Tools directory!StdUnits}
146: \index{Tools directory!StdConst}
147: \subsection{\bf Imported Standard Files.}
148: All the files below should be read as examples of CAPA coding and may be edited and adapted by users.
149: \begin{itemize}
150: \item The {\sl /demolibrary/Tools/StdMacros} contains a set of useful macros
151: such as ``stdline'' to facilitate coding.
152: \item The {\sl /demolibrary/Tools/StdUnits} has a large number of unit
153: combinations pre-formatted for presentation on the printed page and Web
154: browsers.
155: \item The {\sl /demolibrary/Tools/StdConst} defines variables for a number
156: of often used fundamental constants.
157: \item The {\sl /demolibrary/Tools/GreekWeb2} file is a list of variables
158: for displaying greek letters, symbols, etc. You can view the symbols
159: in the output of {\sl set13.qz} in the distribution class.
160: \index{HWTop file!description}
161: \index{copyright line}
162: \index{Department Name}
163: \item The {\sl HWTop} file resides in the classname folder. Two lines which
164: construct the stdendline require editing. They are visually separated from
165: other items in the file by rows of asterisks. Please edit these lines to
166: reflect the correct course and department information.
167: \begin{capacode}
168: //************* Edit the 2 statements below to suit ****************
169: /LET coursename="Sample \capa Questions"
170: /LET DeptID="College of Natural Science, Michigan State University"
171: //******************************************************************
172: //
173: /IF (tex("Y","N")=="Y")
174: /DIS("\noindent{\large\bf "+name()+"\hfill Section {\Large "+section()+"}}\newline")
175: /DIS("\vskip -.1in")
176: /DIS("\noindent {\large \it "+coursename+" \hfill Set "+set()+"}\newline")
177: /DIS("\vskip -.16in")
178: /DIS("\noindent{\bf "+class()+"} Due "+due_date()+"\hfill CAPA\_ID "+capa_id())
179: /DIS("\vskip .05in \pagestyle{empty}")
180: /ENDIF
181: /DIS(html("<b>"+name()+"</b>"))
182: /LET stdendline=stdendlineA+DeptID+stdendlineB //A & B are in Tools/StdMacros
183: \end{capacode}
184: \item {\sl HWTopSN} is similar except for an extra line of code which displays
185: the student number. This is not recommended because the combination of the
186: student number and \capa\ ID is all that is needed to access the system
187: for this and preceeding problem sets.
188:
189:
190:
191: \end{itemize}
192:
193: \newpage
194:
195: \subsection{\bf Problem 1.}
196:
197: \index{sample problems}
198: The text of {\sl /demolibrary/type00/sample-prob01} is:
199: \vskip 3mm
200: {\footnotesize
201: {
202:
203: \begin{minipage}[t]{4.2in}
204: \begin{verbatim}
205: //**************************************
206: //BEG prob_val=1
207: //LET try_val=20
208: /IMP "/demolibrary/Tools/Problem#"
209: // By kashy@nscl.msu.edu, No commercial use.
210: /HIN The area of a rectangle is the product of the two sides.
211: /EXP Multiply the length by the width and enter the result.
212: //
213: /LET long=random(7.0,9.1,1.0)
214: /LET wide=random(2.0,5.1,2.0)
215: //
216: Find the area of a rectangle with a length of /DIS(long:1f)\
217: /DIS(cm_u) and width of /DIS(wide:1f)/DIS(cm_u).
218: //
219: /LET area=long*wide
220: /ANS(area:1f,tol=0.2,wgt=prob_val,tries=10,hint=hint\_val,unit="cm^2")
221: //**************************************
222: \end{verbatim}
223: \end{minipage}\hspace*{8mm}
224: \begin{minipage}[t]{2.4in}
225: \vspace*{2mm}{\tt <==} The {\tt //BEG prob\_val=2} and {\tt //LET try\_val=2} are comments.
226: The variables {\tt prob\_val} and {\tt try\_val} are defined in the {\sl set$x$.qz}. \\
227:
228: \index{hints!usage}
229: \index{explanations!usage}
230: \vspace*{-2mm}{\tt <==} Hints and Explanations are optional. Additional
231: hints can be inserted directly in the {\sl set$x$.qz} file for each problem.\\
232:
233: \index{random function!usage}
234: \vspace*{-1mm}{\tt <==} This questions was built when the \capa\ sets were
235: built on a different computer than the ones that the students logged into.
236: There were slight parsing differences with respect to real numbers
237: between the computers. Therefore, adding a little to the high end avoided this
238: problem (i.e. using 9.1 instead of 9.0 in the definition of {\tt long}). Even better
239: though would be to parse only random integers and avoid the problem entirely. \\
240:
241:
242:
243: \index{answer format!example}
244: \vspace*{-1mm}{\tt <==} Note the unit for the problem is defined as a string.
245: \end{minipage}
246: }
247: }
248: \newpage
249: \index{sample problems}
250: \subsection{\bf Problem 2.}
251: {\sl /demolibrary/type00/sample-prob02:}
252: \vskip 3mm
253: {\footnotesize
254: {
255:
256: \begin{minipage}[t]{4.0in}
257: \begin{verbatim}
258: //**************************************
259: //BEG prob_val=1
260: //LET try_val=20
261: /IMP "/demolibrary/Tools/Problem#"
262: //By E. Kashy, kashy@nscl.msu.edu, No commercial use
263: //
264: /LET k=random(1,14,1)
265: /LET file=choose(k,"35","45","56","62","77","86","93","m26",\
266: "m39","m47","m51","m66","m74","m84")
267: //
268: //
269: //
270: //
271: //
272: /LET slope=choose(k,3.5, 4.5, 5.6, 6.2, 7.7, 8.6, 9.3, -2.6,\
273: -3.9, -4.7, -5.1, -6.6, -7.4, -8.4)
274: //
275: //
276: //
277: //
278: /LET TexGraph="\epsfxsize=3.6in \epsffile{/demolibrary"+ \
279: "/Graphics/Gtype00/Y"+label+"x.ps}"
280: /LET WebGraph="<IMG SRC=/demolibrary/Graphics/Gtype00/Y"+ \
281: label+"x.gif"
282: //
283: //
284: /LET constStr=web("a","$a$","<i>a</i>")
285: /LET functStr=web("Y=ax","\\ \centerline{$Y=ax$}","<i>Y=ax</i>")
286: //
287: //
288: The graph shows the function /DIS(functStr)
289: Make a careful determination of the value of /DIS(constStr).
290: //
291: /DIS(web("", TexGraph, WebGraph))
292: //
293: //
294: /ANS(slope:2E,tol=5%,wgt=prob_val,hint=hint\_val,tries=try_val)
295: //**************************************
296: \end{verbatim}
297: \end{minipage}\hspace*{8mm}
298: \begin{minipage}[t]{2.9in}
299: \index{/IMP function!usage}
300: \vspace*{7.5mm}{\tt <==} The {\tt /IMP} command imports a file to format the
301: problem number.\\
302:
303: \index{random function!usage}
304: \index{choose function!usage}
305: \vspace*{1.5mm}{\tt <==} The computer code picks a random number, k. For k=4,
306: the choose
307: function selects the string variable, 62 which is
308: then concatenated into the name of the .eps or .gif file to be displayed.
309: \index{continuation character}\index{line continuation} NOTE: The back
310: slash is a line
311: continuation character which hides the carriage return so that the {\tt /LET}
312: statement has no carriage return.\\
313:
314: \index{choose function!sample}
315: \vspace*{1.5mm}{\tt <==} The answer (slope) is also specified with a {\tt choose()} function using the
316: same selection index {\tt k}. Thus, the data in the first {\tt choose()} function
317: corresponds to the answers
318: in the second {\tt choose()} function.
319:
320:
321: \index{sample problems!graphics}
322: \index{graphics!commands to input}
323: \vspace*{2mm}{\tt <==} Commands and paths for the TeX and Web figures.
324: The continuation character is outside the ``string''.\\
325:
326: \index{web function!sample usage}
327: \index{tex function!sample usage}
328: \vspace*{8mm}{\tt <==} This formats the equation for Web and TeX\\
329:
330: \vspace*{10mm}{\tt <==} Text of problem.\\
331:
332: \index{/DIS!sample usage}
333: \vspace*{1mm}{\tt <==} Displays the figure in TeX and Web.\\
334:
335: \end{minipage}
336: }
337: }
338: \newpage
339: \subsection{\bf Problem 3.}
340: {\bf /demolibrary/type00/sample-prob03:}
341: \vskip 3mm
342: {\footnotesize
343: {
344:
345: \index{sample problems}
346: \begin{minipage}[t]{3.8in}
347: \begin{verbatim}
348: //**************************************
349: //BEG prob_val=1
350: /IMP "/demolibrary/Tools/Problem#"
351: //
352: //By E. Kashy, kashy@nscl.msu.edu, No Commercial Use
353: // /demolibrary/CAPA46/MCTools/Nof3 Select N correct
354: //of 3 Statements
355: //
356: A mass M = 0.13/DIS(kg_u) is on a smooth horizontal surface \
357: with negligible friction. It is attached to a spring with \
358: spring constant k = 15.3/DIS(NPm_u). The mass is displaced \
359: from its equilibrium position by a distance of 0.14 m and \
360: then released from rest. (Give all of the correct answers, \
361: i.e., A or BC or ABC...)
362: //----------------------------------------
363: /LET s1a="The motion of M is simple harmonic motion."
364: /LET s1b="Statement 1 variation b"
365: /LET s1c="Statement 1 variation c"
366: /LET s1d="Statement 1 variation d"
367: /LET mix1=random(1,1,1)
368: /LET a1a=1
369: /LET a1b=26
370: /LET a1c=26
371: /LET a1d=26
372: //
373: /LET s2a="The amplitude varies with time."
374: /LET s2b="The amplitude doesn't vary with time"
375: /LET s2c="Statement 2 variation c"
376: /LET s2d="Statement 2 variation d"
377: /LET mix2=random(1,2,1)
378: /LET a2a=2
379: /LET a2b=1
380: /LET a2c=26
381: /LET a2d=26
382: //
383: /LET s3a="The frequency of oscillation is independent of k."
384: /LET s3b="The Period of oscillation is independent of k."
385: /LET s3c="The frequency of oscillation depends of k."
386: /LET s3d="Statement 3 variation d"
387: /LET mix3=random(1,3,1)
388: /LET a3a=2
389: /LET a3b=2
390: /LET a3c=1
391: /LET a3d=26
392: //
393: //
394: /IMP "/demolibrary/MCTools/Nof3aux"
395: //
396: //
397: /ANS(Nof3right,wgt=prob_val,str=mc,hint=hint_val,tries=try_val)
398: //**************************************
399: \end{verbatim}
400: \end{minipage}\hspace*{8mm}
401: \begin{minipage}[t]{2.9in}
402: \index{MCTools!sample usage}
403: \vspace*{11mm}{\tt <==} This problem starts as a template {\sl Nof3} which is located in {\sl /demolibrary/MCTools}.
404:
405:
406:
407: \index{StdUnits!sample usage}
408: \vspace*{11mm}{\tt <==} \ Certain variables ({\tt kg\_u, NPm\_u})
409: are not defined within the problem. Because they are used often, they were
410: defined in a files imported once at the start of the set ({\tt /IMP
411: "/demolibrary/Tools/StdUnits"})\\
412:
413:
414:
415: \index{choose function!sample usage}
416: \vspace*{13mm}{\tt <==} The {\tt mix1} variable will allow only the one variation of this statement and all students will have it.
417: It is identified as correct by {\tt a1a=1}. \\
418:
419: \vspace*{11mm}{\tt <==} The {\tt mix2} variable will select either of 2
420: variations of this statement for a particular student. The first
421: leaf is identified as incorrect by {\tt a2a=2}, while the second is correct, with
422: {\tt a2b=1}. This templates allows up to 4 variations for each statement.\\
423:
424:
425: \vspace*{24mm}{\tt <==} The {\tt mix3} variable will select one of the 3
426: variations of this 3rd statement to be given to a particular student. \\
427:
428:
429: \index{.aux files}
430: \vspace*{10mm}{\tt <==} The {\sl .aux} file randomizes the order and formats
431: presentation. Note the names of the statement and answer variables s3a, s3b,
432: a3a, a3b, etc. must correspond to those used in the {\sl Nof3aux} file.\\
433:
434: \index{answer formatting!order and case,sample usage}
435: \vspace*{-2mm}{\tt <==} The three letters in the answer can be in any order
436: because {\tt str=mc} is selected.
437:
438: \end{minipage}
439: }
440: }
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>