Return to s-swcomps.tex CVS log

Up to [LON-CAPA] / capa / capa51 / Manual

- added the manual

    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: