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

Class BendableBigDecimalScore

java.lang.Object

ai.timefold.solver.core.api.score.buildin.bendablebigdecimal.BendableBigDecimalScore

All Implemented Interfaces:

IBendableScore<BendableBigDecimalScore>, Score<BendableBigDecimalScore>, Serializable, Comparable<BendableBigDecimalScore>

@NullMarked
public final class BendableBigDecimalScore
extends Object
implements IBendableScore<BendableBigDecimalScore>

This Score is based on n levels of BigDecimal constraints. The number of levels is bendable at configuration time.

This class is immutable.

The hardLevelsSize() and softLevelsSize() must be the same as in the BendableScoreDefinition used.

See Also:

• Score
• Serialized Form

Method Summary

Modifier and Type	Method	Description
BendableBigDecimalScore	abs()	Returns a Score whose value is the absolute value of the score, i.e.
BendableBigDecimalScore	add(BendableBigDecimalScore addend)	Returns a Score whose value is (this + addend).
int	compareTo(BendableBigDecimalScore other)
BendableBigDecimalScore	divide(double divisor)	Returns a Score whose value is (this / divisor).
boolean	equals(Object o)
BigDecimal	getHardOrSoftScore(int index)	Deprecated, for removal: This API element is subject to removal in a future version. Use hardOrSoftScore(int) instead.
BigDecimal	getHardScore(int index)	Deprecated, for removal: This API element is subject to removal in a future version. Use hardScore(int) instead.
BigDecimal[]	getHardScores()	Deprecated, for removal: This API element is subject to removal in a future version. Use hardScores() instead.
BigDecimal	getSoftScore(int index)	Deprecated, for removal: This API element is subject to removal in a future version. Use softScore(int) instead.
BigDecimal[]	getSoftScores()	Deprecated, for removal: This API element is subject to removal in a future version. Use softScores() instead.
int	hardLevelsSize()	The sum of this and IBendableScore.softLevelsSize() equals IBendableScore.levelsSize().
BigDecimal	hardOrSoftScore(int index)
BigDecimal	hardScore(int index)
BigDecimal[]	hardScores()
int	hashCode()
boolean	isFeasible()	A PlanningSolution is feasible if it has no broken hard constraints.
BendableBigDecimalScore	multiply(double multiplicand)	Returns a Score whose value is (this * multiplicand).
BendableBigDecimalScore	negate()	Returns a Score whose value is (- this).
static BendableBigDecimalScore	of(BigDecimal[] hardScores, BigDecimal[] softScores)	Creates a new BendableBigDecimalScore.
static BendableBigDecimalScore	ofHard(int hardLevelsSize, int softLevelsSize, int hardLevel, BigDecimal hardScore)	Creates a new BendableBigDecimalScore.
static BendableBigDecimalScore	ofSoft(int hardLevelsSize, int softLevelsSize, int softLevel, BigDecimal softScore)	Creates a new BendableBigDecimalScore.
static BendableBigDecimalScore	ofUninitialized(int initScore, BigDecimal[] hardScores, BigDecimal[] softScores)	Deprecated, for removal: This API element is subject to removal in a future version. Use of(BigDecimal[], BigDecimal[]) instead.
static BendableBigDecimalScore	parseScore(String scoreString)
BendableBigDecimalScore	power(double exponent)	Returns a Score whose value is (this ^ exponent).
int	softLevelsSize()	The sum of IBendableScore.hardLevelsSize() and this equals IBendableScore.levelsSize().
BigDecimal	softScore(int index)
BigDecimal[]	softScores()
BendableBigDecimalScore	subtract(BendableBigDecimalScore subtrahend)	Returns a Score whose value is (this - subtrahend).
Number[]	toLevelNumbers()	Returns an array of numbers representing the Score.
String	toShortString()	Like Object.toString(), but trims score levels which have a zero weight.
String	toString()
void	validateCompatible(BendableBigDecimalScore other)
BendableBigDecimalScore	zero()	Returns a Score, all levels of which are zero.
static BendableBigDecimalScore	zero(int hardLevelsSize, int softLevelsSize)	Creates a new BendableBigDecimalScore.

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.IBendableScore

getHardLevelsSize, getLevelsSize, getSoftLevelsSize, levelsSize

Methods inherited from interface ai.timefold.solver.core.api.score.Score

getInitScore, initScore, isSolutionInitialized, isZero, toLevelDoubles, withInitScore

Method Details

parseScore

public static BendableBigDecimalScore parseScore(String scoreString)

ofUninitialized

@Deprecated(forRemoval=true,
            since="1.22.0")
public static BendableBigDecimalScore ofUninitialized(int initScore,
 BigDecimal[] hardScores,
 BigDecimal[] softScores)

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

Use of(BigDecimal[], BigDecimal[]) instead.

Returns:

init score is always zero

of

public static BendableBigDecimalScore of(BigDecimal[] hardScores,
 BigDecimal[] softScores)

Creates a new BendableBigDecimalScore.

Parameters:

hardScores - never change that array afterwards: it must be immutable

softScores - never change that array afterwards: it must be immutable

zero

public static BendableBigDecimalScore zero(int hardLevelsSize,
 int softLevelsSize)

Creates a new BendableBigDecimalScore.

Parameters:

hardLevelsSize - at least 0

softLevelsSize - at least 0

ofHard

public static BendableBigDecimalScore ofHard(int hardLevelsSize,
 int softLevelsSize,
 int hardLevel,
 BigDecimal hardScore)

Creates a new BendableBigDecimalScore.

Parameters:

hardLevelsSize - at least 0

softLevelsSize - at least 0

hardLevel - at least 0, less than hardLevelsSize

ofSoft

