File:
[LON-CAPA] /
capa /
capa51 /
Manual /
s-guidedtour.tex
Revision
1.1:
download - view:
text,
annotated -
select for diffs
Fri Jul 14 18:30:33 2000 UTC (24 years, 2 months ago) by
albertel
Branches:
MAIN
CVS tags:
version_2_9_X,
version_2_9_99_0,
version_2_9_1,
version_2_9_0,
version_2_8_X,
version_2_8_99_1,
version_2_8_99_0,
version_2_8_2,
version_2_8_1,
version_2_8_0,
version_2_7_X,
version_2_7_99_1,
version_2_7_99_0,
version_2_7_1,
version_2_7_0,
version_2_6_X,
version_2_6_99_1,
version_2_6_99_0,
version_2_6_3,
version_2_6_2,
version_2_6_1,
version_2_6_0,
version_2_5_X,
version_2_5_99_1,
version_2_5_99_0,
version_2_5_2,
version_2_5_1,
version_2_5_0,
version_2_4_X,
version_2_4_99_0,
version_2_4_2,
version_2_4_1,
version_2_4_0,
version_2_3_X,
version_2_3_99_0,
version_2_3_2,
version_2_3_1,
version_2_3_0,
version_2_2_X,
version_2_2_99_1,
version_2_2_99_0,
version_2_2_2,
version_2_2_1,
version_2_2_0,
version_2_1_X,
version_2_1_99_3,
version_2_1_99_2,
version_2_1_99_1,
version_2_1_99_0,
version_2_1_3,
version_2_1_2,
version_2_1_1,
version_2_1_0,
version_2_12_X,
version_2_11_X,
version_2_11_5_msu,
version_2_11_5,
version_2_11_4_uiuc,
version_2_11_4_msu,
version_2_11_4,
version_2_11_3_uiuc,
version_2_11_3_msu,
version_2_11_3,
version_2_11_2_uiuc,
version_2_11_2_msu,
version_2_11_2_educog,
version_2_11_2,
version_2_11_1,
version_2_11_0_RC3,
version_2_11_0_RC2,
version_2_11_0_RC1,
version_2_11_0,
version_2_10_X,
version_2_10_1,
version_2_10_0_RC2,
version_2_10_0_RC1,
version_2_10_0,
version_2_0_X,
version_2_0_99_1,
version_2_0_2,
version_2_0_1,
version_2_0_0,
version_1_99_3,
version_1_99_2,
version_1_99_1_tmcc,
version_1_99_1,
version_1_99_0_tmcc,
version_1_99_0,
version_1_3_X,
version_1_3_3,
version_1_3_2,
version_1_3_1,
version_1_3_0,
version_1_2_X,
version_1_2_99_1,
version_1_2_99_0,
version_1_2_1,
version_1_2_0,
version_1_1_X,
version_1_1_99_5,
version_1_1_99_4,
version_1_1_99_3,
version_1_1_99_2,
version_1_1_99_1,
version_1_1_99_0,
version_1_1_3,
version_1_1_2,
version_1_1_1,
version_1_1_0,
version_1_0_99_3,
version_1_0_99_2,
version_1_0_99_1,
version_1_0_99,
version_1_0_3,
version_1_0_2,
version_1_0_1,
version_1_0_0,
version_0_99_5,
version_0_99_4,
version_0_99_3,
version_0_99_2,
version_0_99_1,
version_0_99_0,
version_0_6_2,
version_0_6,
version_0_5_1,
version_0_5,
version_0_4,
version5-1-2-first_release,
stable_2002_spring,
stable_2002_july,
stable_2002_april,
stable_2001_fall,
loncapaMITrelate_1,
language_hyphenation_merge,
language_hyphenation,
conference_2003,
bz6209-base,
bz6209,
STABLE,
HEAD,
GCI_3,
GCI_2,
GCI_1,
CAPA_5-1-6,
CAPA_5-1-5,
CAPA_5-1-4_RC1,
BZ4492-merge,
BZ4492-feature_horizontal_radioresponse,
BZ4492-feature_Support_horizontal_radioresponse,
BZ4492-Support_horizontal_radioresponse
- 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:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>