Package ai.timefold.solver.core.impl.score.buildin

Class BendableLongScoreDefinition

java.lang.Object

ai.timefold.solver.core.impl.score.definition.AbstractScoreDefinition<Score_>

ai.timefold.solver.core.impl.score.definition.AbstractBendableScoreDefinition<BendableLongScore>

ai.timefold.solver.core.impl.score.buildin.BendableLongScoreDefinition

All Implemented Interfaces:

ScoreDefinition<BendableLongScore>

public class BendableLongScoreDefinition
extends AbstractBendableScoreDefinition<BendableLongScore>

Field Summary

Fields inherited from class ai.timefold.solver.core.impl.score.definition.AbstractBendableScoreDefinition

hardLevelsSize, softLevelsSize

Constructor Summary

Constructors

Constructor	Description
BendableLongScoreDefinition(int hardLevelsSize, int softLevelsSize)

Method Summary

Modifier and Type	Method	Description
BendableLongScore	buildOptimisticBound(InitializingScoreTrend initializingScoreTrend, BendableLongScore score)	Builds a Score which is equal or better than any other Score with more variables initialized (while the already variables don't change).
BendableLongScore	buildPessimisticBound(InitializingScoreTrend initializingScoreTrend, BendableLongScore score)	Builds a Score which is equal or worse than any other Score with more variables initialized (while the already variables don't change).
BendableLongScore	createScore(long... scores)
BendableLongScore	createScoreUninitialized(int initScore, long... scores)
BendableLongScore	divideBySanitizedDivisor(BendableLongScore dividend, BendableLongScore divisor)	Return Score whose every level is the result of dividing the matching levels in this and the divisor.
BendableLongScore	fromLevelNumbers(int initScore, Number[] levelNumbers)	The opposite of Score.toLevelNumbers().
Class<?>	getNumericType()	Return the type of number that the score implementation operates on.
BendableLongScore	getOneSoftestScore()	The score that represents the softest possible one.
Class<BendableLongScore>	getScoreClass()	Returns the Class of the actual Score implementation.
BendableLongScore	getZeroScore()	The score that represents zero.
BendableLongScore	parseScore(String scoreString)	Parses the String and returns a Score.

Methods inherited from class ai.timefold.solver.core.impl.score.definition.AbstractBendableScoreDefinition

generateLevelLabels, getFeasibleLevelsSize, getHardLevelsSize, getLevelsSize, getSoftLevelsSize, isCompatibleArithmeticArgument

Methods inherited from class ai.timefold.solver.core.impl.score.definition.AbstractScoreDefinition

divide, divide, divide, divide, formatScore, getInitLabel, getLevelLabels, sanitize, sanitize, sanitize, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface ai.timefold.solver.core.impl.score.definition.ScoreDefinition

formatScore, getInitLabel, getLevelLabels, isNegativeOrZero, isPositiveOrZero

Constructor Detail

BendableLongScoreDefinition

public BendableLongScoreDefinition(int hardLevelsSize,
                                   int softLevelsSize)

Method Detail

getScoreClass

public Class<BendableLongScore> getScoreClass()

Description copied from interface: ScoreDefinition

Returns the Class of the actual Score implementation. For example: returns HardSoftScore.class on HardSoftScoreDefinition.

Returns:

never null

getZeroScore

public BendableLongScore getZeroScore()

Description copied from interface: ScoreDefinition

The score that represents zero.

Returns:

never null

getOneSoftestScore

public final BendableLongScore getOneSoftestScore()

Description copied from interface: ScoreDefinition

The score that represents the softest possible one.

Returns:

never null

parseScore

public BendableLongScore parseScore(String scoreString)

Description copied from interface: ScoreDefinition

Parses the String and returns a Score.

Parameters:

scoreString - never null

Returns:

never null

See Also:

ScoreDefinition.formatScore(Score)

fromLevelNumbers

public BendableLongScore fromLevelNumbers(int initScore,
                                          Number[] levelNumbers)

Description copied from interface: ScoreDefinition

The opposite of Score.toLevelNumbers().

Parameters:

initScore - <= 0, managed by Timefold, needed as a parameter in the Score's creation method, see Score.initScore()

levelNumbers - never null

Returns:

never null

createScore

public BendableLongScore createScore(long... scores)

createScoreUninitialized

public BendableLongScore createScoreUninitialized(int initScore,
                                                  long... scores)

buildOptimisticBound

public BendableLongScore buildOptimisticBound(InitializingScoreTrend initializingScoreTrend,
                                              BendableLongScore score)

Description copied from interface: ScoreDefinition

Builds a Score which is equal or better than any other Score with more variables initialized (while the already variables don't change).

Parameters:

initializingScoreTrend - never null, with InitializingScoreTrend.getLevelsSize() equal to ScoreDefinition.getLevelsSize().

score - never null, with Score.initScore() 0.

Returns:

never null

buildPessimisticBound

public BendableLongScore buildPessimisticBound(InitializingScoreTrend initializingScoreTrend,
                                               BendableLongScore score)

Description copied from interface: ScoreDefinition

Builds a Score which is equal or worse than any other Score with more variables initialized (while the already variables don't change).

Parameters:

initializingScoreTrend - never null, with InitializingScoreTrend.getLevelsSize() equal to ScoreDefinition.getLevelsSize().

score - never null, with Score.initScore() 0

Returns:

never null

divideBySanitizedDivisor

public BendableLongScore divideBySanitizedDivisor(BendableLongScore dividend,
                                                  BendableLongScore divisor)

Description copied from interface: ScoreDefinition

Return Score whose every level is the result of dividing the matching levels in this and the divisor. When rounding is needed, it is floored (as defined by Math.floor(double)).

If any of the levels in the divisor are equal to zero, the method behaves as if they were equal to one instead.

divisor - value by which this Score is to be divided

Returns:

this / divisor

getNumericType

public Class<?> getNumericType()

Description copied from interface: ScoreDefinition

Return the type of number that the score implementation operates on. Examples:

• int.class for SimpleScore
• BigDecimal.class for SimpleBigDecimalScore

Returns:

never null