WeekDaze

Output-options

These parameters define what part of the solution to present.
This part of the configuration is independent of the problem, & consequently typically persists unaltered between problems.

The resulting timetable is rendered in XHTML, as many two-dimensional slices through a conceptually three-dimensional Cartesian graph. Each two-dimensional slice is bounded by axes ranging over the days of the week, & the constant but configurable number of time-slots into which each day has been sub-divided, & identifies at each coordinate any lesson booked. The third axis (which defines each slice) identifies either; the student-bodies, the teachers, or the locations in which classes are held; depending on the intended type of observer of the timetable. A timetable can be inverted to change this axis so that it can be more readily be interpreted by a different type of observer, whilst still presenting the same set of bookings.

Fields

Number of Decimal Digits:

Defines the integral precision to which auxiliary floating-point data (see Verbosity) are logged; it has no effect on the precision of the calculations performed by weekdaze.

Student-body Mnemonic Separator:

Defines a string to be used as a separator when automatically joining the Mnemonics of student-bodies with identical requirements; this is only relevant when Reduce Student-body Register is checked.

Verbosity:

A string which defines the quantity of ancillary information which is logged.

Silent:

The lack of output might leave the user wondering whether anything is actually happening; it is, though it can take a long time.

Normal:

The default-level. Delivers a progress-report on the reading, parsing & validation of the configuration. Prints a . as each evolution-strategy is completed.

Verbose:

Reports statistics (to a precision governed by Number of Decimal Digits) on the values of criteria as the solution evolves.

Deafening:

Enhances the statistics reported by Verbose.

Style

These parameters define the style in which the solution is presented.
This part of the configuration is independent of the problem, & consequently typically persists between problems.

Fields

CSS URL:

References the cascading style-sheet to use when rendering the results. The default file weekdaze.css, defines a style for various topics, but since it can't know those you might define, you may want to tailor it, & either; reference it using this option; or merely save & edit the resulting XHTML-file, to reference it in one's local file-system. In this CSS-file, Topic-names have been normalised to make them valid CSS-identifiers, by removing unsuitable characters. NB: this specific issue could alternatively be tackled using Generate Lesson-colour From.

Another reason why you might want to amend the style-sheet, is if you wanted to print the results; though this is deprecated since some of the information in the results is only visible via a browser. By default the background of the results is patterned & would make heavy use of an ink-jet printer's colour-cartridges. To remedy this you could within the body remove the background-color & background-image fields.

If your amended URL exists in your own local file-system, then it should be prefixed by file://127.0.0.1/, & you should uncheck Synchronous when running the project, in order that the results are emailed to you where your file-system can be accessed.

Display Axis-labels By Day:

Defines whether to label the horizontal axis of the output timetable.

Display Axis-labels By Time-slot:

Defines whether to label the vertical axis of the output timetable.

Display Runtime-information:

Defines whether to display the runtime-log with the resulting timetable.

Display Supplementary Information:

Defines whether to additionally to display warnings, statistics, & summarise deviations between the solution & the configured requirements.

Merge Duplicate Time-slots By Day:

Defines whether adjacent identical time-slots are merged horizontally. This reduces repetition & uses the limited space efficiently.

Merge Duplicate Time-slots By Time-slot:

Defines whether adjacent identical time-slots are merged vertically. This reduces repetition, draws attention to duplicate lessons, & uses the limited space efficiently.

Weekend:

Enumerates the set of days which constitute the weekend, & which are rendered differently.

Generate Lesson-colour From:

Optionally specifies a lesson-attribute (either Subject, Topic, or Level), from which to automatically generate an HTML-colour for the lesson when ultimately displayed. In the absence of any specification, the colour will be determined by the value of CSS URL.

Minimum Contrast-ratio:

Optionally specifies a floating-point number in the unit-interval, which defines the minimum acceptable contrast-ratio between the foreground lesson-colour (generated according to Generate Lesson-colour From) & the complimentary background-colour. Should the generated colour & its complement fail to contrast sufficiently, then no colour will be explicitly defined for that lesson. Should the Minimum Contrast-ratio equal the maximum value of 1, then all lessons will be uncoloured. In the absence of any specification, a default value of 1/16 will be used when required.