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