Class SimpleBigDecimalScore
- java.lang.Object
-
- ai.timefold.solver.core.api.score.buildin.simplebigdecimal.SimpleBigDecimalScore
-
- All Implemented Interfaces:
Score<SimpleBigDecimalScore>,Serializable,Comparable<SimpleBigDecimalScore>
public final class SimpleBigDecimalScore extends Object implements Score<SimpleBigDecimalScore>
- See Also:
Score, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static SimpleBigDecimalScoreONEstatic SimpleBigDecimalScoreZERO
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description SimpleBigDecimalScoreabs()Returns a Score whose value is the absolute value of the score, i.e.SimpleBigDecimalScoreadd(SimpleBigDecimalScore addend)Returns a Score whose value is (this + addend).intcompareTo(SimpleBigDecimalScore other)SimpleBigDecimalScoredivide(double divisor)Returns a Score whose value is (this / divisor).booleanequals(Object o)BigDecimalgetScore()Deprecated, for removal: This API element is subject to removal in a future version.Usescore()instead.inthashCode()intinitScore()The init score is the negative of the number of uninitialized genuine planning variables.booleanisFeasible()APlanningSolutionis feasible if it has no broken hard constraints andScore.isSolutionInitialized()is true.SimpleBigDecimalScoremultiply(double multiplicand)Returns a Score whose value is (this * multiplicand).static SimpleBigDecimalScoreof(BigDecimal score)static SimpleBigDecimalScoreofUninitialized(int initScore, BigDecimal score)static SimpleBigDecimalScoreparseScore(String scoreString)SimpleBigDecimalScorepower(double exponent)Returns a Score whose value is (this ^ exponent).BigDecimalscore()The total of the broken negative constraints and fulfilled positive constraints.SimpleBigDecimalScoresubtract(SimpleBigDecimalScore subtrahend)Returns a Score whose value is (this - subtrahend).Number[]toLevelNumbers()Returns an array of numbers representing the Score.StringtoShortString()LikeObject.toString(), but trims score levels which have a zero weight.StringtoString()SimpleBigDecimalScorewithInitScore(int newInitScore)For example0hard/-8softwith-7returns-7init/0hard/-8soft.SimpleBigDecimalScorezero()Returns a Score, all levels of which are zero.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface ai.timefold.solver.core.api.score.Score
getInitScore, isSolutionInitialized, isZero, negate, toLevelDoubles
-
-
-
-
Field Detail
-
ZERO
public static final SimpleBigDecimalScore ZERO
-
ONE
public static final SimpleBigDecimalScore ONE
-
-
Method Detail
-
parseScore
public static SimpleBigDecimalScore parseScore(String scoreString)
-
ofUninitialized
public static SimpleBigDecimalScore ofUninitialized(int initScore, BigDecimal score)
-
of
public static SimpleBigDecimalScore of(BigDecimal score)
-
initScore
public int initScore()
Description copied from interface:ScoreThe init score is the negative of the number of uninitialized genuine planning variables. If it's 0 (which it usually is), thePlanningSolutionis fully initialized and the score'sObject.toString()does not mention it.During
Comparable.compareTo(Object), it's even more important than the hard score: if you don't want this behaviour, read about overconstrained planning in the reference manual.- Specified by:
initScorein interfaceScore<SimpleBigDecimalScore>- Returns:
- higher is better, always negative (except in statistical calculations), 0 if all planning variables are initialized
-
score
public BigDecimal score()
The total of the broken negative constraints and fulfilled positive constraints. Their weight is included in the total. The score is usually a negative number because most use cases only have negative constraints.- Returns:
- higher is better, usually negative, 0 if no constraints are broken/fulfilled
-
getScore
@Deprecated(forRemoval=true) public BigDecimal getScore()
Deprecated, for removal: This API element is subject to removal in a future version.Usescore()instead.As defined byscore().
-
withInitScore
public SimpleBigDecimalScore withInitScore(int newInitScore)
Description copied from interface:ScoreFor example0hard/-8softwith-7returns-7init/0hard/-8soft.- Specified by:
withInitScorein interfaceScore<SimpleBigDecimalScore>- Parameters:
newInitScore- always negative (except in statistical calculations), 0 if all planning variables are initialized- Returns:
- equals score except that
Score.initScore()is set tonewInitScore
-
add
public SimpleBigDecimalScore add(SimpleBigDecimalScore addend)
Description copied from interface:ScoreReturns a Score whose value is (this + addend).- Specified by:
addin interfaceScore<SimpleBigDecimalScore>- Parameters:
addend- value to be added to this Score- Returns:
- this + addend
-
subtract
public SimpleBigDecimalScore subtract(SimpleBigDecimalScore subtrahend)
Description copied from interface:ScoreReturns a Score whose value is (this - subtrahend).- Specified by:
subtractin interfaceScore<SimpleBigDecimalScore>- Parameters:
subtrahend- value to be subtracted from this Score- Returns:
- this - subtrahend, rounded as necessary
-
multiply
public SimpleBigDecimalScore multiply(double multiplicand)
Description copied from interface:ScoreReturns a Score whose value is (this * multiplicand). When rounding is needed, it should be floored (as defined byMath.floor(double)).If the implementation has a scale/precision, then the unspecified scale/precision of the double multiplicand should have no impact on the returned scale/precision.
- Specified by:
multiplyin interfaceScore<SimpleBigDecimalScore>- Parameters:
multiplicand- value to be multiplied by this Score.- Returns:
- this * multiplicand
-
divide
public SimpleBigDecimalScore divide(double divisor)
Description copied from interface:ScoreReturns a Score whose value is (this / divisor). When rounding is needed, it should be floored (as defined byMath.floor(double)).If the implementation has a scale/precision, then the unspecified scale/precision of the double divisor should have no impact on the returned scale/precision.
- Specified by:
dividein interfaceScore<SimpleBigDecimalScore>- Parameters:
divisor- value by which this Score is to be divided- Returns:
- this / divisor
-
power
public SimpleBigDecimalScore power(double exponent)
Description copied from interface:ScoreReturns a Score whose value is (this ^ exponent). When rounding is needed, it should be floored (as defined byMath.floor(double)).If the implementation has a scale/precision, then the unspecified scale/precision of the double exponent should have no impact on the returned scale/precision.
- Specified by:
powerin interfaceScore<SimpleBigDecimalScore>- Parameters:
exponent- value by which this Score is to be powered- Returns:
- this ^ exponent
-
abs
public SimpleBigDecimalScore abs()
Description copied from interface:ScoreReturns a Score whose value is the absolute value of the score, i.e. |this|.- Specified by:
absin interfaceScore<SimpleBigDecimalScore>- Returns:
- never null
-
zero
public SimpleBigDecimalScore zero()
Description copied from interface:ScoreReturns a Score, all levels of which are zero.- Specified by:
zeroin interfaceScore<SimpleBigDecimalScore>- Returns:
- never null
-
isFeasible
public boolean isFeasible()
Description copied from interface:ScoreAPlanningSolutionis feasible if it has no broken hard constraints andScore.isSolutionInitialized()is true. Simple scores (SimpleScore,SimpleLongScore,SimpleBigDecimalScore) are always feasible, if theirScore.initScore()is 0.- Specified by:
isFeasiblein interfaceScore<SimpleBigDecimalScore>- Returns:
- true if the hard score is 0 or higher and the
Score.initScore()is 0.
-
toLevelNumbers
public Number[] toLevelNumbers()
Description copied from interface:ScoreReturns an array of numbers representing the Score. Each number represents 1 score level. A greater score level uses a lower array index than a lesser score level.When rounding is needed, each rounding should be floored (as defined by
Math.floor(double)). The length of the returned array must be stable for a specificScoreimplementation.For example:
-0hard/-7softreturnsnew int{-0, -7}The level numbers do not contain the
Score.initScore(). For example:-3init/-0hard/-7softalso returnsnew int{-0, -7}- Specified by:
toLevelNumbersin interfaceScore<SimpleBigDecimalScore>- Returns:
- never null
-
compareTo
public int compareTo(SimpleBigDecimalScore other)
- Specified by:
compareToin interfaceComparable<SimpleBigDecimalScore>
-
toShortString
public String toShortString()
Description copied from interface:ScoreLikeObject.toString(), but trims score levels which have a zero weight. For example 0hard/-258soft returns -258soft.Do not use this format to persist information as text, use
Object.toString()instead, so it can be parsed reliably.- Specified by:
toShortStringin interfaceScore<SimpleBigDecimalScore>- Returns:
- never null
-
-