Annotation of capa/capa51/Manual/s-PrototypeSet.tex, revision 1.1
1.1 ! albertel 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>
![[BACK]](/icons/back.gif){kind=icon}
Return to s-PrototypeSet.tex CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / capa / capa51 / Manual