A.9 Teacher Line Format

The line describing a teacher, with line breaks between text fields added for clarity, is specified as follows:

"surname";
"forename(s)-or-initial(s)";
"teacher-abbr";
"venue";
"colour-key[,]{3 (=rgb)}";
"periods-maximum";
"subject.min-level.max-level[,]{number of possible subjects}";
"availability-for-one-day[,]{teaching days per week}"

The single tokens stand for the following entries:

• surname is the teacher's surname.
• teacher-abbr is a unique abbreviated version of the teacher's name, used in exported files.
• forename(s)-or-initial(s) are optional and must in conjunction with name yield a full name that uniquely specifies the teacher. The full name of a teacher is made up of the teacher's forename(s)-or-initial(s) and name, with a space between them. If forename(s)-or-initial(s) is blank, the full name is simply name.
• venue is the preferred venue for the teacher. May be blank.
• colour-key stands for a number between 0 and 255. The combination of the three numbers indicating the intensity of red, green and blue components defines the card colour for the teacher.
• periods-maximum is the maximum number of teaching periods per week allowed for the teacher.
• subject.min-level.max-level defines a subject which the teacher may teach together with the names of the minimum and maximum levels of instruction in this subject. The min-level and max-level tokens may be omitted.
• availability-for-one-day is a sequence of as many letters Y,N, and X as there are periods in one day, where Y means available, N means not available, and X stands for limited availability. In a school with four periods per day, a teacher that is not available on a certain day would be labelled NNNN for that day.

Please consult section 2.2.6 for a description of the effect of the various entries on scheduling.