Return to s-guidedtour.tex CVS log

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

- added the manual

    1: %
    2: %
    3: %******************************************************************************
    4: % Guided Tour
    5: %*******************************************************************************
    6: \newpage
    7: \hrule 
    8: \vskip 0.2in
    9: %{{\noindent \bf \it \LARGE Section 4: Guided Tour of the \capa\ v. 5.0 System }}
   10: \section{Guided Tour of the \capa\ System }
   11: \vskip 0.2in
   12: \hrule 
   13: \vskip 0.2in
   14: \noindent This section presents a guided tour through the \capa\ software system by relying on the files that are part of the
   15: distribution package.  This tour assumes that the user is logged in as 
   16: ``teacher'' and owns the {\sl nsc121s9} class directory.  If you do not have
   17: permission to login as ``teacher'', you will be unable to complete sections of 
   18: the tour which involve writing files to the ``teacher'' owned directories 
   19: (i.e. creating {\sl .db} headers and {\sl .dvi} files, printing, generating class records, etc.).
   20: \footnote{\fbox{Boxed} items denote Clicking on a Menu selection}
   21:   
   22: \begin{enumerate}
   23: \item {\bf  Guided Tour of {\sf Quizzer}} \hfil
   24: \epsffile{figures/quizzer50.ps} \label{GQuizzer}
   25: 
   26: 	\begin{itemize}
   27: 	\item Instructions for running the {\sf Quizzer} application:
   28: 		\begin{itemize}
   29: 		\item Prior to opening the {\sf Quizzer} application,  set up your X-server software to
   30: 		interact with your server.  See the section on using \capa\ via
   31: 		eXceed, X-win32 or MacX.
   32: 	\item Through your X-server software, open an rlogin (or telnet)
   33: 		session to your server.			
   34: 		\item Start the application by entering the command {\sf
   35: 		Quizzer} at the prompt.
   36: 		\end{itemize}
   37: 	\item Select the Source of the problem set. 
   38: 		\begin{itemize}
   39: 		\item The {\sf Quizzer} main menu will be placed in the upper
   40: 		left corner of your screen.
   41: 		\item Select \fbox{File}, then \fbox{Open}.
   42: 		\item A pop-up screen displaying your
   43: 		current directory will allow you to browse. 
   44: 		The file filter, which for quizzer will read {\sl *.qz},
   45: 		selects only {\sl setx.qz} files  for editing with the {\sf Quizzer} application.
   46: 		
   47: \item In this pop-up screen, open the \fbox{CAPA5} directory.
   48: \item Find and select the sample class file \fbox{nsc121s9}.
   49: 		\item Open the \fbox{set1.qz} file.  ({\sl set1.qz}
   50: 		is identical to the Set of Sample Problems in
   51: 		this manual).  
   52: 		\item The contents of this file will show up in  
   53: 		{\sf Quizzer's} editing window.  
   54: 		Browse through the contents of this question file. Be careful
   55: 		not to make any changes at this time, or at least {\bf not} 
   56: 		to Save any changes.  If you think you did accidently make changes, choose \fbox{Quit} from the main menu and click \fbox{No} if you are asked to save. 
   57: 		\item Click on a highlighted imported file.  A reference file pops up in a new window.  Close this window by choosing \fbox{File} then \fbox
   58: {Close}.  A dialog box will appear to confirm your selection.
   59: 		\item You may wish to use the \fbox{Save As...} under \fbox{File} in the menu option and save the set as {\sl set99.qz}, then close it and open {\sl set1.qz} again.
   60: 		\item If you make an inadvertent change or
   61: 		if you are not sure of a change, then just \fbox{Quit} the {\sf
   62: 		Quizzer} application without saving and restart it by entering the command {\sf Quizzer}.
   63: 		\end {itemize}
   64: 	\item Preview the example question file in enscript mode.
   65: 		\begin {itemize}
   66: 		\item Choose \fbox{Enscript} mode button from the options at the top of the
   67: 		{\sf Quizzer} edit window.
   68: 		\item Click the \fbox{Preview} button.  A dialog window will
   69: 		appear to ask you to select a specific 
   70: 		student from the class list.  The choice may be made by randomly
   71: 		selecting a student from a specified section or by entering the 
   72:                 student number of a particular student in the class.
   73: 		    \item Before previewing, click \fbox{File} in the menu and select \fbox{Open Reference File...}. Find and open the \fbox{classl} file in the {\sl nsc121s9} folder.  You will see all the students in the class, including ``Student Jamie .'' Select \fbox{Close} under the \fbox{File} menu in the {\sl classl} 
   74: file window.
   75: 		\item Select the random-selection button and click \fbox{Preview}. 
   76: 		\item Note: To  select a specific student, first, click  the
   77: 		\fbox{Preview} button, select \fbox{Specify the student by}, and then enter the 
   78: 		Student Number {\tt A87654321} into the text entry panel {\em
   79: 		followed by a carriage return}. If the Student 
   80: 		number is not in the class list file  ({\sl
   81: 		teacher/CAPA5/nsc121s9/classl}) an error message is returned.
   82: 		\item A preview window will appear. This window displays the
   83: 		text 
   84: 		from the translated question file as it would be presented to
   85: 		the students during a terminal session.  
   86: 		The instructor can use this display to determine if the coding
   87: 		is correct and if the presentation on the 
   88: 		remote terminal  will be adequate.  
   89: 		\item If any changes  have been made to 
   90: 		the {\sl set1.qz} file in the editor, {\sf Quizzer} will ask you to
   91: 		save the file. {\bf Don't} save the
   92: 		file at this point unless you are absolutely sure that the file
   93: 		has not been damaged, instead select \fbox{Cancel}, 
   94: 		\fbox{Quit} {\sf Quizzer}, answer \fbox{No} if asked to save, and start again.
   95: 		\end {itemize}
   96: 		\item Close the preview window by clicking on the \fbox{Dismiss}
   97: 		button at the top of the window.
   98: 	\item Preview the example question file in \TeX\  mode.
   99: 		\begin {itemize}
  100: 		\item Change the {\bf Mode} of the preview output by clicking on
  101: 		the \fbox{TeX} mode button on the upper part 
  102: 		of edit window and then click the \fbox{Preview} button as
  103: 		before. 
  104: 		\item Select a particular student, this time type the student
  105: 		number {\tt A87654321} into the text panel, 
  106: 		then $<$return$>$, select the \fbox{Specify the student by} button, and click \fbox{Preview}. 
  107: 		\item  The preview window will
  108: 		display the contents of the 
  109: 		{\sl nsc121s9/quiztemp.tex}  file that will be used later by
  110: 		\LaTeX\ to typeset the problem set for the 
  111: 		selected  student, in this case ``Jamie Student''. 
  112: 		\item Click on \fbox{Dismiss} to close this window.
  113: 		\end {itemize}
  114: 		\item Preview the set of sample problems in Web mode similar to how enscript and \TeX\ modes were viewed. 
  115: 			\begin{itemize}
  116: 			\item This mode will generate a preview window displaying
  117: 			the web specific version of your source file.  (This is not
  118: 			the complete {\sl .html} file.) 
  119: 			\end{itemize}
  120: 	\item Specify the date limits in the database header. 
  121: 		\begin {itemize}
  122: 		\item The database header (DB header) for {\sl set1.qz} is present
  123: 		from the distribution.  However, you can 
  124: 		bring up a window to modify that information by clicking on the
  125: 		\fbox{DB Header} button at the top of the 
  126: 		main edit window.  {\bf Note}:  You must preview the set 
  127: 		in enscript prior  to
  128: 		setting or changing the DB Header information.  (We have already done this.)  
  129: 		Three dates and times must be set:
  130: 			\begin{enumerate}
  131: 			\item {\bf Open date/time}: when the students can begin
  132: 			to enter answers to this problem set.
  133: 			\item {\bf Due date/time}: the time by which students
  134: 			must finish entering answers and properly 
  135: 			log out of \capa, i.e., when all answer-recording stops.
  136: 			\item {\bf Answer date/time}: when the answers to the
  137: 			problems will be made available to the 
  138: 			students.  This should be {\em after} the Due
  139: 			date/time.
  140: 			\end{enumerate}
  141: 		
  142: 		\item Use  \fbox{Load} to view the current values for
  143: 		this problem set.  If the values were not present in the 
  144: 		{\sl set1.db} file, you would have recieved a warning.   
  145: 		\item Setting the DB Header is necessary for each new problem
  146: 		set before students log in.  
  147: 		Without the proper date information, students will not be
  148: 		allowed to enter their answers.  
  149: 			\begin{enumerate}
  150: 			\item The database header may be set as the number of problems change, but it {\em must} be
  151: 			set  {\em after} the number of problems in the set is 
  152: 			finalized, otherwise serious errors in the grade records
  153: 			will occur.  If you have found it
  154: 			necessary to make major changes in your source file,
  155: 			such as changing the problem value or
  156: 			the grading option to hand graded ({\tt hgr=on} inside 
  157: 			the {\tt /ANS()} command)
  158: 			be certain to reset the DB Header prior to
  159: 			printing the final version for distribution to your
  160: 			students.
  161: 			\item  Once  the
  162: 			problem sets have been distributed to students and students begin logging in, 
  163: 			do {\em not} change the number of problems in the set
  164: 			and reset the database header.  
  165: 			\end{enumerate}
  166: 		\item The dates and times must be entered with the numerical
  167: 		format of {\tt YYYY/MM/DD} and {\tt HH:MM} on the appropriate
  168: 		lines.  The hours of the day are based on a 24 hour clock.
  169: 		\item You can specify different dates for different sections.  Click on \fbox{Add} and add different due dates for section 1.  You can also choose to get the default dates for section 1.  
  170: 		\item In the ``adddate'' window, click on \fbox{More Options}.  You can then add a duration time in hours and minutes.  This lets the student choose their own due date.  Once the students log in, they only have the set duration of time to work one the set (such as on a take home quiz).  You also have the choice to give your students no feedback by inhibiting correct/incorrect responces.  Click \fbox{Cancel} to not change any of the options.
  171: 		\item The ``Creating DB Header'' window also has a cancel button to exit the window without
  172: 		changing the dates already present in the records folder.
  173: 		Close the ``db Header'' window by selecting \fbox{Cancel}.
  174: 		\end{itemize}
  175: 	\item Viewing the file as it will be printed. 
  176: 		\begin {itemize}
  177: 		\item  
  178: 		Select \fbox{Create .dvi} from the main {\sf Quizzer} menu.  
  179: 		(The creation of a {\sl *.dvi file} is a necessary 
  180: 		step before printing any \TeX\ document.) There are no {\sf
  181: 		Quizzer} errors in the {\sl set1.qz} file, and
  182: 		{\sf Quizzer} will generate a file called {\sl
  183: 		quiztemp.tex} 
  184: 		\item  You will
  185: 		again be prompted to select either a random student or a
  186: 		specific student determined by student number.  Make your choice, then click \fbox{Preview}.
  187: 		\item {\sf Quizzer} invokes the \LaTeX\ program to typeset the 
  188: 		{\sl quiztemp.tex} file.
  189: 		\item {\sf Quizzer}  will create the 
  190: 		{\sl quiztemp.dvi} file for viewing the appearance of the printed document.  You should now have two new windows open.  The {\sl quiztemp.dvi} file is automatically
  191: 		opened and displayed once it is created. 
  192: 		This process takes only a few seconds to complete depending on
  193: 		the computer. All of the {\sl quiztemp.*} files are in the
  194: 		{\sl nsc121s9/} directory.  The quiztemp files are rewritten every time a new {\sl .dvi file} is created.
  195: 		\item After you are done viewing both windows, dismiss the \LaTeX\ output window and the quit the quiztemp window.
  196: 		\item Note that new problem sets may have coding errors in their \capa\
  197: 		grammar, \LaTeX\ grammar, or HTML grammar.
  198: 		These are independent languages.  Therefore, previewing in 
  199: enscript, creating a {\sl .dvi} file, and viewing the problem set in a web browser are necessary to detect and locate each kind of error.
  200: 		
  201: 		\end{itemize}
  202: 
  203: 
  204: 	\item Printing the set of sample problems through {\sf Quizzer}. 
  205: 		\begin {itemize}
  206: 		\item From the main {\sf Quizzer} menu, choose \fbox{Print...}.
  207: 		\item The pop-up screen will indicate your options.  Choose one of the following:
  208: 			\begin{enumerate}
  209: 			\item \fbox{Print current .dvi}: This option will print
  210: 			the most recent .dvi file you have generated using
  211: 			the ``Create .dvi'' menu option, i.e. the {\sl quiztemp.dvi} file listed in your
  212: 			directory.
  213: 			\item \fbox{Randomly select one student from section}:  This will generate a random assignment from the section you specify to be
  214: 			printed.
  215: 			\item \fbox{Specify the... Student Number}:  This will print out a set for the specified student.  Once the
  216: 			student number is entered into the field, be certain to
  217: 			press $<$return$>$ to call the student name from the
  218: 			{\sl classl} file.
  219: 			\item \fbox{Print section}:  This will print the
  220: 			entire specified section's papers.
  221: 			\item \fbox{Print multiple sections}:  This will open
  222:  a menu for choosing the sections to be printed.	
  223: 		\item \fbox{Print whole class}:  This option will print
  224: 			the assignments for the entire class.
  225: 			\end{enumerate}
  226: 			\item {\bf Note:} Once you 
  227:                         have entered a command for
  228: 			printing, another pop-up screen will appear
  229: 			allowing a choice of printers.  The printer options are 
  230: 			defined in the {\sl capa.config} file. (See discussion of {\sl capa.config file} in the Software Components section.)
  231: 			\item Click \fbox{Select} and then click \fbox{Print} in the ``Print Command'' window.  You may also have a choice of printers and printing options to choose from in this window.	
  232: 			\item After the printing has finished, note the \capa\
  233: 			ID number at the top of the printed page.
  234: 			\end{itemize}
  235: 		\item Viewing the set on the Web
  236: 			\begin{itemize}
  237: 			\item Open a browser and point it to the approriate class.html URL
  238: 			\item Select the class {\sl nsc121s9} by clicking on ``class'' box and selecting {\sl nsc121s9} from the drop-down menu.  This will allow you to view "Jaime Student's" problem set 1.
  239: 			\item Enter {\tt A87654321} for the student number and {\tt 2318} for the CAPA ID
  240: 			\item Click on the button to try the problem set.  Close the browser when you are done browsing.
  241: 			\end{itemize}
  242: 		\item Other {\sf Quizzer} main menu items:
  243: 			\begin{itemize}
  244: 			\item All {\sf Quizzer} submenus can be ``torn off". 
  245: 			The submenus have a dashed line at the top.  If you
  246: 			click on the dashed line, the submenu becomes a
  247: 			separate, static window which can positioned anywhere
  248: 			on
  249: 			your screen.
  250: 			\item \fbox{File}:  This was discussed above, but also includes ``Open Reference File'' a useful
  251: 			option allowing copying and pasting from any file into the quiz set.
  252: 			\item \fbox{Edit}:  This submenu contains the standard
  253: 			editing commands (cut, copy, paste, select all, undo, 
  254: 			and find).  The \fbox{Find} option allows you to find 
  255: 			and/or replace using different criteria.  
  256: 			\item \fbox{Prefs}:  This feature can be used to
  257: 			choose what style of output is displayed, such as				just problems, problems and answers, or
  258: 			answers only. This also determines what is
  259: 			printed on the paper through the print command, so be
  260: 			certain to set it to ``problems
  261: 			only" prior to
  262: 			printing the entire classes papers.  You can also edit
  263: 			the HTML and \TeX\ header and footer files through the
  264: 			preferences menu by clicking on the menu that displays 
  265: 			\fbox{HTMLheader}.  However, for most applications of 
  266: 			\capa\, you should not need to edit these files.
  267: 			\item \fbox{Windows}:  This submenu displays all the
  268: 			currently open windows in the {\sf Quizzer}
  269: 			application.  If ever a smaller window is hidden by a
  270: 			larger one, you can shuffle the smaller window to the
  271: 			top by selecting it in this menu.
  272: 
  273: 			\item \fbox{Analyze Set}:  This allows you to view the
  274: 			range of anwers a certain problem will generate.  While
  275: 			{\sl set1.qz} is open, select \fbox{Analyze Set}.  From
  276: 			the new window, select
  277: 			\fbox{Run Random}, enter the number 10, then click 
  278: 			\fbox{continue}.  When the set is finished being
  279: 			analyzed, you can select different problem numbers and
  280: 			view the range of answers generated for the \capa\
  281: 			problems.  Dismiss this window and try it again, but 
  282: 			this time select \fbox{Run Class}.
  283: 			\item \fbox{Remap}:    You have the option of remapping
  284: 			either the
  285: 			backspace or the delete key to suit your particular
  286: 			preference.
  287: 			\fbox{Xdvi Options}:  This allows you to resize the
  288: 			display of the {\sl .dvi} file on your monitor.  These
  289: 			changes will not affect printing.
  290: 
  291: 		\end{itemize}
  292: 	\item Select \fbox{Quit} from the menu to leave the {\sf Quizzer} 
  293: 	program.
  294: 	\item A ``MakeSure Prompt'' window will appear.  You have the option \fbox{Cancel}  to continue
  295: 	editing or \fbox{Yes} to quit {\sf Quizzer}.  If you made changes, you
  296: will be asked if you want to save them.  Answer \fbox{No} at this time.
  297: 	\item The {\sf Quizzer} main menu then disappears.
  298: 	\end{itemize}
  299: \item {\bf  Guided Tour of \large \sf Capalogin} \label{Gcapalogin}  
  300: 
  301: After the instructor has created a question set ({\sl set1.qz} in this 
  302: example) and  the {\sl records/set1.db} file has the relevant dates and
  303: times, students can login through the network.  The students can use equipment
  304: or a communication program that emulates a vt100 terminal to enter their
  305: answers and view the hints.  Note that the emulation is very specifically 
  306: vt100 and not vt102, vt200, etc.  
  307: 
  308: At Michigan State University, the students log into the system from a large
  309: number of remote locations on and off campus.  They have used a variety of
  310: computers, IBM, Mac, etc., that emulate a vt100 terminal.  For the guided tour,
  311: you will open a terminal window on your host computer.
  312: 
  313: 	\begin{itemize}
  314: 	\item Login Instructions: An example of a login instruction handout
  315: 	which has been used at MSU is included in 
  316: 	the next section of this manual. 
  317: 	\item A student logs in by entering the class account user name, such as
  318: 	{\tt nsc121s9}.  This account does not have a password. Therefore,
  319: 	anyone can get in, but they are `captured' by the code {\sf Capalogin}
  320: 	and have limited access to the machine (see details in
  321: 	the software component section).
  322: 	\item The student is then asked to enter his or her student number and
  323: 	the  \capa\ ID  number of any assignment.   
  324: 		\begin{itemize}
  325: 		\item The student number has 9 characters. At MSU the last 8 are
  326: 		digits, but the 9 characters can be a mixture of digits and letters. The 
  327: 		\capa\ ID number is unique for each problem set for a given
  328: 		student in a given course.  It has 4 digits 
  329: 		and will be printed on a student's individual assignment sheet. 
  330: 		\item Each student has a different \capa\ ID number for each
  331: 		problem set.  The {\sf Capalogin} code will 
  332: 		select the {\sl set$x$.qz} file that corresponds to the CAPA ID.
  333: 		 Previous sets can be reviewed anytime.
  334: 		\item If the current date and time are within the allowed time
  335: 		range specified in the DB Header file, 
  336: 		students can enter their answers. The answers are recorded  as they are submitted.  
  337: 		\item Problems arise when students open multiple sessions.   If
  338: 		two sessions for one student 
  339: 		are active at the same time, the computer records the
  340: 		distribution of correct and incorrect answers of 
  341: 		the last session to log-out, not necessarily the session with
  342: 		the most credit earned. This is one the reasons for  
  343: 		 limiting the number of active sessions by one student. 
  344: 		\end{itemize}
  345: 	\item {\bf Sample login:[A]} 
  346: 		\begin{itemize}
  347: 		\item Exit your server and then open a new telnet (or {\bf rlogin}) session into the server.  The method for this
  348: 		varies depending upon the type of
  349: 		X-server software being used.  (See  Section 3 on
  350: 		configuration of X-server software.)
  351: 		\item At the prompt {\tt login:}, enter the classname.  Example:
  352: 		 {\tt nsc121s9}
  353: 		\item The capalogin screen will be displayed.
  354: 		\item Enter: {\tt A87654321} for the student number and then hit			$<$return$>$. Note that
  355: 		the cursor should be positioned after
  356: 		 the colon following the words {\tt Student Number} near the
  357: 		 middle of the screen.  If it is not, 
  358: 		 particularly if it is at the bottom of the screen, the
  359: 		 terminal emulation is not vt100 and 
  360: 		 needs to be reset in the terminal emulator. 
  361: 		\item Enter {\tt 2318}, the CAPA ID printed on the homework page
  362: 		for student A87654321. The CAPA ID 
  363: 		number must correspond to the one printed on the problem set for
  364: 		this student,  or the login will not be 
  365: 		allowed. 
  366: 		\item The student's name is displayed at the top of the screen
  367: 		and the main \capa\ menu near the center. 
  368: 		\item Enter: {\tt S} (or {\tt s}, as the menu is not case
  369: 		sensitive) to view the student's summary for 
  370: 		the course. No credit should have yet been earned. 
  371: 		\item Enter: {\tt M} to return to the main menu.
  372: 		\item Enter: {\tt T} to try the problem set. 
  373: 		\item Enter: {\tt 1} to try problem 1.
  374: 		\item Problem 1 of set 1 will appear on the screen.
  375: 		\item Follow the instructions, noting that if you put in a wrong
  376: 		answer, a {\tt :H} to receive a hint may 
  377: 		become an option.  Note that the colon in this screen
  378: 		differentiates a command from a problem answer.
  379: 		\item After answering a few questions, enter {\tt :m} to return
  380: 		to the main menu.
  381: 		\item Enter: {\tt s} You can now see the updated student
  382: 		summary. 
  383: 		\item Enter: {\tt x} to exit.  This ends the session, records
  384: 		the student responses, and closes the
  385: 		connection to the server.  The {\sl goodbye.msg} file is then
  386: 		displayed .
  387: 		\end{itemize}
  388: \item {\bf Sample login:[B]} 
  389: 		\begin{itemize}
  390: 		\item Open a web browser session into the server.  
  391: 		\item Select the sample class {\sl nsc121s9} from the pop-up menu.
  392: 		\item Enter: {\tt A87654321} for the student number. Note that
  393: 		you must click in the window.  
  394: 		\item Enter the \capa\ ID {\tt 2318} (as was printed on the homework page
  395: 		for student number A87654321). The \capa\ ID 
  396: 		number must correspond to the one printed on the problem set for
  397: 		this student,  or the login will not be 
  398: 		allowed. 
  399: 		\item Click on the `` Click \fbox{here} to work on \capa\ '' 
  400: button.
  401: 		\item  The next document you will see will be the main menu where you can select to try the current
  402: 		problem set.
  403: 		\item Set 1 will appear on the screen.
  404: 		\item Note that if you put in one or more wrong
  405: 		answers, a hint will be displayed if it has been included in the code. 
  406: 		\item Note that the problem numbers are listed across the page at the top and bottom of the set.  You can
  407: 		click on the problem number and go directly to that problem.   
  408: 		\item Once you're finished previewing this set, you can choose to exit the system.
  409: 		\end{itemize}
  410: 	\end{itemize}
  411: \newpage
  412: 
  413: 
  414: 
  415: %**********************************************************************************
  416: 
  417: % Guided Tour of Grader
  418: %**********************************************************************************
  419: 
  420: 
  421: \item{\bf Guided Tour of {\large \sf Grader}} \hfil\epsffile{figures/grader50.ps}
  422: \label{GGrader}
  423: 	\begin{itemize}
  424: 	\item Prior to opening the {\sf Grader} application, 
  425: 	set up your X-server software to
  426: 	interact with your server.  See  Section 3 on using \capa\ via eXceed,
  427: 	X-win32 or MacX.
  428: 	\item Through your X-server software, open an rlogin (or telnet) session
  429: 	to your server.
  430: 	\item If necessary, change directory to the directory in which the {\sf Grader}
  431: 	application is located.
  432: 	\item Start the application by entering the command {\sf Grader}.
  433: 	\item The {\sf Grader} main menu will appear in the upper left corner of
  434: 	your screen.
  435: 	\item Choose \fbox{File } then \fbox{Specify Class}
  436: 	\item A pop-up window appears with ``Please select a capa.config file'' on the title bar. Search the directory to find the class (in this case, {\sl nsc121s9}).  You may need to go back one directory (by clicking the folder button in the upper right hand corner of the window).
  437: 	Double click the \fbox{nsc121s9} directory, then double click on the 
  438: {\sl capa.config} file. A new window will appear with {\sl nsc121s9} as the class.
  439: 	\item Specify a section number and problem set number:
  440: 	\begin{itemize}
  441: 	\item  Enter {\tt 1} for the section
  442: 	number in the text entry panel.
  443: 	\item   Enter {\tt 1} for the problem set number. 
  444: 	\item Now, click \fbox{Load Scores} button.  {\sf Grader} will scan the
  445: 	record files and the (short) list of students in 
  446: 	section 1 and their current grades will appear. Note, for example, the
  447: 	grade of student A87654321.  For classes
  448: 	with large student enrollments and long problem sets, the display of the
  449: 	section grades may take a few seconds.  
  450: 	\end{itemize}
  451: 	\item Select a student to grade:
  452: 	\begin{itemize}	
  453: 	\item	 All the students in the selected
  454: 	section are contained in the displayed list.  Click and highlight \fbox{Student Jamie .} from the list.
  455: 	\item  Click the
  456: 	\fbox{Grading} button. A new grading window will 
  457: 	appear on the  screen.  The answers to the problem set for that student
  458: 	are displayed along with rows of buttons. 
  459: 	You can choose to view questions and answers or answers only.
  460: 	\item  You can change the recorded grade for any
  461: 	problem except those already answered correctly remotely by clicking on the corresponding 
  462: 	radio button on the left hand side.  
  463: 	\item The buttons refer to whether the
  464: 	answer was remotely entered as correct 
  465: 	{\bf Y}-es: as incorrect {\bf N}-o: or excused {\bf E}-xcused.  A dash 
  466: indicates that the problem was never attempted.  
  467: 	Lower case {\bf y} or {\bf n} are written in the {\sl set$x$.db} file  to
  468: 	indicate when a problem  was graded by teaching staff 
  469: 	using  {\sf Grader}. 
  470: 	\item Problems whose answers cannot be entered directly by students
  471: 	are hand-graded problems. Essay 
  472: 	questions or derivations are examples. (As seen in the ``\capa'' Functions'' section, they are
  473: 	identified as such in the answer format of the problem 
  474: 	as {\tt hgr=on}.)    To assign a grade, click on the box that is
  475: 	presented, assign the number of points received by the 
  476: 	student in the panel that opens, and click to enter the grade.
  477: \item {\tt /SUBJECTIVE} questions (essay questions that were directly entered in by students) are graded seperately by selecting \fbox{File} in the {\sf Grader} main menu and then selecting \fbox{Grade Subjective}. \\
  478: {\em This is explained in greater detail later.}
  479: 	\end{itemize}	
  480: 	\item Save results:  After changing a student's grade, click on the \fbox{Save} button (upper part of the grading window) to record the result. Confirmation of any grade change is required in a separate panel. 
  481: 	\item Grade {\tt /SUBJECTIVE()} questions:
  482: \begin{itemize}
  483: \item You can only grade {\tt /SUBJECTIVE()} past the due date.
  484: \item As you get more comfortable with the {\sf Quizzer}, {\sf Grader}, and
  485: {\sf CapaLogin} components, you should complete the steps below.  
  486: \item Problem number 22 is a {\tt /SUBJECTIVE} question in {\sl set1.qz}.  To
  487: view this problem, you should first enter in some essay answers for some of
  488: the students in the class list.  You should have at least two students in a 
  489: team with only one submission.  Make sure the student not submitting the answer
  490: has her or his student number entered in the answer text.  Next, change the due 
  491: date (change the DB header with {\sf Quizzer}).   
  492: \item To grade {\tt /SUBJECTIVE()}, click on \fbox{File} in the {\sf Grader}
  493: main menu and then select \fbox{Grade Subjective}.  
  494: \item You will be asked to select your class by choosing the {\sl capa.config}
  495: file from your class directory. 
  496: \item After selecting the correct file, you will be asked for the set number
  497: and then the problem number.
  498: \item Two windows should appear.  One window is titled ``gradesubjective'' and 
  499: displays the essay and the name of the student(s) who submitted the answer.
  500: The other window is titled ``scoreandcom'' and has options for grading the 
  501: students.
  502: \item The buttons on the ``scoreandcom'' window do the following functions:
  503: \begin{enumerate}
  504: \item The buttons next to the numbers at the top are the points you can assign
  505: for the problem.
  506: \item \fbox{Grade}:  By clicking this button, the points selected will be
  507: assigned to the student(s) and the box next to ``graded'' will be checked.
  508: \item \fbox{Grade\&Next}:  Does the same as \fbox{Grade} except that it also
  509: displays the next answer to be graded.
  510: \item \fbox{Next}:  Displays the next answer in order of ID number.
  511: \item \fbox{Prev}:  Diplays the previous answer in order of ID number.
  512: \item \fbox{Find ID}:  This is not commonly used.  If one of the student numbers
  513: are typed wrong in the essay text, then that can be corrected and the correct 
  514: student can be found that matches the new student ID by clicking on the 
  515: \fbox{Find ID} button.
  516: \item \fbox{Find Name}:  Similar to \fbox{Find ID} except that the name is searced for.  Because it searches through the entire text, it may generate a long list.  You should highlight the name in the essay text before using the 
  517: \fbox{Find Name} button.
  518: \item \fbox{Add ID}:  Allows you to enter another student to the list in case
  519: a particular student was not listed in the essay text.  You can select the 
  520: student by either name or ID.
  521: \item \fbox{GoTo}:  Allows you to go to the answer from a particular student
  522: number, name, or an ungraded student.
  523: \item \fbox{Exit}:  Exits both windows.
  524: \item \fbox{wrap}:  Wraps long lines to make questions more readable.
  525: \item \fbox{pict}:  Displays the picture if the appropriate picture files are
  526: available.
  527: \item \fbox{Print Response}:  Prints the essay or derivation text.
  528: \item At the bottom of the ``scoreandcom'' window is the number of questions
  529: graded and the number that need to be graded.
  530: \end{enumerate}
  531: \end{itemize}
  532: 	\item Generate reports: 
  533: 	\begin{itemize}
  534: 	\item To generate reports, select \fbox{File} from the main 
  535: 	menu, then \fbox{Create Class Summary} and follow the instructions.
  536: 	\item Two types of reports can be generated by the
  537: 	{\sf Grader} program, a class report and a 
  538: 	section report. Both types are saved in a text file with an {\sl .rpt}
  539: 	extension in the course sub-directory, 
  540: 	{\sl nsc121s9}.  These files will have a prefix {\sf ClassSet$x$} or 
  541: {\sf Sec$x$Set$x$}. 
  542: 	\end{itemize}	
  543: \item  Select \fbox{Quit} on the {\sf Grader} menu.
  544: 	\end{itemize}
  545: \newpage
  546: %**********************************************************************************
  547: 
  548: % Guided Tour of Mangager
  549: %**********************************************************************************
  550: \item{\bf Guided Tour of {\large \sf Manager}} \hfil\epsffile{figures/manager50.ps} \label{Gmanager}
  551: 	\begin{itemize}
  552: 	\item Prior to opening the {\sf Manager} application, 
  553: 	set up your X-server software to
  554: 	interact with your server.  See  Section 3 on using \capa\ via eXceed,
  555: 	X-win32 or MacX.
  556: 	\item Through your X-server software, open an rlogin (or telnet) session
  557: 	to your server.
  558: 	\item If necessary, change directory to the directory in which the {\sf Manager}
  559: 	application is located.
  560: 	\item Start the application by entering the command {\sf Manager}.
  561: 	\item The {\sf Manager} main menu will appear in the upper left corner of
  562: 	your screen.
  563: 	\item Choose \fbox{Actions}.  You will be given three choices:
  564: \begin{enumerate}
  565: 	\item \fbox{Scoring}:  This is used to score Scantron \capa\ exams.
  566: 	\footnote{For more information about scantron \capa\ tests and {\sf
  567: 	Scorer}, please contact capa@capa.msu.edu.}
  568: 	\item \fbox{Generate Stats}:  This gives different ways to generate 
  569: 	statistics on scores, answer submissions, etc.  There are also options to 
  570: 	look up \capa\ IDs.  This choice is the same to the capautils application.
  571: 	\item \fbox{Randomize Seating File}:  This will randomize a user created seat
  572: 	file for exams.
  573: \end{enumerate}
  574: 	\item Choose \fbox{Generate Stats}
  575: 	\item A pop-up window appears with ``Select the capa.config in the class
  576: 	directory'' in the title bar.  Double click on the appropriate {\sl capa.config}
  577: 	file.
  578: 	\item Another pop-up window appears which allows you to choose the following 
  579: 	{\sf CapaUtils} functions:
  580: 	\begin{itemize}
  581: 		\item \fbox{Change Class Path} allows you to switch back and
  582: 		forth between classes.
  583: 		\item \fbox{Run Capastat} gives on-line feedback to instructors 
  584: 		on the level of difficulty students have with an on-line
  585: 		assignment.
  586: 		\item \fbox{Summarize Log Files} gives information when students 
  587: 		entered in correct answers (Y), wrong answers (N), errors in significant
  588: 		digits digits (S), incorrect units (U), and no units entered or units
  589: 		entered when units were unnecessary (u).
  590: 		\item \fbox{Student Course Profile} searches the various \capa\ records
  591: 		and gives a summary of a particular student's performance in all areas
  592: 		involving \capa\, such as homework, quizzes, examinations, or supplementary
  593: 		problems.
  594: 		\item \fbox{CAPA IDs for one student} finds the \capa\ ID for 
  595: 		a particular student for one or more sets.
  596: 		\item \fbox{All CAPA IDs} generates all the \capa\ IDs for a 
  597: 		class for one or more sets.
  598: 		\item \fbox{Item Analysis} gives the level of difficulty and 
  599: 		discrimination for each of the questions.
  600: 		\item \fbox{Item Correlation} gives the correlation between
  601: 		problems in a set. (If the display is hard to read, uncheck the
  602: 		wrap button.)
  603: 		\item \fbox{View Submissions} gives all the 
  604: 		answers a student submits for a particular set.
  605: 		\item \fbox{Analyze Class Report} gives grade distributions and a
  606: 		graph of grade distributions for a previously generated class report.
  607: 		\item \fbox{Analyze Responces} analyzes output generated by scorer.
  608: 		\item \fbox{Graph a Responces Analysis}
  609: 	\end{itemize}
  610: 	\item Close the CapaUtils window by selecting \fbox{Quit}.
  611: 	\item Another feature on the Manager window is \fbox{Print}.  This print option
  612: 	is for printing assignment(s) for a specified student.
  613: 	\item \fbox{Quit} {\sf Manager}.
  614: 	\end{itemize}
  615: 
  616: %************************************************************************************
  617: \item {\bf Guided Tour of Qzparse} \label{Gqzparse}
  618: 	\begin{itemize}
  619: 	\item {\sf Qzparse} is a feature that gives the instructor flexible printing options.  {\bf Note:} All of these printing options can be done using 
  620: {\sf Quizzer}, while {\sf Manager} allows you to print for one student by 
  621: searcing for either a name or a student number. Open an rlogin (or telnet) 
  622: session as ``teacher'' and follow the script below.  The computer used in 
  623: this example has a prompt {\small \bf capa2.nscl.msu.edu$>$}
  624: 	\item Before you begin, you must be in the appropriate class 
  625: 	directory. \\
  626:  {\small \bf capa2.nscl.msu.edu$>$} {\tt cd /absolute/path/teacher/CAPA5/nsc121s9}
  627: 
  628: 	\item Entering in {\tt qzparse -h} at the prompt will display all of
  629: the options available to this function.  \\
  630:   	{\small \bf capa2.nscl.msu.edu$>$} {\tt qzparse -h} 
  631: \begingroup\small \begin{verbatim}
  632: USAGE: qzparse [ -[T|H|A][a|b] ] [-Sec [n|n:m] | -Stu sn [-o filename] ]
  633:           [ -Set [n|n:m] ] [-c path_to_class] [-d outputdirectory]
  634:  Example 1: qzparse -Tb -sec 2:3 -set 2:5
  635:             will generate tex files with both questions and answers
  636:             for sections 2 to 3, sets 2 to 5
  637:  Example 2: qzparse -Ha -stu A12345678 -set 3
  638:             will generate html files with answer only 
  639:             for student A12345678 set 3
  640:           -T     = tex   mode
  641:           -H     = html  mode
  642:           -A     = ascii mode
  643:                  = default question only
  644:             a    = answer   only
  645:             b    = both question and answer
  646:           -Sec 3 = for section 3
  647:           -Sec 3:7    = from section 3 to section 7
  648:           -Stu A12345678 = for a specified student
  649:           -Set 1 = output set 1
  650:           -Set 3:4 = output from set 3 to set 4
  651:           -c class_path
  652:           -o output_filename_with_absolute_path (only for a student)
  653:           -d directory_to_create_files_in (default is class_path/TeX)
  654: -------This is version 5.0.3 @ 11:23-Apr-07-1999
  655: ------------------------------------------------------
  656:  \end{verbatim}
  657: \endgroup
  658: 
  659:    	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt qzparse -T -sec 1:2 -set 1}\\
  660: 	 qzparse running in TeX mode, question only,  from section 1 to 2, set 1
  661: 	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt Enter the ABSOLUTE path of class}\\
  662: 	{\tt /usr/users/teacher/CAPA5/nsc121s9}\begingroup\small \begin{verbatim}
  663: Section  1: 4 students
  664:     Student: Albertelli, Guy II            A12345678   set 1.....................
  665:     Student: Berryman, Felicia V.          A23592320   set 1.....................
  666:     Student: Kashy, Edwin N.               A73336318   set 1.....................
  667:     Student: Student, Jamie .              A87654321   set 1.....................
  668:   DONE set 1
  669: 
  670:   DONE section 1    ALL DONE
  671:  \end{verbatim}
  672: 	\endgroup
  673: 	The above message shows that the {\sf Qzparse} application has generated
  674: 	the appropriate {\sl .tex} files from the quiz set files.
  675: 	 The {\sl .tex} files will contain questions for {\sl .qz} set 1 for section 1 and
  676: 	 section 2.
  677:  	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt cd TeX}  \\
  678: 	{\small \bf capa2.nscl.msu.edu$>$} {\tt latex section1-set1}
  679: 	\begingroup\small \begin{verbatim}
  680: 	............
  681: 	Output written on section1-set1.dvi (8 pages, 45412 bytes).
  682: 	Transcript written on section1-set1.log. \end{verbatim}
  683: 	\endgroup
  684: 	The above message shows that the {\sl .dvi} file has been created from 
  685: 	the {\sl .tex} file for section 1.
  686:    	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt dvips section1-set1.dvi -o
  687:    	section1-set1.ps}\\
  688: 	{\footnotesize \tt ............}\\
  689: 	This command generates the .ps file which is ready for printing.
  690:    	\item {\small \bf capa2.nscl.msu.edu$>$} {\tt ls}
  691:  	\begingroup\small \begin{verbatim}
  692: 	section1-set1.aux  section1-set1.log  section1-set1.tex
  693: 	section1-set1.dvi  section1-set1.ps
  694: 	\end{verbatim}
  695: 	\endgroup
  696: 	The {\tt ls} command lists the files in the current working directory. 
  697: 	As seen above, there are five files created.
  698: 	The {\sl .ps} file contains problem sets for all students in
  699: 	section 1. The command to print is written below.  To specify two sided printing or any other print option, you need to find the command for your particular printer.
  700:    	\item {\small \bf capa2.nscl.msu.edu$>$}  {\tt lpr -PLocal\_Printer
  701:    	section1-set1.ps}
  702:   	\item Note: Do not type a space between {\tt -P} and the name of your local printer.
  703: 	\end{itemize}
  704: Note: It is suggested that the {\sl TeX}  classname subdirectory be cleaned at regular intervals as {\sl .ps} file can get very large. 
  705: 
  706: %**********************************************************************************
  707: 
  708: \item{\bf Guided Tour of Capautils 1.0} 
  709: \label{Gcapautils}
  710: 	\begin{itemize}
  711: 		\item Through your X-server software, open a telnet session to
  712: 		your server.
  713: 		\item Start the application by entering the command {\tt capautils.pl}.
  714: 		\item Enter the absolute path requested, for example:\\
  715: 		{\tt /usr/users/teacher/CAPA5/nsc121s9}
  716:  
  717: 		\item The terminal will display a menu with several items.  
  718: These items are similar to the items from capautils 1.1 which have been explained in the guided tour of {\sf Manager}.
  719: 	
  720: 
  721: 			\item All items are menu driven and some of the information which this application uses (such as printing, classnames, etc.) is  in the {\sl capa.config} file.
  722: \end{itemize}	
  723: 
  724: %**********************************************************
  725: \item{\bf Guided Tour of AllCapaID}
  726: \label{GAllCapaID}
  727: \begin{itemize}
  728: \item Besides getting \capa\ IDs from {\sf CapaUtils} (either from a terminal 
  729: or a window in {\sf Manager}), you can also retrieve \capa\ IDs from the 
  730: {\sf AllCapaID} application.
  731: \item Typing {\tt allcapaid -h} at the prompt of a telnet session will show all the options
  732: available for this function.  \\
  733: 	 {\small \bf capa2.nscl.msu.edu$>$} {\tt allcapaid -h}
  734: \begingroup\small \begin{verbatim}
  735: USAGE: allcapaid [-s start-set] [-e end-set] [-stu student-number] [-c class-directory] [-d output-directory] [-h] [-i] [-sec [n|n:m]]
  736:        start-set : default 1
  737:        end-set   : default 10
  738:        student-number  : no default
  739:        class-directory : no default
  740:        output-directory: class-directory/capaID
  741:        -Sec 3          : for section 3
  742:        -Sec 3:7        : from section 3 to section 7
  743:        -i              : don't create files, print to the screen
  744:        -h              : prints this message
  745:        CAPA version 5.0.3, 11:23-Apr-07-1999
  746: \end{verbatim}
  747: \endgroup
  748: 
  749: \item An example with ``Jaime Student'' is shown below:  \\    \\
  750: \small{\bf capa2.nscl.msu.edu$>$} {\tt allcapaid -s 1 -e 1 -stu A87654321}
  751: \begingroup\small \begin{verbatim}
  752: Enter the ABSOLUTE path of class from root (/)
  753: /usr/users/teacher/CAPA5/nsc121s9
  754: 
  755:    1 
  756: 2318 
  757: \end{verbatim}
  758: \endgroup
  759: 
  760: \end{itemize}
  761: \end{enumerate}
  762: