    001package org.cpsolver.instructor;
    002
    003import java.io.File;
    004import java.io.FileInputStream;
    005import java.io.FileOutputStream;
    006import java.io.FileWriter;
    007import java.io.IOException;
    008import java.io.PrintWriter;
    009import java.text.DecimalFormat;
    010import java.util.Collection;
    011import java.util.Iterator;
    012import java.util.Map;
    013
    014import org.apache.log4j.Logger;
    015import org.cpsolver.coursett.model.TimeLocation;
    016import org.cpsolver.ifs.assignment.Assignment;
    017import org.cpsolver.ifs.assignment.DefaultParallelAssignment;
    018import org.cpsolver.ifs.assignment.DefaultSingleAssignment;
    019import org.cpsolver.ifs.extension.ConflictStatistics;
    020import org.cpsolver.ifs.extension.Extension;
    021import org.cpsolver.ifs.model.Model;
    022import org.cpsolver.ifs.solution.Solution;
    023import org.cpsolver.ifs.solution.SolutionListener;
    024import org.cpsolver.ifs.solver.ParallelSolver;
    025import org.cpsolver.ifs.solver.Solver;
    026import org.cpsolver.ifs.util.DataProperties;
    027import org.cpsolver.ifs.util.ToolBox;
    028import org.cpsolver.instructor.model.Course;
    029import org.cpsolver.instructor.model.Instructor;
    030import org.cpsolver.instructor.model.InstructorSchedulingModel;
    031import org.cpsolver.instructor.model.Preference;
    032import org.cpsolver.instructor.model.Section;
    033import org.cpsolver.instructor.model.TeachingAssignment;
    034import org.cpsolver.instructor.model.TeachingRequest;
    035import org.dom4j.Document;
    036import org.dom4j.io.OutputFormat;
    037import org.dom4j.io.SAXReader;
    038import org.dom4j.io.XMLWriter;
    039/**
    040 * A main class for running of the instructor scheduling solver from command line. <br>
    041 * Instructor scheduling is a process of assigning instructors (typically teaching assistants) to classes
    042 * after the course timetabling and student scheduling is done.
    043 *
    044 * @version IFS 1.3 (Instructor Sectioning)<br>
    045 *          Copyright (C) 2016 Tomáš Müller<br>
    046 *          <a href="mailto:muller@unitime.org">muller@unitime.org</a><br>
    047 *          <a href="http://muller.unitime.org">http://muller.unitime.org</a><br>
    048 * <br>
    049 *          This library is free software; you can redistribute it and/or modify
    050 *          it under the terms of the GNU Lesser General Public License as
    051 *          published by the Free Software Foundation; either version 3 of the
    052 *          License, or (at your option) any later version. <br>
    053 * <br>
    054 *          This library is distributed in the hope that it will be useful, but
    055 *          WITHOUT ANY WARRANTY; without even the implied warranty of
    056 *          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    057 *          Lesser General Public License for more details. <br>
    058 * <br>
    059 *          You should have received a copy of the GNU Lesser General Public
    060 *          License along with this library; if not see
    061 *          <a href='http://www.gnu.org/licenses/'>http://www.gnu.org/licenses/</a>.
    062 */
    063public class Test extends InstructorSchedulingModel {
    064    private static Logger sLog = Logger.getLogger(Test.class);
    065
    066    /**
    067     * Constructor
    068     * @param properties data properties
    069     */
    070    public Test(DataProperties properties) {
    071        super(properties);
    072    }
    073
    074    /**
    075     * Load input problem
    076     * @param inputFile input file (or folder)
    077     * @param assignment current assignments
    078     * @return true if the problem was successfully loaded in
    079     */
    080    protected boolean load(File inputFile, Assignment<TeachingRequest.Variable, TeachingAssignment> assignment) {
    081        try {
    082            Document document = (new SAXReader()).read(inputFile);
    083            return load(document, assignment);
    084        } catch (Exception e) {
    085            sLog.error("Failed to load model from " + inputFile + ": " + e.getMessage(), e);
    086            return false;
    087        }
    088    }
    089
    090    /**
    091     * Generate a few reports
    092     * @param outputDir output directory
    093     * @param assignment current assignments
    094     * @throws IOException
    095     */
    096    protected void generateReports(File outputDir, Assignment<TeachingRequest.Variable, TeachingAssignment> assignment) throws IOException {
    097        PrintWriter out = new PrintWriter(new File(outputDir, "solution-assignments.csv"));
    098        out.println("Course,Section,Time,Room,Load,Student,Name,Instructor Pref,Course Pref,Attribute Pref,Time Pref,Back-To-Back,Same-Days,Same-Room,Different Lecture,Overlap [h]");
    099        double diffRoomWeight = getProperties().getPropertyDouble("BackToBack.DifferentRoomWeight", 0.8);
    100        double diffTypeWeight = getProperties().getPropertyDouble("BackToBack.DifferentTypeWeight", 0.5);
    101        double diffRoomWeightSD = getProperties().getPropertyDouble("SameDays.DifferentRoomWeight", 0.8);
    102        double diffTypeWeightSD = getProperties().getPropertyDouble("SameDays.DifferentTypeWeight", 0.5);
    103        double diffTypeWeightSR = getProperties().getPropertyDouble("SameRoom.DifferentTypeWeight", 0.5);
    104        for (TeachingRequest.Variable request : variables()) {
    105            out.print(request.getCourse().getCourseName());
    106            String sect = "", time = "", room = "";
    107            for (Iterator<Section> i = request.getSections().iterator(); i.hasNext(); ) {
    108                Section section = i.next();
    109                sect += section.getSectionName();
    110                time += (section.getTime() == null ? "-" : section.getTime().getDayHeader() + " " + section.getTime().getStartTimeHeader(true));
    111                room += (section.getRoom() == null ? "-" : section.getRoom());
    112                if (i.hasNext()) { sect += ", "; time += ", "; room += ", "; }
    113            }
    114            out.print(",\"" + sect + "\",\"" + time + "\",\"" + room + "\"");
    115            out.print("," + new DecimalFormat("0.0").format(request.getRequest().getLoad()));
    116            TeachingAssignment ta = assignment.getValue(request);
    117            if (ta != null) {
    118                Instructor instructor = ta.getInstructor();
    119                out.print("," + instructor.getExternalId());
    120                out.print(",\"" + instructor.getName() + "\"");
    121                out.print("," + (ta.getInstructorPreference() == 0 ? "" : ta.getInstructorPreference()));
    122                out.print("," + (ta.getCoursePreference() == 0 ? "" : ta.getCoursePreference()));
    123                out.print("," + (ta.getAttributePreference() == 0 ? "" : ta.getAttributePreference()));
    124                out.print("," + (ta.getTimePreference() == 0 ? "" : ta.getTimePreference()));
    125                double b2b = instructor.countBackToBacks(assignment, ta, diffRoomWeight, diffTypeWeight);
    126                out.print("," + (b2b == 0.0 ? "" : new DecimalFormat("0.0").format(b2b)));
    127                double sd = instructor.countSameDays(assignment, ta, diffRoomWeightSD, diffTypeWeightSD);
    128                out.print("," + (sd == 0.0 ? "" : new DecimalFormat("0.0").format(sd)));
    129                double sr = instructor.countSameRooms(assignment, ta, diffTypeWeightSR);
    130                out.print("," + (sr == 0.0 ? "" : new DecimalFormat("0.0").format(sr)));
    131                double dl = instructor.differentLectures(assignment, ta);
    132                out.print("," + (dl == 0.0 ? "" : new DecimalFormat("0.0").format(dl)));
    133                double sh = instructor.share(assignment, ta);
    134                out.print("," + (sh == 0 ? "" : new DecimalFormat("0.0").format(sh / 12.0)));
    135            }
    136            out.println();
    137        }
    138        out.flush();
    139        out.close();
    140
    141        out = new PrintWriter(new File(outputDir, "solution-students.csv"));
    142        out.println("Student,Name,Preference,Not Available,Time Pref,Course Pref,Back-to-Back,Same-Days,Same-Room,Max Load,Assigned Load,Back-To-Back,Same-Days,Same-Room,Different Lecture,Overlap [h],1st Assignment,2nd Assignment, 3rd Assignment");
    143        for (Instructor instructor: getInstructors()) {
    144            out.print(instructor.getExternalId());
    145            out.print(",\"" + instructor.getName() + "\"");
    146            out.print("," + (instructor.getPreference() == 0 ? "" : instructor.getPreference()));
    147            out.print(",\"" + instructor.getAvailable() + "\"");
    148            String timePref = "";
    149            for (Preference<TimeLocation> p: instructor.getTimePreferences()) {
    150                if (!p.isProhibited()) {
    151                    if (!timePref.isEmpty()) timePref += ", ";
    152                    timePref += p.getTarget().getLongName(true).trim() + ": " + (p.isRequired() ? "R" : p.isProhibited() ? "P" : p.getPreference());
    153                }
    154            }
    155            out.print(",\"" + timePref + "\"");
    156            String coursePref = "";
    157            for (Preference<Course> p: instructor.getCoursePreferences()) {
    158                if (!coursePref.isEmpty()) coursePref += ", ";
    159                coursePref += p.getTarget().getCourseName() + ": " + (p.isRequired() ? "R" : p.isProhibited() ? "P" : p.getPreference());
    160            }
    161            out.print(",\"" + coursePref + "\"");
    162            out.print("," + (instructor.getBackToBackPreference() == 0 ? "" : instructor.getBackToBackPreference()));
    163            out.print("," + (instructor.getSameDaysPreference() == 0 ? "" : instructor.getSameDaysPreference()));
    164            out.print("," + (instructor.getSameRoomPreference() == 0 ? "" : instructor.getSameRoomPreference()));
    165            out.print("," + new DecimalFormat("0.0").format(instructor.getMaxLoad()));
    166
    167            Instructor.Context context = instructor.getContext(assignment);
    168            out.print("," + new DecimalFormat("0.0").format(context.getLoad()));
    169            out.print("," + (context.countBackToBackPercentage() == 0.0 ? "" : new DecimalFormat("0.0").format(100.0 * context.countBackToBackPercentage())));
    170            out.print("," + (context.countSameDaysPercentage() == 0.0 ? "" : new DecimalFormat("0.0").format(100.0 * context.countSameDaysPercentage())));
    171            out.print("," + (context.countSameRoomPercentage() == 0.0 ? "" : new DecimalFormat("0.0").format(100.0 * context.countSameRoomPercentage())));
    172            out.print("," + (context.countDifferentLectures() == 0.0 ? "" : new DecimalFormat("0.0").format(100.0 * context.countDifferentLectures())));
    173            out.print("," + (context.countTimeOverlaps() == 0.0 ? "" : new DecimalFormat("0.0").format(context.countTimeOverlaps() / 12.0)));
    174            for (TeachingAssignment ta : context.getAssignments()) {
    175                String sect = "";
    176                for (Iterator<Section> i = ta.variable().getSections().iterator(); i.hasNext(); ) {
    177                    Section section = i.next();
    178                    sect += section.getSectionName() + (section.getTime() == null ? "" : " " + section.getTime().getDayHeader() + " " + section.getTime().getStartTimeHeader(true));
    179                    if (i.hasNext()) sect += ", ";
    180                }
    181                out.print(",\"" + ta.variable().getCourse() + " " + sect + "\"");
    182            }
    183            out.println();
    184        }
    185        out.flush();
    186        out.close();
    187    }
    188
    189    /**
    190     * Save the problem and the resulting assignment
    191     * @param outputDir output directory
    192     * @param assignment final assignment
    193     */
    194    protected void save(File outputDir, Assignment<TeachingRequest.Variable, TeachingAssignment> assignment) {
    195        try {
    196            File outFile = new File(outputDir, "solution.xml");
    197            FileOutputStream fos = new FileOutputStream(outFile);
    198            try {
    199                (new XMLWriter(fos, OutputFormat.createPrettyPrint())).write(save(assignment));
    200                fos.flush();
    201            } finally {
    202                fos.close();
    203            }
    204        } catch (Exception e) {
    205            sLog.error("Failed to save solution: " + e.getMessage(), e);
    206        }
    207    }
    208
    209    /**
    210     * Run the problem
    211     */
    212    public void execute() {
    213        int nrSolvers = getProperties().getPropertyInt("Parallel.NrSolvers", 1);
    214        Solver<TeachingRequest.Variable, TeachingAssignment> solver = (nrSolvers == 1 ? new Solver<TeachingRequest.Variable, TeachingAssignment>(getProperties()) : new ParallelSolver<TeachingRequest.Variable, TeachingAssignment>(getProperties()));
    215
    216        Assignment<TeachingRequest.Variable, TeachingAssignment> assignment = (nrSolvers <= 1 ? new DefaultSingleAssignment<TeachingRequest.Variable, TeachingAssignment>() : new DefaultParallelAssignment<TeachingRequest.Variable, TeachingAssignment>());
    217        if (!load(new File(getProperties().getProperty("input", "input/solution.xml")), assignment))
    218            return;
    219
    220        solver.setInitalSolution(new Solution<TeachingRequest.Variable, TeachingAssignment>(this, assignment));
    221
    222        solver.currentSolution().addSolutionListener(new SolutionListener<TeachingRequest.Variable, TeachingAssignment>() {
    223            @Override
    224            public void solutionUpdated(Solution<TeachingRequest.Variable, TeachingAssignment> solution) {
    225            }
    226
    227            @Override
    228            public void getInfo(Solution<TeachingRequest.Variable, TeachingAssignment> solution, Map<String, String> info) {
    229            }
    230
    231            @Override
    232            public void getInfo(Solution<TeachingRequest.Variable, TeachingAssignment> solution, Map<String, String> info, Collection<TeachingRequest.Variable> variables) {
    233            }
    234
    235            @Override
    236            public void bestCleared(Solution<TeachingRequest.Variable, TeachingAssignment> solution) {
    237            }
    238
    239            @Override
    240            public void bestSaved(Solution<TeachingRequest.Variable, TeachingAssignment> solution) {
    241                Model<TeachingRequest.Variable, TeachingAssignment> m = solution.getModel();
    242                Assignment<TeachingRequest.Variable, TeachingAssignment> a = solution.getAssignment();
    243                System.out.println("**BEST[" + solution.getIteration() + "]** " + m.toString(a));
    244            }
    245
    246            @Override
    247            public void bestRestored(Solution<TeachingRequest.Variable, TeachingAssignment> solution) {
    248            }
    249        });
    250
    251        solver.start();
    252        try {
    253            solver.getSolverThread().join();
    254        } catch (InterruptedException e) {
    255        }
    256
    257        Solution<TeachingRequest.Variable, TeachingAssignment> solution = solver.lastSolution();
    258        solution.restoreBest();
    259
    260        sLog.info("Best solution found after " + solution.getBestTime() + " seconds (" + solution.getBestIteration() + " iterations).");
    261        sLog.info("Number of assigned variables is " + solution.getModel().assignedVariables(solution.getAssignment()).size());
    262        sLog.info("Total value of the solution is " + solution.getModel().getTotalValue(solution.getAssignment()));
    263
    264        sLog.info("Info: " + ToolBox.dict2string(solution.getExtendedInfo(), 2));
    265
    266        File outDir = new File(getProperties().getProperty("output", "output"));
    267        outDir.mkdirs();
    268
    269        save(outDir, solution.getAssignment());
    270
    271        try {
    272            generateReports(outDir, assignment);
    273        } catch (IOException e) {
    274            sLog.error("Failed to write reports: " + e.getMessage(), e);
    275        }
    276
    277        ConflictStatistics<TeachingRequest.Variable, TeachingAssignment> cbs = null;
    278        for (Extension<TeachingRequest.Variable, TeachingAssignment> extension : solver.getExtensions()) {
    279            if (ConflictStatistics.class.isInstance(extension)) {
    280                cbs = (ConflictStatistics<TeachingRequest.Variable, TeachingAssignment>) extension;
    281            }
    282        }
    283
    284        if (cbs != null) {
    285            PrintWriter out = null;
    286            try {
    287                out = new PrintWriter(new FileWriter(new File(outDir, "cbs.txt")));
    288                out.println(cbs.toString());
    289                out.flush(); out.close();
    290            } catch (IOException e) {
    291                sLog.error("Failed to write CBS: " + e.getMessage(), e);
    292            } finally {
    293                if (out != null) out.close();
    294            }
    295        }
    296    }
    297
    298    public static void main(String[] args) throws Exception {
    299        ToolBox.configureLogging();
    300
    301        DataProperties config = new DataProperties();
    302        if (System.getProperty("config") == null) {
    303            config.load(Test.class.getClass().getResourceAsStream("/org/cpsolver/instructor/default.properties"));
    304        } else {
    305            config.load(new FileInputStream(System.getProperty("config")));
    306        }
    307        config.putAll(System.getProperties());
    308
    309        new Test(config).execute();
    310    }
    311
    312}