Module org.cicirello.chips_n_salsa
Package org.cicirello.search.problems.scheduling

Class EarliestDueDate

java.lang.Object
org.cicirello.search.problems.scheduling.EarliestDueDate
All Implemented Interfaces:
Splittable<ConstructiveHeuristic<Permutation>>, ConstructiveHeuristic<Permutation>
public final class EarliestDueDate extends Object
This is an implementation of the earliest due date heuristic. If used deterministically, this heuristic always chooses the job that has the earliest due date. It is usually defined as: h(j) = 1 / d[j], where d[j] is the due date of job j. However, this class defines it as: h(j) = 1 / (1 + d[j]) in order to safely handle the case of a job due at the start of the schedule (i.e., d[j] = 0). This mild variation doesn't affect a schedule constructed deterministically with the heuristic, as the order of the jobs remains the same. This implementation bounds the minimum value of h at MIN_H in support of stochastic sampling search algorithms, which assume positive heuristic values (i.e., h=0 would cause such algorithms technical problems).

  • Field Details

    • MIN_H

      public static final double MIN_H
      The minimum heuristic value. If the heuristic value as calculated is lower than MIN_H, then MIN_H is used as the heuristic value. The reason is related to the primary purpose of the constructive heuristics in the library: heuristic guidance for stochastic sampling algorithms, which assume positive heuristic values (e.g., an h of 0 would be problematic).
      See Also:

  • Constructor Details

    • EarliestDueDate

      public EarliestDueDate(SingleMachineSchedulingProblem problem)
      Constructs an EarliestDueDate heuristic.
      Parameters:
      problem - The instance of a scheduling problem that is the target of the heuristic.
      Throws:
      IllegalArgumentException - if problem.hasDueDates() returns false.

  • Method Details

    • h

      public double h(Partial<Permutation> p, int element, IncrementalEvaluation<Permutation> incEval)
      Description copied from interface: ConstructiveHeuristic
      Heuristically evaluates the possible addition of an element to the end of a Partial. Higher evaluations imply that the element is a better choice for the next element to add. For example, if you evaluate two elements, x and y, with h, and h returns a higher value for y than for x, then this means that y is believed to be the better choice according to the heuristic. Implementations of this interface must ensure that h always returns a positive result. This is because stochastic sampling algorithms such as HBSS and VBSS assume that the constructive heuristic returns only positive values.
      Parameters:
      p - The current state of the Partial
      element - The element under consideration for adding to the Partial
      incEval - An IncrementalEvaluation of p. This method assumes that incEval is of the same runtime type as the object returned by ConstructiveHeuristic.createIncrementalEvaluation().
      Returns:
      The heuristic evaluation of the hypothetical addition of element to the end of p. The higher the evaluation, the more important the heuristic believes that element should be added next. The intention is to compare the value returned with the heuristic evaluations of other elements. Individual results in isolation are not necessarily meaningful.

    • getProblem

      public final Problem<Permutation> getProblem()
      Description copied from interface: ConstructiveHeuristic
      Gets a reference to the instance of the optimization problem that is the subject of this heuristic.
      Specified by:
      getProblem in interface ConstructiveHeuristic<Permutation>
      Returns:
      the instance of the optimization problem that is the subject of this heuristic.

    • createPartial

      public final Partial<Permutation> createPartial(int n)
      Description copied from interface: ConstructiveHeuristic
      Creates an empty Partial solution, which will be incrementally transformed into a complete solution of a specified length.
      Specified by:
      createPartial in interface ConstructiveHeuristic<Permutation>
      Parameters:
      n - the desired length of the final complete solution.
      Returns:
      an empty Partial solution

    • completeLength

      public final int completeLength()
      Description copied from interface: ConstructiveHeuristic
      Gets the required length of complete solutions to the problem instance for which this constructive heuristic is configured.
      Specified by:
      completeLength in interface ConstructiveHeuristic<Permutation>
      Returns:
      length of solutions to the problem instance for which this heuristic is configured