org.cpsolver.exam.criteria.additional

Class DistributionViolation

java.lang.Object

org.cpsolver.ifs.criteria.AbstractCriterion<Exam,ExamPlacement>

org.cpsolver.exam.criteria.ExamCriterion

org.cpsolver.exam.criteria.additional.DistributionViolation

All Implemented Interfaces:

CanHoldContext, HasAssignmentContext<Exam,ExamPlacement,AbstractCriterion.ValueContext>, Criterion<Exam,ExamPlacement>, ExtendedInfoProvider<Exam,ExamPlacement>, InfoProvider<Exam,ExamPlacement>, ModelListener<Exam,ExamPlacement>

public class DistributionViolation
extends ExamCriterion

Experimental criterion counting violations of hard distribution constraints.

To enable breaking of hard distribution constraints, set parameter Exam.SoftDistributions to a weight that should be inferred by a hard distribution constraint being broken.

Version:

ExamTT 1.3 (Examination Timetabling)
Copyright (C) 2008 - 2014 Tomáš Müller
muller@unitime.org
http://muller.unitime.org

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not see http://www.gnu.org/licenses/.

Author:

Tomáš Müller

Nested Class Summary

Nested classes/interfaces inherited from class org.cpsolver.ifs.criteria.AbstractCriterion

AbstractCriterion.ValueContext, AbstractCriterion.ValueUpdateType

Field Summary

Fields inherited from class org.cpsolver.ifs.criteria.AbstractCriterion

iBest, iDebug, iWeight, sDoubleFormat, sPercentFormat

Fields inherited from interface org.cpsolver.ifs.assignment.context.CanHoldContext

sMaxSize

Constructor Summary

Constructors

Constructor and Description
DistributionViolation()

Method Summary

Modifier and Type	Method and Description
protected double[]	computeBounds(Assignment<Exam,ExamPlacement> assignment) Compute bounds (bounds are being cached by default).
double	getPeriodValue(Assignment<Exam,ExamPlacement> assignment, ExamPlacement value) Return impact of this criterion on period assignment (if this criterion is based on period assignment).
double	getRoomValue(Assignment<Exam,ExamPlacement> assignment, ExamPlacement value) Return impact of this criterion on room assignment (if this criterion is based on room assignment).
double	getValue(Assignment<Exam,ExamPlacement> assignment, Collection<Exam> variables) Value of a part of the problem (given by the collection of variables)
double	getValue(Assignment<Exam,ExamPlacement> assignment, ExamPlacement value, Set<ExamPlacement> conflicts) Value of a proposed assignment (including hard conflicts)
String	getWeightName() Defines weight name (to be used to get the criterion weight from the configuration).
String	getXmlWeightName() Name of the weight parameter in the parameters section of the examination XML file.
boolean	isPeriodCriterion() True if this criterion is based on period assignment.
boolean	isRoomCriterion() True if this criterion is based on room assignment.
String	toString(Assignment<Exam,ExamPlacement> assignment) Simple text representation of the criterion and its value.

Methods inherited from class org.cpsolver.exam.criteria.ExamCriterion

getBounds, getInfo, getXmlParameters, setWeight, setXmlParameters

Methods inherited from class org.cpsolver.ifs.criteria.AbstractCriterion

afterAssigned, afterUnassigned, beforeAssigned, beforeUnassigned, bestRestored, bestSaved, clearCache, configure, constraintAdded, constraintRemoved, createAssignmentContext, getAbbreviation, getAssignmentContextReference, getBest, getBounds, getBounds, getBounds, getContext, getContext, getExtendedInfo, getInfo, getModel, getName, getPerc, getPercentage, getPercRev, getValue, getValue, getValue, getValueUpdateType, getWeight, getWeightDefault, getWeightedBest, getWeightedValue, getWeightedValue, getWeightedValue, getWeightedValue, getWeightedValue, getWeightedValue, inc, inc, init, setAssignmentContextReference, setModel, setValueUpdateType, variableAdded, variableRemoved

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DistributionViolation

