Back to index

sametime.so module reference

Description

Adds a weight whenever a teacher or a class is required to be in two rooms at the same time.

Please note that this module will not consider it as an error if a teacher or a class has two events scheduled at the same time in the same room. This means that in 99% of cases you need to use this module together with timeplace.so to get the expected results.

Required resource types

Configuration file must define the following resource types in order to use this module:

Defined resource restrictions

conflicts-with (resource types class, teacher)

<restriction type="conflicts-with">name</restriction>

This restriction specifies that current class or teacher should never have lessons at the same time as the class or teacher specified in the restriction.

There are two common uses for this restriction: When multiple classes share an event and when multiple teachers share an event. Consider the following example:

Let's say we have two groups of students. Each group has its own timetable except a couple of lessons which they share.

We define each group of students plus an extra group for the shared lessons.

<resourcetype type="class">
	<resource name="Group 1">
		<restriction type="conflicts-with">Group 1+2</restriction>
	</resource>
	<resource name="Group 2">
		<restriction type="conflicts-with">Group 1+2</restriction>
	</resource>
	<resource name="Group 1+2"/>
</resourcetype>

This way group 1+2 will never have lessons at the same time as groups 1 and 2 and students from either group will be able to attend lectures in group 1+2.

Multiple teachers per event can be defined in a similar way.

Defined tuple restrictions

Supported module options

recursive-conflicts

If this module option is present (any option value is ignored), then all "conflicts-with" restrictions become recursive.

For example: if class A conflicts with class B and class A conflicts with class C, then class B will also automatically conflict with class C.

Without this option class C will not conflict with class B unless you specify this with another "conflicts-with" restriction.

Module groups

This module belongs to the following groups:

Author

Tomaz Solc, tomaz.solc@tablix.org

Back to index