Annotation of capa/capa51/Manual/s-swcomps.tex, revision 1.1
1.1 ! albertel 1: \hrule
! 2: \section{\capa{} Software Components}
! 3: \vskip 0.2in
! 4: \hrule
! 5: \vskip 0.2in
! 6:
! 7: There are nine application codes in the complete system.
! 8: They are: {\sf Quizzer, Grader, Manager, Capalogin, Capasbin, Capahtml,
! 9: Qzparse, Capautils} and {\sf AllCapaID.} The {\sf Quizzer}, {\sf Grader}, and
! 10: {\sf Manager} applications are tools for the instructor to create problem sets, grade exams and hand-scored problems, and manage the class.
! 11: It was necessary in earlier versions of \capa\ to use the {\sf Qzparse}, {\sf AllCapaID}, and {\sf CapaUtils} to perform certain tasks. Now however, almost all of their functions can also be found or accessed in either {\sf Quizzer}, {\sf Grader}, or {\sf Manager}. The other three applications are necessary for the student interface.
! 12: The {\sf Capalogin} code is executed automatically for each student telnet session. Similar in function are the {\sf Capahtml} and {\sf Capasbin}
! 13: programs executed by the web server when a student uses web browser to answer the problem set.
! 14: In order for many of these components to work properly, the instructor customizes the necessary {\sl capa.config} file which must reside in each classname
! 15: folder.
! 16:
! 17: \subsection{The {\sl capa.config} File}
! 18: A file called \index{capa.config}{\sl capa.config} located in the class directorry contains general configuration information needed for the \capa\ system. In
! 19: the usual installation, the class directory contains the homework assignment
! 20: sets. When generating statistics and reports, {\sf Manager} requires the user
! 21: to select a {\sl capa.config} file, and assumes that the user will go the the class directory to select that file.
! 22: The {\sl capa.config} is divided into sections containing configurable parameters so that instructors can customize the \capa\ system.
! 23: %%%%%%%%%%%%%%%%%%%%%%%%%%
! 24: \begin{itemize}
! 25: %%%%%%%%%%%%%%%%%%%%%%%%%%
! 26:
! 27: \item {\bf Class Structure:} The first section contains information related to the organization of a course. It defines the paths pointing to other possible course components, such as \index{exam\_path}exam\_path, \index{quiz\_path}quiz\_path, \index{supp\_path}supp\_path,
! 28: and \index{others\_path}others\_path. Below is the exact text as it appears
! 29: in the {\sl capa.config} file. Every comment begins with a ``\#'' symbol.
! 30: The comments explain how to customize the file.
! 31: \begin{capacode}
! 32: # Comments in this file begins with a # mark in the first column
! 33: # when setting a value there MUST be a space before and after the =
! 34:
! 35: # ================= class structure ============
! 36: # Defined below are the paths to the various portions of the class.
! 37: # (Note: The homework is usually in the class directory,
! 38: # /usr/users/teacher/CAPA51/phy183f0
! 39: # The file /usr/users/teacher/CAPA51/phy183f0/capa_config is used by
! 40: # manager to generating stats such as the student course profile.
! 41: #
! 42: # Possible other "classes" (paths) a user MAY define are exam_path, quiz_path,
! 43: # supp_path (supplementary problems), and others_path. Data from these 4 paths
! 44: # are used by Manager and included in the stats generated (for example, when
! 45: # generating a summary of a student's performance, a Student Course Profile)
! 46:
! 47: quiz_path = /usr/users/teacher/CAPA51/qph183f0
! 48: exam_path = /usr/users/teacher/CAPA51/xph183f0
! 49: supp_path = /usr/users/teacher/CAPA51/xpc183f0
! 50: others_path = /usr/users/teacher/CAPA51/fci183f0
! 51:
! 52: # A popular feature we have used is to allow students (optionally) to earn
! 53: # partial credit on Mid-term exams. Since our exams are mostly or totally
! 54: # computer scored, we have allowed students to correct their exams and earn
! 55: # partial credit: At the end of the exam, students pick up a different version
! 56: # of the exam as if it were a homework assignment, and enter answers in the
! 57: # computer with a short deadline (2-3 days). They must do all the problems, and
! 58: # earn partial credit on the improvement in score.
! 59: # Example: For 25pct partial credit, a student with 60% on exam 1 (i.e.,
! 60: # set1.qz in xph183f0) and 90% on the corrections 1 (set1.qz in xpc183f0),
! 61: # gets 60+0.25*(90-60)=67.5pct
! 62: # To use that feature in CAPA, the path where the corrections sets are entered
! 63: # must be defined.
! 64:
! 65: correction_path = /usr/users/teacher/CAPA51/xpc183f0
! 66:
! 67: # Note that we used the supp_path for that purpose: set1.qz in xph183f0 has the
! 68: # same questions as set1.qz in xpc183f0, but the former is proctored and
! 69: # students fill out scantron forms, while for the latter, students enter as
! 70: # they would for homework, but in the xpc183f0 (eXamPartialCredit) "class". \end{capacode}
! 71:
! 72:
! 73:
! 74: \item {\bf Extrapolate Term Score:} An applet that allows students to
! 75: extrapolate their term score can be enabled, and will include the Partial
! 76: Credit by Corrections discussed above. A button on the main menu of the
! 77: homework web page initiates the applet
! 78: \begin{capacode}
! 79: # ================= Extrapolate Scores Applet ================
! 80: # Server where the applet resides:
! 81: capa_server = capa2.nscl.msu.edu
! 82:
! 83: # Width and height of the applet:
! 84: tscore_width = 500
! 85: tscore_height = 450
! 86:
! 87: # yes means show the applet, no inhibts the display of the applet
! 88: term_score_applet = no
! 89:
! 90: # The weights used in term score calculation formula:
! 91: # term_score = homework_weight * sum of homework + quiz_weight *
! 92: # sum of quizes + exam_weight * sum of exams + final_weight * final exam
! 93: # These values will in most cases add up to 1.
! 94: homework_weight = 0.3
! 95: quiz_weight = 0.05
! 96: exam_weight = 0.3
! 97: final_weight = 0.35
! 98:
! 99: # This specifies the weight of the correction exam:
! 100: # corrected exam score = raw exam score + correction_weight *
! 101: # (correction score - raw exam score)
! 102: # If correction score is less than raw exam score, no correction is taken.
! 103: correction_weight = 0.25
! 104:
! 105: # final_exam_set_number specifies what set number will be or is the
! 106: # final exam in the class (directory) defined by exam_path.
! 107: final_exam_set_number = 4
! 108:
! 109: # homework_count is the total number of homeworks that will be given
! 110: # to the students
! 111: homework_count = 12
! 112:
! 113: # quiz_count is the total number of quizzes that will be given to the
! 114: # students
! 115: quiz_count = 20 \end{capacode}
! 116:
! 117: \item {\bf Configuring the ``Discuss" forum:}
! 118: A discussion forum for posting questions and replies associated with problems in assignments can be enabled for each set, using the "set db Header" menu.
! 119: \begin{capacode}
! 120: # =============== capadiscuss configuration ====
! 121: # "Admin" sections: Teaching staff listed in Admin sections can delete
! 122: # and hide messages (instructor/TA sections). Examples:
! 123: # admin_section = 033
! 124: # admin_section = 33
! 125: # admin_section = 033,12,099,2
! 126: admin_section = 099
! 127:
! 128: # You can ban particular users (problem students) from using the "discuss"
! 129: # forum page. Examples:
! 130: # banned_users = A12345677
! 131: # banned_users = a12345677
! 132: # banned_users = A12345677, a12345678,A12345666
! 133: banned_users = A12312312 \end{capacode}
! 134:
! 135: \item {\bf Manager Configuration:}
! 136: Data to be included in various reports and graphs:
! 137: \begin{capacode}
! 138: # =================== Manager configuration ====
! 139: # Manager will compile statistics with data from set1.db,
! 140: # set2.db and so on until the setX.db file which does not
! 141: # exist or until it reaches the set number specified below.
! 142: # Defining the limits with a number of 99 will make the program
! 143: # to include all scores from all setX.db files up to set 99.
! 144: homework_scores_limit_set = 99
! 145: exam_scores_limit_set = 99
! 146: quiz_scores_limit_set = 99
! 147: supp_scores_limit_set = 99
! 148: others_scores_limit_set = 99
! 149:
! 150: # Note that when calculating stats, Manager will ask the user to select a
! 151: # capa_config file. Manager will assume that the capa_config file selected
! 152: # resides in the directory containing the homework sets for which the
! 153: # limit "homework_scores_limit_set" is set above. \end{capacode}
! 154:
! 155:
! 156: \item {\bf Command Specifications}: This section specifies the absolute
! 157: path to commands that are used by the \capa\ system,
! 158: such as {\tt latex}, {\tt dvips}, {\tt mail}, {\tt allcapaid}, and
! 159: {\tt qzparse}. It should be unnecessary to change these.
! 160:
! 161: \begin{capacode}
! 162: # ================= Command specifications =====
! 163: #
! 164: # When specifying a command, use double quotes.
! 165: #
! 166: latex_command = "latex"
! 167: dvips_command = "dvips"
! 168: mail_command = "mailx"
! 169: allcapaid_command = "allcapaid"
! 170: qzparse_command = "qzparse"
! 171: answers_command = "answers" \end{capacode}
! 172: %%%
! 173: \item {\bf Printing Configuration}: The next section lets the instructor identify the printers he/she will
! 174: use to print assignments, exams, quizzes, etc.
! 175: The command used to choose one or two sided printing should be specified in
! 176: this section also. The commands listed below may differ for different operating systems. Check with your system administrator to determine both the printer name and print command syntax.
! 177: \index{lprOneSided\_command}
! 178: \index{lprTwoSided\_command}
! 179: \begin{capacode}
! 180: # ================= Printing configuration ====
! 181: #
! 182: # -printer list-
! 183: # add available printer name here
! 184: # they will appear in a selection list in the order listed here
! 185: # multiple printer quese can be defined
! 186: #
! 187: printer_option = "print_queue1"
! 188: printer_option = "print_queue2"
! 189:
! 190: # -print command-
! 191: # The predefined variables: $PS_file and $Printer_selected
! 192: # indicate the file to be printed and the printer queue to be
! 193: # printed to.
! 194: #
! 195: lprOneSided_command = "/usr/bin/lpr -P$Printer_selected"
! 196: lprTwoSided_command = "/usr/bin/lpspr -K2 $PS_file | /usr/bin/lpr -P$Printer_selected" \end{capacode}
! 197: %%%
! 198:
! 199: \item {\bf Capalogin/Web Settings:}
! 200: This section specifies options for the {\sf Capalogin} shell and the
! 201: Web display.
! 202: It is unnecessary to change these.
! 203: \index{capalogin\_goodbye\_delay}
! 204: \index{capalogin\_inactivity\_delay}
! 205: \index{capalogin\_show\_summary\_score}
! 206:
! 207: \begin{capacode}
! 208: # ================= capalogin/web settings =========
! 209: #
! 210: # Specify the capalogin goodbye message delay in seconds.
! 211: # This if for the telnet interface only.
! 212: capalogin_goodbye_delay = 4
! 213:
! 214: # Specify the capalogin inactivity delay time in minutes.
! 215: # Default value is 60 minutes. 0 means never time out.
! 216: # This if for the telnet interface only.
! 217: capalogin_inactivity_delay = 25
! 218:
! 219: # If set to "none", then the summary score will not show. Any other
! 220: # value or not defined will cause the summary score to be displayed.
! 221: # This if for the telnet interface only.
! 222: #capalogin_show_summary_score = show
! 223:
! 224: # Used to define how many problems to be displayed on the webpage.
! 225: # Default is all. If specified must have and integer argument, otherwise
! 226: # uses default value.
! 227: #num_questions_per_page = 26
! 228:
! 229: # Used to define the length of the status line on the top of the webpage.
! 230: # If there are more problems than this, multiple status lines are created.
! 231: # By default, one line of the length of the # of problems in the set
! 232: # is created.
! 233: #web_status_line_length = 26
! 234:
! 235: # If set to "no", then the viewing of term summaries is not an option.
! 236: # Default is yes. This is for both web and telnet interface.
! 237: #term_summary_button = yes
! 238:
! 239: # Used to define the cgi path, if unspecified, defaults to capa-bin
! 240: #capaweb_cgibin_path = /path/to/cgi \end{capacode}
! 241: %%%%
! 242: \item {\bf Quizzer Settings:}
! 243: The next section is related to an option in
! 244: {\sf Quizzer}.
! 245: Everything between ``BeginStandardQuizzerHeader'' and
! 246: ``EndStandardQuizzerHeader'' is inserted into the {\sl .qz} file when
! 247: the user clicks on the \fbox{Std. Header} button while using the
! 248: {\sf Quizzer} application.
! 249: \begin{capacode}
! 250: # ================= Quizzer settings ==========
! 251: #Everything between BeginStandardQuizzerHeader and
! 252: #EndStandardQuizzerHeader is inserted into the .qz file when using the
! 253: #Std. Header button in Quizzer
! 254:
! 255: BeginStandardQuizzerHeader
! 256: //CAPA library problems NOT included in the demolibrary are copyrighted
! 257: //by the author, institution, publisher, etc.. By using these materials,
! 258: //the user agrees to:
! 259: // 1) Protect the problem source code files from unauthorized copying.
! 260: // 2) Limit access of the problem source material to teaching staff.
! 261: // This includes installing the CAPA system securely (please see
! 262: // READMEsecurity.txt from the CAPA distribution).
! 263: // 3) The user is free to mix, cut and paste, modify, adapt, delete,
! 264: // improve, etc. the problems and graphics for her/his own use.
! 265: //
! 266: //See quizzer "Info" or http://capa.msu.edu/license for more information
! 267: //about terms and conditions.
! 268: //
! 269: /IMP "/demolibrary/Tools/StdMacros"
! 270: /IMP "/demolibrary/Tools/StdUnits"
! 271: /IMP "/demolibrary/Tools/StdConst"
! 272: /IMP "/demolibrary/Tools/GreekWeb2"
! 273: /IMP "HWTop"
! 274: EndStandardQuizzerHeader \end{capacode}
! 275: \item {\bf Unit Section:} This is divided into three subsections.
! 276: %%%%%%%%%%%
! 277: \begin{enumerate}
! 278: %%%%%%%%%%%
! 279: \item {\bf Base Units:} The capa.config file defines the base units first.
! 280: It begins with the special marker {\tt << Base Unit >>.} Each line contains a definition of a base unit which consist of
! 281: (1) a full name, (2) a symbol representing that base unit, (3) and a
! 282: comment beginning with a ``\#''
! 283: character. All three fields are required and are space delimited (no tabs). There is a 47 character limit to the unit name, 15 character limit for the unit symbol and a total of 32 base units can be defined.
! 284:
! 285: \begin{capacode}
! 286: # ======================= Unit section =============
! 287: # Base Unit
! 288: # name symbol comment
! 289:
! 290: << Base Unit >>
! 291:
! 292: meter m # length
! 293: kilogram kg # mass
! 294: second s # time
! 295: ampere A # electric current
! 296: kelvin K # thermodynamic temperature
! 297: mole mol # amount of substance
! 298: candela cd # luminous intensity
! 299:
! 300: \end{capacode}
! 301:
! 302: %%%%
! 303:
! 304: \item {\bf Prefixes:} The next subsection of units includes prefix symbol definitions.
! 305: It consists of three fields on each line, separated by
! 306: white spaces or tab characters. This section needs to begin with the marker
! 307: {\tt << Prefix >>.}
! 308:
! 309: \begin{capacode}
! 310: # Prefix symbol factor
! 311: << Prefix >>
! 312:
! 313: yotta Y 10^{24}
! 314: zetta Z 10^{21}
! 315: exa E 10^{18}
! 316: peta P 10^{15}
! 317: tera T 10^{12}
! 318: giga G 10^9
! 319: mega M 10^6
! 320: kilo k 10^3
! 321: hecto h 10^2
! 322:
! 323: deci d 10^-1
! 324: centi c 10^-2
! 325: milli m 10^-3
! 326: micro u 10^-6
! 327: nano n 10^-9
! 328: pico p 10^{-12}
! 329: femto f 10^{-15}
! 330: atto a 10^{-18}
! 331: zepto z 10^{-21}
! 332: yocto y 10^{-24}
! 333:
! 334: \end{capacode}
! 335:
! 336: %%%%
! 337: \item {\bf Derived Units:} The final part of the unit subsection is the definition of derived units. It begins with the special marker {\tt << Derived Unit >>}
! 338: and consists of FOUR required fields on each line. The fields are as follows: \\
! 339: \begin{itemize}
! 340: Field (1) is the unit name; maximum of 47 characters with no spaces. \\
! 341: Field (2) is the symbol representing the unit; maximum of 15 characters with no spaces.
! 342: \end{itemize}
! 343: Fields (1) and (2) are separated by spaces.
! 344: Field (3) is the way the unit is calculated from base units or other
! 345: previously defined derived units.
! 346: Calculations of derived units use the standard operands for multiplication
! 347: (*), division (/), and power (\verb+^+).
! 348: Addition and subtraction are not allowed. Numbers can be in
! 349: floating point or exponential format.
! 350: The comment, field (4), is {\bf required} and begins with a hashmark (\#).
! 351: \begin{capacode}
! 352: # Derived Unit
! 353: # name symbol unit comment
! 354: # name must be in oneword
! 355: <<Derived Unit>>
! 356:
! 357: gram g 0.001 kg # mass
! 358: hour hr 3600. s # time
! 359: minute min 60 s # time
! 360: day day 24.0 hr # time
! 361: year yr 365.24 day # time
! 362: pound lb 0.45359237 kg # mass
! 363: ounce oz 1.77185E-3 kg # mass
! 364: inch in 2.54 cm # length
! 365: foot ft 12 in # length
! 366: mile mi 5280 ft # length
! 367: yard yd 0.9144 m # length
! 368: nautical_mile n_mi 6080 ft # length, nautical mile (UK)
! 369: rood rood 1210 yd^2 # area, rood
! 370: acre acre 4840 yd^2 # area, acre
! 371: hertz Hz 1/s # frequency
! 372: litre L 10^3/cm^3 # volume
! 373: newton N m*kg/s^2 # force
! 374: pound_force lbf 4.44822 N # force
! 375: dyne dyn 1E-5 N # force
! 376: pascal Pa N/m^2 # pressure, stress
! 377: bar bar 1E5 Pa # pressure
! 378: mmHg mmHg 1.33322E2 Pa # pressure, millimeter of mercury
! 379: torr torr 1 mmHg # pressure
! 380: atm atm 760 torr # standard atmosphere
! 381: joule J N*m # energy, work, heat
! 382: electronvolt eV 1.6021892E-19 J # energy
! 383: calorie cal 4.1868 J # energy
! 384: Btu Btu 1.05506E3 J # energy
! 385: watt W J/s # power, radiant flux
! 386: coulomb C A*s # electric charge
! 387: volt V J/C # electric potential, electromotive force
! 388: ohm ohm V/A # electric resistance, use this in /ANS
! 389: ohm ohms V/A # electric resistance
! 390: ohm Ohm V/A # electric resistance
! 391: ohm Ohms V/A # electric resistance
! 392: siemens S 1/Ohm # electric conductance
! 393: farad F C/V # electric capacitance
! 394: tesla T V*s/m^2 # magnetic flux density
! 395: weber Wb V*s # magnetic flux
! 396: henry H V*s/A # inductance
! 397: radian rad m/m # plane angle
! 398: degree deg 1.745329E-2 rad # plane angle (Pi rad=180 deg)
! 399: steradian sr m^2 /m^2 # solid angle
! 400: lumen lm cd*sr # luminous flux
! 401: lux lx cd*sr/m^2 # illuminance
! 402: becquerel Bq 1/s # activity (radioactive)
! 403: gray Gy J/kg # absorbed dose (of radiation)
! 404: sievert Sv J/kg # dose equivalent (dose equivalent index)
! 405: astroUnit AU 1.49598E11 m # mean distance earth to sun
! 406:
! 407: \end{capacode}
! 408: %%%%
! 409: %%%%%%%%%%%
! 410: \end{enumerate}
! 411: \newpage
! 412: %%%%%%%%%%%
! 413: \begin{itemize}
! 414: \item {\bf Note:} The coded units are interpreted in the order of basic unit, derived unit, then prefix. For example, ``T'' will be matched against ``tesla'' instead of
! 415: considered the prefix ``T''. Another example is that ``min'' will match
! 416: ``minutes'' instead of treated as a combination of the prefix ``m'' and units
! 417: ``in''
! 418: \end{itemize}
! 419: %%%%%%%%%%%%%%%%%%%%%%%%%%%%
! 420: \end{itemize}
! 421: %%%%%%%%%%%%%%%%%%%%%%%%%%%%
! 422:
! 423:
! 424:
! 425: \subsection{\sf Quizzer}
! 426: \begin{itemize}
! 427: \item {\bf Location:} The {\sf Quizzer} application can reside in any directory and can be linked to a
! 428: directory within the user's path. For example, linking {\sf Quizzer} to {\sl /usr/local/bin} as was directed in the installation instructions makes the
! 429: application available to all users on the machine.
! 430:
! 431:
! 432: \item {\bf Function:} The major functions of the {\sf Quizzer}
! 433: application are:
! 434: \begin{itemize}
! 435: \item Create and edit problem set files
! 436: (for homework, quizzes, and exams),
! 437: named {\sl set1.qz},
! 438: {\sl set2.qz}, etc. which contain ASCII text only.
! 439: \item Edit existing question files in ASCII text.
! 440: \item Calculate and preview the answers generated by the problem
! 441: set code.
! 442: \item Preview the resulting problem sets in the following three
! 443: modes:
! 444: \begin{enumerate}
! 445: \item Enscript Mode: See how the problem set appears to
! 446: students who log into \capa\ through a terminal.
! 447: \item Tex: Preview the \LaTeX\ typeset.
! 448: \item Web: Preview the resulting problem set showing the coded
! 449: HTML flags.
! 450: \end{enumerate}
! 451: \item Create a {\sl set$x$.dvi} and view an image of the printe
! 452: student problem set.
! 453: \item Generate the database file ({\sl set$x$.db}) which contains the time constraints
! 454: on
! 455: the availability of the problem sets to students for a given
! 456: assignment. Each problem set must have an opening-date, a due-date,
! 457: and a date
! 458: when answers are available.
! 459: \item Print the problem set(s) for a student, for one or more sections, or for the entire class. (We recommend printing the \capa\ ID on student papers.
! 460: The {\sl HWTop} file included in the distribution does this already.)
! 461: \item Analyze set: This gives the low end, high end, and distribution of answers for problems in a set. This can be done for all students in a class or for a random sample of students.
! 462: \end{itemize}
! 463: \item{\bf Mandatory Files}:
! 464: {\sl set1.qz}, {\sl TeXheader}, {\sl TeXfooter}, and {\sl classl}.
! 465:
! 466: \begin {itemize}
! 467: \item {\bf set$x$.qz}: Problem set files are the files containing the coded
! 468: problems created by the
! 469: instructor for each given assignment. They are labeled {\sl
! 470: set1.qz}, {\sl set2.qz,} etc. There is a limit to 99
! 471: problem sets for each class.
! 472: \item {\sl TeXheader} and {\sl TeXfooter:} These files specify the
! 473: information needed by the \LaTeX\ formatter to create the
! 474: document for printing.
! 475: \item {\sl classl}: The class list file for each course using the system is the {\sl classl} file.
! 476: The maximum number of students in one class is 4096.
! 477: The format of the entries in the class list file is strict and
! 478: must correspond exactly to that in the
! 479: following example.
! 480: \newpage
! 481: \begin{capacode}
! 482: 123456789012345678901234567890123456789012345678901234567890123456789012345...
! 483: nsc 121 001 A12345678 Albertelli, Guy II albertel@pilot.msu.edu
! 484: nsc 121 001 A23592320 Berryman, Felicia V. berryma5@pilot.msu.edu
! 485: nsc 121 001 A73336318 Kashy, Edwin N. kashy@nscl.msu.edu
! 486: nsc 121 001 A87654321 Student, Jaimie .
! 487: \end{capacode}
! 488: {\bf Note:} The first row of digits is {\bf not} part of
! 489: the file but is given here to locate the information in
! 490: the file.
! 491: \begin {itemize}
! 492: \item The fields used by this system are:
! 493: \begin{enumerate}
! 494: \item Section number which appears in columns
! 495: $11$ to $13$
! 496: \item Student Number in columns $15$ to $23$
! 497: \item Student Name in columns $25$ to $35$
! 498: \item Student Email in columns $61$ to $101$
! 499: \end{enumerate}
! 500: The maximum number of characters in the Student Name
! 501: field is $30$. The course acronym and number
! 502: (in columns $1$ to $10$) are not used
! 503: by the system, but are convenient for recordkeeping.
! 504: The format of the file must be exact. The section number
! 505: is used for printing.
! 506: \item Each line, including the last line, must end with
! 507: a carriage return.
! 508: \item The period (.) added for students with no middle
! 509: names has facilitated importing \capa\ summaries into
! 510: some spread sheet programs
! 511: (i.e. Lotus) when preparing final grades for a course.
! 512: \end{itemize}
! 513:
! 514: \end{itemize}
! 515:
! 516: \item {\sl records} directory:
! 517: This folder must be present as a sub-directory of the
! 518: class directory. {\sf Quizzer} writes the date information from
! 519: {\sl set$x$.qz} in {\sl records/date$x$.db}. {\sf Capalogin} saves student
! 520: input from the telnet session for {\sl set$x$} in {\sl records/log$x$.db}. {\sf Capasbin} saves student input for
! 521: the web session for {\sl set$x$} in {\sl records/weblog$x$.db}. The summary
! 522: information from both {\sl log$x$.db} and {\sl weblog$x$.db} is written to {\sl set$x$.db }. Both {\sf Capalogin} and {\sf Capasbin} create a
! 523: {\sl set$x$} folder which contains other folders called {\sl problem$y$} if the set has a {\tt /SUBJECTIVE()} question. This folder contains files of the {\tt /SUBJECTIVE()} answer essays with student numbers
! 524: as their names.
! 525: The duration of student telnet sessions is saved in the file {\sl
! 526: records/duration.db}. As students login via telnet, a file named {\sl active.log} is created. It is used
! 527: to limit the number of concurrent telnet sessions per student. Also created are two files,
! 528: {\sl submissions$x$.db} and {\sl websubmissions$x$.db} which records all student entries. For a 500 student class having 11 assignments you can expect this directory to grow to approximately 35Mb in size. \\ \\
! 529: The above files are also used by {\sf Grader} and {\sf Manager} for generating statistics and summaries.
! 530:
! 531:
! 532: \item {\sf Qzparse} is an application separate from from {\sf Quizzer}.
! 533: It's functions though can now be done using {\sf Quizzer} in \capa\ 5.0.
! 534: \begin{itemize}
! 535: \item {\bf Functions}: {\sf Qzparse} can be used to generate the .tex files
! 536: needed to prepare problem sets in a batch mode without using {\bf
! 537: quizzer}. It can create one output file for an entire section or a
! 538: multiple number of sets for a given student. The output file can then be
! 539: processed by \LaTeX\ and {\sf Dvips} to produce a postscript file for
! 540: printing. The options of {\sf Qzparse} are displayed by
! 541: typing {\tt qzparse -h}.
! 542: \begin{capacode}capa2.nscl.msu.edu> qzparse -h
! 543: USAGE: qzparse [ -[T|H|A][a|b] ] [-Sec [n|n:m] | -Stu sn [-o filename] ]
! 544: [ -Set [n|n:m] ] [-c path_to_class] [-d outputdirectory]
! 545: Example 1: qzparse -Tb -sec 2:3 -set 2:5
! 546: will generate tex files with both questions and answers
! 547: for sections 2 to 3, sets 2 to 5
! 548: Example 2: qzparse -Ha -stu A12345678 -set 3
! 549: will generate html files with answer only
! 550: for student A12345678 set 3
! 551: -T = tex mode
! 552: -H = html mode
! 553: -A = ascii mode
! 554: = default question only
! 555: a = answer only
! 556: b = both question and answer
! 557: -Sec 3 = for section 3
! 558: -Sec 3:7 = from section 3 to section 7
! 559: -Stu A12345678 = for a specified student
! 560: -Set 1 = output set 1
! 561: -Set 3:4 = output from set 3 to set 4
! 562: -c class_path
! 563: -o output_filename_with_absolute_path (only for a student)
! 564: -d directory_to_create_files_in (default is class_path/TeX)
! 565: -------This is version 5.0.3 @ 11:23-Apr-07-1999
! 566: ------------------------------------------------------
! 567: \end{capacode}
! 568: \item Examples:
! 569: \begin{enumerate}
! 570: \item For preparing TeX files for set 4 papers for all students
! 571: in sections 1 thru 45: \\
! 572: {\tt qzparse -T -sec 1:45 -set 4 }
! 573: \item For preparing papers which only contain the answers of a
! 574: particular set for all students in section 3: \\
! 575: {\tt qzparse -Ta -sec 3 -set 4}
! 576: \item For preparing set 1 thru 5 for a student with student
! 577: number A87654321:\\
! 578: {\tt qzparse -T -stu A87654321 -set 1:5 }
! 579: \item For preparing set 1 for a student with student
! 580: number A87654321, with the output file {\sl A87654321.tex}
! 581: placed in the {\sl /usr/users/teacher} directory.\\
! 582: {\tt qzparse -T -stu A87654321 -set 1 -d /usr/user3/teacher}
! 583: \end{enumerate}
! 584:
! 585: \item {\bf Files}: {\sf Qzparse} uses the same files as {\sf Quizzer}. In
! 586: addition, running {\sf Qzparse} will create a {\sl TeX} sub-directory in the
! 587: class directory. {\sf Qzparse} will write output files such as {\sl section1-set1.tex} or {\sl a87654321.tex} to this directory.
! 588: The {\sl .tex} files must be passed through
! 589: \LaTeX\ and the {\sf dvips} codes to make postscript files for printing.
! 590: (See guided tour of {\sf Qzparse} for explanations on how this is
! 591: accomplished.)
! 592: \end{itemize}
! 593: \end{itemize}
! 594: %
! 595: \subsection{{\sf Capalogin}, {\sf Capahtml}, and {\sf Capasbin}}
! 596: \begin{itemize}
! 597: \item {\sf Capalogin}
! 598: \label{capalogin}
! 599: \begin{itemize}
! 600: \item {\bf Function}: The main function of the {\sf Capalogin} code is
! 601: to handle remote sessions of the students who access \capa\ with VT100
! 602: terminals. The code is run instead of a UNIX shell in order to allow
! 603: large numbers of students to easily login while controlling their access
! 604: to the data files.
! 605: {\sf Capalogin} queries active.log if the student is already logged-on in this
! 606: class. If the student is already logged in, then a warning message is
! 607: sent
! 608: (see below) and the student is allowed in to the system. If the student
! 609: has opened 2 sessions without exiting properly, the student is not allowed
! 610: into the system and is sent a different warning message.
! 611:
! 612: \item {\bf Files:} The instructor can send general information to
! 613: the entire class by typing messages into certain files. The
! 614: login-specific files, {\sl welcome.msg} and {\sl goodbye.msg}, (and if needed
! 615: the {\sl help.msg}, {\sl second-login.msg}, and {\sl third-login.msg}), can
! 616: be edited to send information to students, reminding them of deadlines
! 617: or of exam dates, telling them to disregard a particular problem (when a serious
! 618: error has been made in coding), etc. Note that the instructor can
! 619: code hints and explanations for individual problems directly in the
! 620: set$x$.qz files.
! 621: Files and their functions are listed below:
! 622: \begin{tabbing}
! 623: 123456789012345678 \= 12345\=67890 \kill
! 624: {\sl welcome.msg} \> $\Rightarrow$ The message displayed to the student
! 625: upon login. \\
! 626: {\sl help.msg} \> $\Rightarrow$ The message displayed when the student
! 627: selects the menu item {\tt Help}. \\
! 628: {\sl goodbye.msg} \> $\Rightarrow$ The message displayed after a student
! 629: selects menu item {\tt eXit}. \\
! 630: {\sl second-login.msg} \> $\Rightarrow$ The message displayed when a student already is logged on and \\
! 631: \> tries to begin a second session.\\
! 632: {\sl third-login.msg} \> $\Rightarrow$ The message displayed when a student already is logged on twice \\
! 633: \> and tries to begin a third session.\\
! 634: {\sl capa.config} \> $\Rightarrow$ Controls the functions as described in the {\sl capa.config} section.\\
! 635:
! 636: \end{tabbing}
! 637: \end{itemize}
! 638:
! 639: \item{\sf Capahtml}
! 640: \begin{itemize}
! 641: \item {\bf Functions}: The major functions of {\sf Capahtml} are to:
! 642: \begin{itemize}
! 643: \item Authenticate the student number and \capa\ ID entered
! 644: by the student and generate the main menu page
! 645: after verifying them.
! 646: \item Produce the page that contains the corresponding problem set when a
! 647: student selects ``Try current set'' button from the main menu page.
! 648: \item Display a summary of student grades when
! 649: ``Term summary'' button is selected.
! 650: \end{itemize}
! 651: \end{itemize}
! 652: \item {\sf Capasbin}
! 653: \begin{itemize}
! 654: \item {\bf Functions}: The major functions of {\sf Capasbin} are to:
! 655: \begin{itemize}
! 656: \item Check the correctness of answers submitted by the student.
! 657: \item Give the appropriate response to a student's entry and
! 658: display the correct answer when the entry is satisfactory.
! 659: \end{itemize}
! 660: \end{itemize}
! 661: \end{itemize}
! 662: \subsection{\sf Grader}
! 663: \begin{itemize}
! 664: \item {\bf Functions}: The major functions of {\sf Grader} are to:
! 665: \begin{itemize}
! 666: \item Display a summary of student grades and \capa\ ID numbers
! 667: for any problem set.
! 668: \item Generate the reports found in the {\sl records} directory.
! 669: \item Grade subjective answers, such as essays entered in
! 670: through the \capa\ system.
! 671: \item View a summary of a students login file (the problems
! 672: correct vs. incorrect) with their \capa\ ID for that set.
! 673: \item Grade hand-graded problems for a student while viewing
! 674: the correct answers.
! 675: \item Generate grade reports for a student, a section, or for
! 676: the entire class.
! 677: \item Excuse a problem for the class.
! 678: \end{itemize}
! 679: \item {\bf Files}: {\sf Grader} reads the {\sl classl} file and the
! 680: files in the {\sl records} directory generated by {\sf
! 681: Quizzer} and {\sf Capalogin} and/or {\sf Capasbin}. The reports created by
! 682: {\sf Grader} are put into the class directory.
! 683: The reports for the entire class are labeled {\sl ClassSet1.rpt} and
! 684: reports for a section are labeled {\sl Sec1Set1.rpt}.
! 685: They should be renamed if permanent records are required, i.e., a subsequent
! 686: {\sl ClassSet1.rpt} file will overwrite any previous {\sl ClassSet1.rpt}. Grader also writes a file called {\sl gradingstatus} to the {\sl records/set$x$} directory.
! 687: \end{itemize}
! 688:
! 689: \subsection{\sf Manager}
! 690: \begin{itemize}
! 691: \item {\bf Functions}: The following are functions of {\sf Manager}:
! 692: \begin{enumerate}
! 693: \item {\bf Manage Classl}. A convenient way to edit the classl file (add student, delete, sort, find, change section, merge, etc.). Don't forget to "save" after making a change.
! 694:
! 695: \item {\bf Scoring} Included in {\sf Manager} is a utility
! 696: called {\sf Scorer}
! 697: which the instructor uses to import a score report from a
! 698: machine scored scantron individualized exam and grade that
! 699: \capa\ generated exam where the correct pattern differs
! 700: for each student. Up to 50 questions can be included in a quiz or exam.
! 701: The information on the score report file is shown below:
! 702: \begin{capacode}
! 703: Sample format for one student, 3 capa questions
! 704: Character numbers begin with zero!
! 705: 0 1 2 3 4 5 6 7 8 9
! 706: 0123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
! 707: 515000012001090999003 5327 #0001 BERRYMAN F A23592320002EDEIAI 1 1 1 1 111 1
! 708:
! 709: start end Example:
! 710: SerialNumber { 5 8 } Exam above was the 12th exam to be scored
! 711: LastName { 40 49 } BERRYMAN as last name.
! 712: FirstInitial { 50 50 } F as first initial
! 713: StudentNumber { 56 64 } student number is A23592320
! 714: Section { 65 67 } entered section 002 on scantron sheet
! 715: CapaID { 68 73 } CapaID+ This is a six letter code which is printed on each
! 716: student's exam. There is a space to enter the code on the
! 717: scantron sheets (available from MSU). Here, the code was EDEIAI
! 718: Question 1 { 76 85 } (starting at character 76, the student's response is recorded.
! 719: Question 2 { 86 95 } The CAPA scantron form is has 10 bubbles with choices labeled
! 720: Question 3 { 96 105 } both numerically and alphatically 1 through 10 and A through J.
! 721: .....
! 722: Question 50 {566 575 } Each question is 10 columns and there are 50 possible questions.
! 723: Each column for a question must have either a space or a 1
! 724: 1 means it was marked, space means it wasn't.
! 725: \end{capacode}
! 726: Scorer puts the results of the scoring into a setX.sb file which the user may
! 727: view to acertain that the scores are reasonable. The user can have the code also write the file to setX.db, at which time the students may see their grades.
! 728:
! 729: \item Print one or more assignments for a student without
! 730: having to open the {\sl set$x$.qz} file in {\sf Quizzer}. You can choose the student by either name or student number.
! 731: \item Randomize a user made seating file for assigned seating
! 732: in exams.
! 733: \item Use {\sf Manager} to access {\sf CapaUtils 1.1} which performs the following functions:
! 734: \begin{enumerate}
! 735: \item View summarized log files.
! 736: \item Run statistics on a set.
! 737: \item Generate a student course profile which summarizes all
! 738: data from the class, exam, quiz, supplementary, and others
! 739: paths.
! 740: \item Get \capa\ IDs for one student or the entire class.
! 741: \item Analyze the problems in the set and see how each problem
! 742: discriminates between the upper and lower percents of the class, the correlation between different problems, and what degree of
! 743: difficulty each problem had for your class.
! 744: \item View the exact submissions a student enters into a telnet
! 745: and Web session.
! 746: \item Analyze a class report generated in grader and view the
! 747: distribution of correct verses incorrect.
! 748: \item Analyze and generate the output generated by scorer.
! 749: \end{enumerate}
! 750: \end{enumerate}
! 751: \item {\bf Files}: {\sf Manager} reads the classl file, instructor
! 752: generated seating files, and files generated from machine scoring. {\sf CapaUtils} reads report files in the class name directory and files
! 753: found in the {\sl records} directory.
! 754: \newpage
! 755: \item An older version of {\sf CapaUtils} can be accessed
! 756: through a terminal.
! 757: \begin{footnotesize}
! 758: \begin{verbatim}
! 759: capa2.nscl.msu.edu> capautils.pl
! 760: USAGE: capatools.pl -c Full_path_to_class
! 761: Please enter the CLASS absolute path:
! 762: /usr/users/teacher/CAPA5/nsc121s9
! 763:
! 764: +-----------------------------------------------+
! 765: | Welcome to CAPA Utilities Ver 1.0 |
! 766: +-----------------------------------------------+
! 767:
! 768: +------/usr/users/teacher/CAPA5/nsc121s9--------+
! 769: | |
! 770: | 1: Change class path |
! 771: | 2: Run capastat |
! 772: | 3: Log analysis on Y, N, S, U, and u |
! 773: | 4: Student course profile |
! 774: | 5: CAPA IDs for one student |
! 775: | 6: All CAPA IDs |
! 776: | 7: Item analysis |
! 777: | 8: Item correlation |
! 778: | 9: Print assignment(s) for a student |
! 779: | 10: View submissions for a student |
! 780: | 11: Quit |
! 781: | |
! 782: |SELECT: |
! 783: +-----------------------------------------------+
! 784: \end{verbatim}
! 785: \end{footnotesize}
! 786: \item \capa\ IDs can also be generated through the terminal using the function
! 787: {\sf AllCapaID}.
! 788: \begin{footnotesize}
! 789: \begin{verbatim}
! 790: capa2.nscl.msu.edu> allcapaid -h
! 791: USAGE: allcapaid [-s start-set] [-e end-set] [-stu student-number] [-c class-dir
! 792: ectory] [-d output-directory] [-h] [-i] [-sec [n|n:m]]
! 793: start-set : default 1
! 794: end-set : default 10
! 795: student-number : no default
! 796: class-directory : no default
! 797: output-directory: class-directory/capaID
! 798: -Sec 3 : for section 3
! 799: -Sec 3:7 : from section 3 to section 7
! 800: -i : don't create files, print to the screen
! 801: -h : prints this message
! 802: CAPA version 5.0.3, 11:23-Apr-07-1999
! 803: \end{verbatim}
! 804: \end{footnotesize}
! 805: \end{itemize}
! 806:
! 807:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to s-swcomps.tex CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / capa / capa51 / Manual