Package ai.timefold.solver.core.api.score

Interface ScoreManager<Solution_,Score_ extends Score<Score_>>

Type Parameters:

Solution_ - the solution type, the class with the PlanningSolution annotation

Score_ - the actual score type

All Known Implementing Classes:

DefaultScoreManager

@Deprecated(forRemoval=true)
public interface ScoreManager<Solution_,Score_ extends Score<Score_>>

Deprecated, for removal: This API element is subject to removal in a future version.

Use SolutionManager instead.

A stateless service to help calculate Score, ConstraintMatchTotal, Indictment, etc.

To create a ScoreManager, use create(SolverFactory).

These methods are thread-safe unless explicitly stated otherwise.

Method Summary

Modifier and Type	Method	Description
static <Solution_,Score_ extends Score<Score_>> ScoreManager<Solution_,Score_>	create(SolverFactory<Solution_> solverFactory)	Deprecated, for removal: This API element is subject to removal in a future version. Uses a SolverFactory to build a ScoreManager.
static <Solution_,Score_ extends Score<Score_>,ProblemId_> ScoreManager<Solution_,Score_>	create(SolverManager<Solution_,ProblemId_> solverManager)	Deprecated, for removal: This API element is subject to removal in a future version. Uses a SolverManager to build a ScoreManager.
default ScoreExplanation<Solution_,Score_>	explain(Solution_ solution)	Deprecated, for removal: This API element is subject to removal in a future version. As defined by explain(Object), using SolutionUpdatePolicy.UPDATE_ALL.
ScoreExplanation<Solution_,Score_>	explain(Solution_ solution, SolutionUpdatePolicy solutionUpdatePolicy)	Deprecated, for removal: This API element is subject to removal in a future version. Calculates and retrieves ConstraintMatchTotals and Indictments necessary for describing the quality of a particular solution.
ScoreExplanation<Solution_,Score_>	explainScore(Solution_ solution)	Deprecated, for removal: This API element is subject to removal in a future version. Calculates and retrieves ConstraintMatchTotals and Indictments necessary for describing the quality of a particular solution.
String	getSummary(Solution_ solution)	Deprecated, for removal: This API element is subject to removal in a future version. Returns a diagnostic text that explains the solution through the ConstraintMatch API to identify which constraints or planning entities cause that score quality.
default Score_	update(Solution_ solution)	Deprecated, for removal: This API element is subject to removal in a future version. As defined by update(Object, SolutionUpdatePolicy), using SolutionUpdatePolicy.UPDATE_ALL.
Score_	update(Solution_ solution, SolutionUpdatePolicy solutionUpdatePolicy)	Deprecated, for removal: This API element is subject to removal in a future version. Updates the given solution according to the SolutionUpdatePolicy.
Score_	updateScore(Solution_ solution)	Deprecated, for removal: This API element is subject to removal in a future version. Calculates the Score of a PlanningSolution and updates its PlanningScore member.

Method Detail

create

static <Solution_,Score_ extends Score<Score_>> ScoreManager<Solution_,Score_> create(SolverFactory<Solution_> solverFactory)

Deprecated, for removal: This API element is subject to removal in a future version.

Uses a SolverFactory to build a ScoreManager.

Type Parameters:

Solution_ - the solution type, the class with the PlanningSolution annotation

Score_ - the actual score type

Parameters:

solverFactory - never null

Returns:

never null

create

static <Solution_,Score_ extends Score<Score_>,ProblemId_> ScoreManager<Solution_,Score_> create(SolverManager<Solution_,ProblemId_> solverManager)

Deprecated, for removal: This API element is subject to removal in a future version.

Uses a SolverManager to build a ScoreManager.

Type Parameters:

Solution_ - the solution type, the class with the PlanningSolution annotation

Score_ - the actual score type

ProblemId_ - the ID type of a submitted problem, such as Long or UUID

Parameters:

solverManager - never null

Returns:

never null

updateScore

Score_ updateScore(Solution_ solution)

Deprecated, for removal: This API element is subject to removal in a future version.

Calculates the Score of a PlanningSolution and updates its PlanningScore member.

Parameters:

solution - never null

getSummary

String getSummary(Solution_ solution)

Deprecated, for removal: This API element is subject to removal in a future version.

Returns a diagnostic text that explains the solution through the ConstraintMatch API to identify which constraints or planning entities cause that score quality. In case of an infeasible solution, this can help diagnose the cause of that.

Do not parse this string. Instead, to provide this information in a UI or a service, use explainScore(Object) to retrieve ScoreExplanation.getConstraintMatchTotalMap() and ScoreExplanation.getIndictmentMap() and convert those into a domain specific API.

Parameters:

solution - never null

Returns:

null if updateScore(Object) returns null with the same solution

Throws:

IllegalStateException - when constraint matching is disabled or not supported by the underlying score calculator, such as EasyScoreCalculator.

explainScore

ScoreExplanation<Solution_,Score_> explainScore(Solution_ solution)

Deprecated, for removal: This API element is subject to removal in a future version.

Calculates and retrieves ConstraintMatchTotals and Indictments necessary for describing the quality of a particular solution.

Parameters:

solution - never null

Returns:

never null

Throws:

IllegalStateException - when constraint matching is disabled or not supported by the underlying score calculator, such as EasyScoreCalculator.

update

default Score_ update(Solution_ solution)

Deprecated, for removal: This API element is subject to removal in a future version.

As defined by update(Object, SolutionUpdatePolicy), using SolutionUpdatePolicy.UPDATE_ALL.

update

Score_ update(Solution_ solution,
              SolutionUpdatePolicy solutionUpdatePolicy)

Deprecated, for removal: This API element is subject to removal in a future version.

Updates the given solution according to the SolutionUpdatePolicy.

Parameters:

solution - never null

solutionUpdatePolicy - never null; if unsure, pick SolutionUpdatePolicy.UPDATE_ALL

Returns:

possibly null if already null and SolutionUpdatePolicy didn't cause its update

See Also:

Description of individual policies with respect to performance trade-offs.

explain

default ScoreExplanation<Solution_,Score_> explain(Solution_ solution)

Deprecated, for removal: This API element is subject to removal in a future version.

As defined by explain(Object), using SolutionUpdatePolicy.UPDATE_ALL.

explain

ScoreExplanation<Solution_,Score_> explain(Solution_ solution,
                                                 SolutionUpdatePolicy solutionUpdatePolicy)

Deprecated, for removal: This API element is subject to removal in a future version.

Calculates and retrieves ConstraintMatchTotals and Indictments necessary for describing the quality of a particular solution.

Parameters:

solution - never null

solutionUpdatePolicy - never null; if unsure, pick SolutionUpdatePolicy.UPDATE_ALL

Returns:

never null

Throws:

IllegalStateException - when constraint matching is disabled or not supported by the underlying score calculator, such as EasyScoreCalculator.

See Also:

Description of individual policies with respect to performance trade-offs.