public static BendableBigDecimalScore ofSoft(int hardLevelsSize,
 int softLevelsSize,
 int softLevel,
 BigDecimal softScore)

Creates a new BendableBigDecimalScore.

Parameters:

hardLevelsSize - at least 0

softLevelsSize - at least 0

softLevel - at least 0, less than softLevelsSize

hardScores

public BigDecimal[] hardScores()

Returns:

array copy because this class is immutable

getHardScores

@Deprecated(forRemoval=true)
public BigDecimal[] getHardScores()

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

Use hardScores() instead.

As defined by hardScores().

softScores

public BigDecimal[] softScores()

Returns:

array copy because this class is immutable

getSoftScores

@Deprecated(forRemoval=true)
public BigDecimal[] getSoftScores()

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

Use softScores() instead.

As defined by softScores().

hardLevelsSize

public int hardLevelsSize()

Description copied from interface: IBendableScore

The sum of this and IBendableScore.softLevelsSize() equals IBendableScore.levelsSize().

Specified by:

hardLevelsSize in interface IBendableScore<BendableBigDecimalScore>

Returns:

>= 0 and < IBendableScore.levelsSize()

hardScore

public BigDecimal hardScore(int index)

Parameters:

index - 0 <= index < hardLevelsSize()

Returns:

higher is better

getHardScore

@Deprecated(forRemoval=true)
public BigDecimal getHardScore(int index)

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

Use hardScore(int) instead.

As defined by hardScore(int).

softLevelsSize

public int softLevelsSize()

Description copied from interface: IBendableScore

The sum of IBendableScore.hardLevelsSize() and this equals IBendableScore.levelsSize().

Specified by:

softLevelsSize in interface IBendableScore<BendableBigDecimalScore>

Returns:

>= 0 and < IBendableScore.levelsSize()

softScore

public BigDecimal softScore(int index)

Parameters:

index - 0 <= index < softLevelsSize()

Returns:

higher is better

getSoftScore

@Deprecated(forRemoval=true)
public BigDecimal getSoftScore(int index)

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

Use softScore(int) instead.

As defined by softScore(int).

hardOrSoftScore

public BigDecimal hardOrSoftScore(int index)

Parameters:

index - 0 <= index < IBendableScore.levelsSize()

Returns:

higher is better

getHardOrSoftScore

@Deprecated(forRemoval=true)
public BigDecimal getHardOrSoftScore(int index)

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

Use hardOrSoftScore(int) instead.

As defined by hardOrSoftScore(int).

isFeasible

public boolean isFeasible()

Description copied from interface: Score

A PlanningSolution is feasible if it has no broken hard constraints. Simple scores (SimpleScore, SimpleLongScore, SimpleBigDecimalScore) are always feasible.

Specified by:

isFeasible in interface Score<BendableBigDecimalScore>

Returns:

true if the hard score is 0 or higher.

add

public BendableBigDecimalScore add(BendableBigDecimalScore addend)

Description copied from interface: Score

Returns a Score whose value is (this + addend).

Specified by:

add in interface Score<BendableBigDecimalScore>

Parameters:

addend - value to be added to this Score

Returns:

this + addend

subtract

public BendableBigDecimalScore subtract(BendableBigDecimalScore subtrahend)

Description copied from interface: Score

Returns a Score whose value is (this - subtrahend).

Specified by:

subtract in interface Score<BendableBigDecimalScore>

Parameters:

subtrahend - value to be subtracted from this Score

Returns:

this - subtrahend, rounded as necessary

multiply

public BendableBigDecimalScore multiply(double multiplicand)

Description copied from interface: Score

Returns a Score whose value is (this * multiplicand). When rounding is needed, it should be floored (as defined by Math.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:

multiply in interface Score<BendableBigDecimalScore>

Parameters:

multiplicand - value to be multiplied by this Score.

Returns:

this * multiplicand

divide

public BendableBigDecimalScore divide(double divisor)

Description copied from interface: Score

Returns a Score whose value is (this / divisor). When rounding is needed, it should be floored (as defined by Math.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:

divide in interface Score<BendableBigDecimalScore>

Parameters:

divisor - value by which this Score is to be divided

Returns:

this / divisor

power

public BendableBigDecimalScore power(double exponent)

Description copied from interface: Score

Returns a Score whose value is (this ^ exponent). When rounding is needed, it should be floored (as defined by Math.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:

power in interface Score<BendableBigDecimalScore>

Parameters:

exponent - value by which this Score is to be powered

Returns:

this ^ exponent

negate

public BendableBigDecimalScore negate()

Description copied from interface: Score

Returns a Score whose value is (- this).

Specified by:

negate in interface Score<BendableBigDecimalScore>

Returns:

- this

abs

public BendableBigDecimalScore abs()

Description copied from interface: Score

Returns a Score whose value is the absolute value of the score, i.e. |this|.

Specified by:

abs in interface Score<BendableBigDecimalScore>

zero

public BendableBigDecimalScore zero()

Description copied from interface: Score

Returns a Score, all levels of which are zero.

Specified by:

zero in interface Score<BendableBigDecimalScore>

toLevelNumbers

public Number[] toLevelNumbers()

Description copied from interface: Score

Returns 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 specific Score implementation.

For example: -0hard/-7soft returns new int{-0, -7}

Specified by:

toLevelNumbers in interface Score<BendableBigDecimalScore>

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(BendableBigDecimalScore other)

Specified by:

compareTo in interface Comparable<BendableBigDecimalScore>

toShortString

public String toShortString()

Description copied from interface: Score

Like Object.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:

toShortString in interface Score<BendableBigDecimalScore>

toString

public String toString()

Overrides:

toString in class Object

validateCompatible

public void validateCompatible(BendableBigDecimalScore other)