Home
Current UR
courses
Visitor
page
Intro to
WeBWorK
WeBWorK 2
Twiki
WW
Community
Grant Support
& awards
Discussion
group
Problem
library
Write/modify
problems
Create &
manage course
Tutorial on
running a course
HowTos
FAQ
WeBWorK2
FAQ
Software
Download
How to
Install WW server
Feedback
Site Map
Change
preferences
Change
password
| Prev | Next | courseadmin |
Set Definition File
The set definition file is an ascii file which defines the set. It defines the set name, opening, due, and answer dates, optionally header files for the set, and finally the list of problems (with optional values, limits on attemps allowed, and links --- see below).
The set definition file MUST be placed in the templates/ directory (as
defined by $templateDirectory in webworkCourse.ph) and
MUST be named setxxx.def where xxx is the name of the set. E.g. set1.def,
setExam.def, and setsample7.def define sets named 1, Exam, and sample7
respectively. Set names are case sensitive, e.g. setexam1.def and setExam1.def
give different sets as do set1.def and sef01.def.
We begin with an example of a set definition file (with copious comments). Further discussion will follow it.
File name:
## Blank lines or comment lines (anything following a # is a comment)
## may be used for clarity.
paperHeaderFile=set1/SetHeader.pg
## This line is optional.
## The default paper Header file will be used if this line is not present
screenHeaderFile=set1/screenHeader.pg
## This line is optional.
## The default screen Header file will be used if this line is not present.
openDate = 9/9/96 at 9:00 AM
## The date/time the set opens and problems can be viewed and answered by students
## (professors can view sets before the open date).
## The date/time can also be given in the format 9/9/96, 0900
dueDate = 09/24/96 at 1:00 PM
## After this date/time, answers will not be recorded.(or 09/24/96, 1300)
answerDate = 09/25/96 at 11:30 PM
## After this date/time, the student can view the correct answer(s)
## and solutions (if available). Professors can view these at any time.
## The above lines can occur in any order, but must precede
## the problemList= line.
## All lines following the problemList= line give the filenames (and
## optionally the values, limits on attempts, and links)
## of the problems in the set. The format is
## File path/name, value, number of allowed attempts, link
## Explanation of the problems list follows the entire list
problemList =
set1/s2_5_1.pg, 2
set1/s2_5_4.pg, 5
set1/s2_5_5.pg, 3
set1/s2_5_2.pg, 1
set1/s2_5_3.pg
set1/s2_5_6.pg, 1 , 4
set1/s2_5_7.pg, 1 ,-1
set1/s2_5_8.pg, 1 ,-1, 1
set1/s2_5_9.pg, 1 ,-1, 1
set1/s2_5_10.pg, 2
## Problem set explanation
## Problem 1 is given by the file <templatesdirectory>/set1/s2_5_1.pg .
## It's value is 2 points. Unlimited attempts allowed.
## Problem 2 is given by the file <templates directory>/set1/s2_5_4.pg .
## It's value is 5 points. Unlimited attempts allowed.
## Problem 3, 3 points, unlimited attempts.
## Problem 4, 1 point, unlimited attempts.
## Problem 5, value is still 1 point which is the default;
## unlimited attempts which is the default.
## Problem 6, 1 point. The student is only allowed 4 attempts after
## which answers will not be recorded. Note that we had to specify the value as 1 point.
## Problem 7, 1 point, unlimited attempts (any negative integer
## denotes unlimited attempts).
## Problem 8, 1 point, unlimited attempts, linked to previous problem.
## Problem 9, 1 point, unlimited attempts, linked to previous problem.
## Problem 10, 2 points, unlimited attempts (not linked to the
## previous problem). The last problem in the set.
set1.def
## with the last three parameters being optional.
The set definition file has six special lines which begin:
paperHeaderFile = ,screenHeaderFile = ,openDate = , dueDate = , answerDate
= , and problemList = . Blank lines and everything following
a # are considered comments and are ignored. The first five special lines may
occur in any order but must proceed the problemList = line. See the comments in
the above example for explanations of the main points. Here are some more
technical points.
The openDate, dueDate, and answerDate must be in chronological order.
The paperHeaderFile = line is optional. If it is present, WeBWorK will use
the given file as a header file when downloading a postscript or pdf version of
the entire set. If this line is not present, WeBWorK will use the file defined
by $Global::SET_HEADER in webworkCourse.ph. If
$Global::SET_HEADER is not given in webworkCourse.ph,
WeBWorK will use the file given by $SET_HEADER in
Global.pm This file usually contains the student name and
assignment number, the due date, instructions, etc.
The screenHeaderFile = line is optional. If it is present, WeBWorK will use
the given file as an insert on the probSet page, i.e. the page which lists the
probems in a set. If this line is not present, WeBWorK will use the file defined
by $Global::PROB_HEADER in webworkCourse.ph. If
$Global::PROB_HEADER is not given in webworkCourse.ph,
WeBWorK will use the file given by $PROB_HEADER in
Global.pm This file usually contains the due date, instructions,
etc.
N.B. Old style set definition files had a line setNumber =
1
for example, which defined the set name to be 1. In the new style, a
line begining with setNumber = will be ignored. The set name is
now derived from the filename of the set definition file as described above.
All files are assumed to be in the templates directory (as defined by
$templateDirectory in webworkCourse.ph). Normally it
is convenient to put all files for a set in a subdirectory of the
templates directory. In the example above, the file
s2_5_1.pg for problem 1 is in the subdirectory set1 of
the templates directory.
All lines following the problemList = line define problems for the set. The first line gives problem 1, the second line gives problem 2, etc. Blank lines may be inserted say every 5 lines for clarity. The format for each line is:
problemFileName , value , maximumAllowedAttempts, linkToPreviousProblem
Don't forget the commas (,) unless you want default values.
The problem value is assumed to be a nonnegative integer or a nonnegative decimal. All non digits except decimal points are discarded so -5 becomes 5, 4+5 becomes 45, 0.5 remains 0.5, etc. If there are no digits, the problem value defaults to 1. The scoring routines use this value to determine the value of a problem.The maximumAllowedAttempts is assumed to be an integer. A negative integer means allow unlimited attempts (the default). All non digits except the minus sign (-) are discarded so 4+5 becomes 45, etc. If there are no digits, the value defaults to -1. After the allowed number of attempts answers will not be recorded.
The linkToPreviousProblem is assumed to be 1 (true) or 0 (false, the default). If 1 this means, for every student, this problem will have the same seed as the previous problem. This means you can have a connected or linked series of problems that share the same "random data." For this the linked problems have to define the same random variables in the same order (it is the responsibility of problem authors to do this). Note: this is set to 0 for the first problem regardless of what is listed. Also 0 and 1 are Perl's truth values and other values are interpreted as true or false according to Perl's rules.
problemFileName is equivalent to: problemFileName , 1 , -1, 0 problemFileName, 2 is equivalent to: problemFileName , 2 , -1 , 0 problemFileName, 2 , 3 is equivalent to: problemFileName , 2 , 3 , 0
| Prev | Next | courseadmin |