1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>maxconsecutive.so module reference</title>
<style type="text/css">
body {
font-family: sans-serif;
font-size: small;
}
pre {
background-color: #eeeeff;
border: solid 1px #000000;
padding: 15px;
}
a {
text-decoration: none;
font-weight: bold;
color: #1A419D;
}
</style>
</head>
<body>
<p><a href="index.html">Back to index</a></p>
<h1>maxconsecutive.so module reference</h1>
<h2>Description</h2>
<p>This module allows you to set a limit for the maximum number of
consecutive events in a teacher's timetable. Additionally you can also set
the number of different lectures that a teacher can have without a pause.</p>
<p>Two lectures are different if they differ in the title and the attending
group of students (i.e. they must differ in the name of the event and all
assigned constant resources). The way these lectures are defined in the
XML file has no effect (for example with a single <event> tag with repeats
or two identical <event> tags - see also <a href="consecutive.html">consecutive.so</a> documentation)</p>
<pre><module name="maxconsecutive" weight="60" mandatory="yes">
<option name="max-consecutive">4</option>
<option name="max-different">3</option>
</module></pre>
<p>With the above options the following combinations are allowed (where A, B, C
denote time slots assigned to different lectures and . denotes a free
time slot):</p>
<p>. A B C . (max-different limit reached)</p>
<p>. A A B B . (max-consecutive limit reached)</p>
<p>. A A B C . (both max-different and max-consecutive limits reached)</p>
<p>And the following combination isn't allowed:</p>
<p>A A B B C . (over the max-consecutive limit)</p>
<h2>Required resource types</h2>
<p>Configuration file must define the following resource types
in order to use this module:</p>
<ul>
<li>teacher</li>
<li>time</li>
</ul>
<h2>Defined resource restrictions</h2>
<h2>Defined tuple restrictions</h2>
<h2>Supported module options</h2>
<h3>max-consecutive</h3>
<p>Use this option to specify the maximum length of a consecutive block of
events in a teacher's timetable.</p>
<p>For example:</p>
<pre><module name="maxconsecutive" weight="60" mandatory="yes">
<option name="max-consecutive">3</option>
</module></pre>
<p>In this case a teacher can have at most 3 lectures (3 occupied time slots)
before requiring at least one time slot of pause.</p>
<h3>max-different</h3>
<p>Use this option to specify the maximum number of different events in a
consecutive block of events in a teacher's timetable.</p>
<p>For example:</p>
<pre><module name="maxconsecutive" weight="60" mandatory="yes">
<option name="max-different">2</option>
</module></pre>
<p>In this case a teacher can have at most 2 different lectures (and any number
of occupied time slots) before requiring at least one time slot of pause.</p>
<h2>Module groups</h2>
<p>This module belongs to the following groups:</p>
<ul>
<li>School scheduling</li>
</ul>
<h2>Author</h2>
<p>Tomaz Solc, <a href="mailto:tomaz.solc@tablix.org">tomaz.solc@tablix.org</a></p> <p><a href="index.html">Back to index</a></p>
</body>
</html>
|