public DistributionViolation()

Method Detail

getWeightName

public String getWeightName()

Description copied from class: AbstractCriterion

Defines weight name (to be used to get the criterion weight from the configuration).

Overrides:

getWeightName in class ExamCriterion

Returns:

name of the weight associated with this criterion

getXmlWeightName

public String getXmlWeightName()

Description copied from class: ExamCriterion

Name of the weight parameter in the parameters section of the examination XML file.

Overrides:

getXmlWeightName in class ExamCriterion

Returns:

name of the weight parameter in the XML

getValue

public double getValue(Assignment<Exam,ExamPlacement> assignment,
                       ExamPlacement value,
                       Set<ExamPlacement> conflicts)

Description copied from interface: Criterion

Value of a proposed assignment (including hard conflicts)

Parameters:

assignment - current assignment

value - given value

conflicts - values conflicting with the given value

Returns:

change in this criterion value when assigned

computeBounds

protected double[] computeBounds(Assignment<Exam,ExamPlacement> assignment)

Description copied from class: AbstractCriterion

Compute bounds (bounds are being cached by default).

Overrides:

computeBounds in class AbstractCriterion<Exam,ExamPlacement>

Parameters:

assignment - current assignment

Returns:

minimum and maximum of this criterion's value

isRoomCriterion

public boolean isRoomCriterion()

Description copied from class: ExamCriterion

True if this criterion is based on room assignment. Used by ExamPlacement.getRoomCost(Assignment).

Overrides:

isRoomCriterion in class ExamCriterion

Returns:

true if this criterion is based on room assignment

getRoomValue

public double getRoomValue(Assignment<Exam,ExamPlacement> assignment,
                           ExamPlacement value)

Description copied from class: ExamCriterion

Return impact of this criterion on room assignment (if this criterion is based on room assignment). Used by ExamPlacement.getRoomCost(Assignment).

Overrides:

getRoomValue in class ExamCriterion

Parameters:

assignment - current assignment

value - new assignment in question

Returns:

change in the room preference value

isPeriodCriterion

public boolean isPeriodCriterion()

Description copied from class: ExamCriterion

True if this criterion is based on period assignment. Used by ExamPlacement.getTimeCost(Assignment).

Overrides:

isPeriodCriterion in class ExamCriterion

Returns:

true if this criterion is based on period assignment

getPeriodValue

public double getPeriodValue(Assignment<Exam,ExamPlacement> assignment,
                             ExamPlacement value)

Description copied from class: ExamCriterion

Return impact of this criterion on period assignment (if this criterion is based on period assignment). Used by ExamPlacement.getTimeCost(Assignment).

Overrides:

getPeriodValue in class ExamCriterion

Parameters:

assignment - current assignment

value - new assignment in question

Returns:

change in the period preference value

getValue

public double getValue(Assignment<Exam,ExamPlacement> assignment,
                       Collection<Exam> variables)

Description copied from interface: Criterion

Value of a part of the problem (given by the collection of variables)

Specified by:

getValue in interface Criterion<Exam,ExamPlacement>

Overrides:

getValue in class AbstractCriterion<Exam,ExamPlacement>

Parameters:

assignment - current assignment

variables - list of problem variables

Returns:

value of the given variables

toString

public String toString(Assignment<Exam,ExamPlacement> assignment)

Description copied from class: AbstractCriterion

Simple text representation of the criterion and its value. E.g., X:x where X is the AbstractCriterion.getAbbreviation() and x is the current value AbstractCriterion.getValue(Assignment).

Specified by:

toString in interface Criterion<Exam,ExamPlacement>

Overrides:

toString in class AbstractCriterion<Exam,ExamPlacement>

Parameters:

assignment - current assignment

Returns:

short string representation (e.g., PP:95% for period preference)