weekdaze 0.0.0.1 → 0.0.0.2
raw patch · 6 files changed
+38/−39 lines, 6 filesPVP ok
version bump matches the API change (PVP)
API changes (from Hackage documentation)
Files
- changelog.markdown +3/−0
- debian/DEBIAN/control +1/−1
- man/man1/weekdaze.1 +3/−16
- man/man5/weekdaze.5 +24/−19
- weekdaze.cabal +6/−2
- weekdaze.spec +1/−1
changelog.markdown view
@@ -1,3 +1,6 @@ # 2013-07-04 Dr. Alistair Ward <weekdaze@functionalley.com> ## 0.0.0.1++## 0.0.0.2+Updated list of test-compilers.
debian/DEBIAN/control view
@@ -1,5 +1,5 @@ Package: weekdaze-Version: 0.0.0.1-1+Version: 0.0.0.2-1 Section: utils Priority: optional Architecture: amd64
man/man1/weekdaze.1 view
@@ -213,13 +213,9 @@ .br The undesirable consequence is that teacher \fIT1\fR must synchronise progress through the \fIcourse\fR, between these \fIstudent-class\fRes. .TS-l l cb s s-l l c s s lb lb l l l ^ lb ^ ^ ^ l l l l l .- Time- ============ Teacher Student t1 t2 t3 body ======= ======= == == ==@@ -242,13 +238,9 @@ under these circumstances no undesirable \fIstudent-body combinations\fR can arise, but should their \fIavailability\fR dictate that they must form four singleton \fIstudent-class\fRes, different pairs of singleton \fIstudent-class\fRes may be synchronised @ various \fItime\fRs throughout the week. .TS-l l cb s s s-l l c s s s lb lb l l l l ^ lb ^ ^ ^ ^ l l l l l l .- Time- ====================== Teacher Student t1 t2 t3 t4 class ======= ======= == == == ==@@ -520,18 +512,13 @@ .TS lb lb l l-lb l-.+lb l . Report Explanation-===== ===========+====== =========== The weighted mean over all heterogeneous timetable-criteria, of the deterministic timetable resulting from each raster-scan; & the (minimum, maximum) The application has performed a raster-scan over the timetable, booking \fIlesson\fRs selected to optimise the value of \fIlesson-criteria\fR. This is repeated using a variety of different rasters, reporting for each the resulting weighted mean over all \fItimetable-criteria\fR. Finally the raster-patterns which were worst & best are reported.- The weighted timetable-criteria of the best deterministic timetable The individual \fItimetable-criteria\fR used to compose the weighted mean, in the best raster-scan, are reported in the configured order.- The ((mean, standard deviation), (minimum, maximum)) over the best deterministic timetable, of each weighted lesson-criterion The values of \fIlesson-criteria\fR, by which \fIlesson\fRs were selected during the best raster-scan are reported. Their standard deviation, & minimum & maximum value, over the best timetable, identifies their influence on the selection of \fIlesson\fRs, & where perhaps individual weights may be fine-tuned. This is the end of the initial deterministic phase, from which random evolution now begins.- The (relative improvement in the weighted mean over all heterogeneous timetable-criteria, the number of generations through which the timetable evolved, the final fecundity, & the weighted timetable-criteria for the selected candidate), for each evolution-strategy/timetable-constructor Here we report four statistics for each evolution/reconstruction strategy; a quantification of the improvement according to the weighted mean over all the \fItimetable-criteria\fR, resulting from this strategy; the number of generations of evolution, since strategies are terminated when improvements cease; the final \fIfecundity\fR of the breeding-program, since this is reduced by a feedback-loop, when the population-diversity ratio of the candidate-population drops beneath a threshold; the individual weighted \fItimetable-criteria\fR, in configuration-order, from which the mean is composed.- The final weighted timetable-criteria, & the improvement, from the best deterministic timetable The final value of each weighted \fItimetable-criterion\fR is reported, along with the absolute amount by which it was changed during evolution. The order in which they're reported matches the configured "\fBtimetableCriteriaWeights\fR". .TE .sp 1@@ -692,7 +679,7 @@ .fi .IP \(bu The executable was in this instance built with the \fBCabal\fR-flag "\fB-fHDBC-mysql\fR" to connect to the data-server using the native \fBMySQL\fR-interface,-so data-server connection-parameters had to be specified on the command-line, rather than via a \fB.ODBC.ini\fR file.+so data-server connection-parameters had to be specified on the command-line, rather than via a \fB.odbc.ini\fR file. .br I could also have explicitly specified \fB--dataServerHost\fR='127.0.0.1' \fB--dataServerPort\fR='3306' \fB--dataServerUserId=\fR'root' \fB--databaseName=\fR'weekdaze', but these are the defaults (though a less privileged database-user would be preferrable).
man/man5/weekdaze.5 view
@@ -124,18 +124,18 @@ for each of the \fIdepletion-strategies\fR (defined in section-1 of the man-pages). .sp 1 .nf-.B synchronisedCourseByDayMutation-.B synchronisedCourseMutation-.B excessRunlengthMutation-.B homogeneousStudentViewLessonMutation-.B incompleteCourseMutation-.B randomLessonMutation-.B singletonStudentClassMutation-.B splitSessionMutation-.B studentBodyCombinationMutation-.B studentViewTimetableForDayMutation-.B studentViewTimetableForWeekMutation-.B synchronousLessonMutation+\& \fBsynchronisedCourseByDayMutation\fR,+\& \fBsynchronisedCourseMutation\fR,+\& \fBexcessRunlengthMutation\fR,+\& \fBhomogeneousStudentViewLessonMutation\fR,+\& \fBincompleteCourseMutation\fR,+\& \fBrandomLessonMutation\fR,+\& \fBsingletonStudentClassMutation\fR,+\& \fBsplitSessionMutation\fR,+\& \fBstudentBodyCombinationMutation\fR,+\& \fBstudentViewTimetableForDayMutation\fR,+\& \fBstudentViewTimetableForWeekMutation\fR,+\& \fBsynchronousLessonMutation\fR. .fi .sp 1 CAVEAT: the default \fIfecundity\fR of \fB0\fR, deactivates the corresponding \fIevolution-strategy\fR.@@ -743,7 +743,7 @@ l l l l l l 1 1 1 1 1 1 1 1 l lb r r lb lb l 1 1 1 1 1 1 1 1 l . File-name Time-slots Student XHTML-output XML-output Configuration-features-(xml/*.xml) per day bodies (xhtml/*.xhtml) (xml/*.xml) generateLessonColourFrom campus facilityName freePeriodPreference groupId maximumClassSize minimumConsecutiveLessons specialtyTopic synchronisationId timeslotRequest+xml/*.xml per day bodies xhtml/*.xhtml xml/*.xml generateLessonColourFrom campus facilityName freePeriodPreference groupId maximumClassSize minimumConsecutiveLessons specialtyTopic synchronisationId timeslotRequest ========= ========== ======= ============ ========== ======================== ====== ============ ==================== ======= ================ ========================= ============== ================= =============== example_01 1 3 timetable_01 studentViewTimetable_01 Y example_02 2 2 timetable_02 studentViewTimetable_02 Y Y Y Y@@ -757,12 +757,15 @@ .TE .sp 1 CAVEAT: should any of these files be relocated, then its "\fBDOCTYPE\fR"-declaration, will need to be corrected to reference \fBweekdaze.dtd\fR.+.sp 1 .TS lb lb+l s l l-l l .-\fBFile-name\fR (dtd/*.dtd) Contents-===================== ========+lb l .+File-name Contents+dtd/*.dtd+========= ======== locationViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIlocation\fRs. studentViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIstudent-bodies\fR. teacherViewTimetable The formal description of the XML-format for the resulting timetable as seen from the perspective of \fIteacher\fRs.@@ -771,10 +774,12 @@ .sp 1 .TS lb lb+l s l l-l l .-\fBFile-name\fR (sql/*.sql) Contents-===================== ========+lb l .+File-name Contents+sql/*.sql+========= ======== weekdazeCreate Defines the database-schema; all the tables & all the rows. weekdazeTriggers Defines extra rules required to preserve relational integrity as data is inserted. weekdazeExamples Defines a set of example timetable-problems (the same as those defined in XML).
weekdaze.cabal view
@@ -14,7 +14,7 @@ -- along with WeekDaze. If not, see <http://www.gnu.org/licenses/>. Name: weekdaze-Version: 0.0.0.1+Version: 0.0.0.2 Cabal-version: >= 1.10 Copyright: (C) 2013-2015 Dr. Alistair Ward License: GPL@@ -25,7 +25,7 @@ Build-type: Simple Description: An application which searches for a solution to the configured school-timetable problem. Category: Application, Teaching-Tested-with: GHC == 8.0, GHC == 8.2, GHC == 8.4, GHC == 8.6+Tested-with: GHC == 8.0, GHC == 8.2, GHC == 8.4, GHC == 8.6, GHC == 8.8, GHC == 8.10 Homepage: https://functionalley.com/WeekDaze/weekdaze.html Maintainer: mailto:weekdaze@functionalley.com Bug-reports: mailto:weekdaze@functionalley.com@@ -55,6 +55,10 @@ README.markdown weekdaze.spec weekdaze.svg++source-repository head+ type: git+ location: https://github.com/functionalley/WeekDaze -- Enable using: 'runhaskell Setup configure -f HDBC-mysql --verbose'. flag HDBC-mysql
weekdaze.spec view
@@ -24,7 +24,7 @@ Summary: Attempts to find a timetable satisfying the configured requirements. Name: weekdaze-Version: 0.0.0.1+Version: 0.0.0.2 Release: 1 License: GPLv3 # From '/usr/share/doc/packages/rpm/GROUPS'.