Annotation of capa/capa51/Manual/s-guidedtour.tex, revision 1.1

1.1     ! albertel    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: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>