• A map of weekly timetables, indexed by the observer-Id for whom it is intended.
• One can visualise this as a 3-D structure, indexed by observer-Id, day, & timeslot-Id, optionally defining a lesson at each coordinate.
• The type of the observer-Id & of the resource-Ids referenced in each lesson, depend on the perspective from which the polymorphic timetable was designed to be viewed: if viewed by a student, then the observer-Id is a student-body, & the resource-Ids are location-Id & teacher-Id; if viewed by a teacher, then the observer-Id is a teacher-Id, & the resource-Ids are location-Id & student-body; if viewed by a location, then the observer-Id is a location-Id, & the resource-Ids are student-body & teacher-Id.

Whether to augment the marked-up output with supplementary information.

For use when converting any timetable-view to XHTML.

A lesson qualified by the coordinates at which it is booked.

A dummy type on which to hang instance-definitions.

Used to qualify XML.

• Calculates the average over all observer-Ids, of the average over the days in the week on which the observer is actually available, of the absolute deviation (https://en.wikipedia.org/wiki/Absolute_deviation#Average_absolute_deviation), in the number of free-periods.
• CAVEAT: includes in the count, those time-slots allocated for meetings.

The number of lessons booked for each observer, relative to the required limit of their teaching-time; based on calculateUtilisationRatio.

Locates unallocated coordinates in the specified timetable, omitting any days on which the observerId is unavailable, & any coordinates reserved by the observerId for a meeting.

Finds runlengths of consecutive equal generalised (i.e. potentially undefined) lessons, & the run-length of each sequence, indexed by observerId, day & timeslotId.

Calls findGeneralisedLessonRunlengthsByTimeslotIdByDayByObserverId, & flattens the results.

Finds runlengths of separated equal lessons, within the timetable for any single day.

• Finds runlengths of separated equal lessons, within the timetable for any single day; separated unallocated time-slots don't count.
• Returns a map indexed by observerId, of arrays indexed by day, of lists associated by common lesson, of lists associated by starting timeslotId, of runlengths.

Counts the number of lessons booked.

• Counts the total number of unallocated time-slots, across all observers in one week (i.e. the whle timetable); discounting those when the observer is unavailable.
• CAVEAT: this function takes no account of the possibility that when the observer represents a student-body, some time-slots may be allocated to unsupervised study, & the remainder must be multiplied by the number of members in the student-body.

Extracts the lessons from the specified timetable, by discarding the coordinates at which each was booked.

Extract the list of all coordinates in the specified timetable.

Extracts the set of distinct lessons from the specified timetable.

• Extracts a core of synchronous events, by drilling through the timetable for all observer-Ids, at the specified time.
• The observer-ids are discarded, rendering the results anonymous.
• CAVEAT: performance-hotspot.

Calculates the mean, over those days on which the resource is available, of the ratio of those free (neither booked with a lesson, not reserved for a meeting) time-slots which comply with the specified preference, to the total number of free time-slots.

• Constructor.
• Creates an unallocated weekly timetable, for each of the specified list of generic observer-Ids; i.e. locations, student-bodies or teacher-ids.
• Each daily timetable has the specified list of timeslots-Ids, into which a lesson can be booked.

Get any lesson booked at the specified coordinates.

Accessor.

Accessor.

Overwrites any lesson defined at the specified coordinates.

Undefine the lesson, at the specified coordinates.

• Undefines each lesson, at the specified list of coordinates.
• CAVEAT: if all the coordinates have the same observerId, then undefineTimeslotsFor should be more efficient.

Undefines each lesson, at the specified list of times, within the timetableForWeek for the specified observerId.

Undefine the whole timetable.

True if a booking has been made at the specified coordinates in the timetable.

• Check whether all the lessons currently booked for the specified time, are compatible with the specified lesson.
• To pass, any synchronous lesson-definitions must either be identical to the proposed lesson, or use neither of its resources.
• CAVEAT: it doesn't check whether the ability-stream of the student-body matches those for the existing bookings.
• CAVEAT: performance-hotspot.

True if a booking already exists in the timetable which matches the specified predicate.

True if the specified booking already exists in the timetable.

Transform a booking, into a generalised booking.