public final class HardSoftDoubleScore extends AbstractScore<HardSoftDoubleScore> implements FeasibilityScore<HardSoftDoubleScore>
Score
is based on 2 levels of double constraints: hard and soft.
Hard constraints have priority over soft constraints.
Hard constraints determine feasibility.
WARNING: NOT RECOMMENDED TO USE DUE TO ROUNDING ERRORS THAT CAUSE SCORE CORRUPTION.
For example, this prints false: System.out.println((0.01 + 0.05) == (0.01 + 0.02 + 0.03));
Use HardSoftBigDecimalScore
instead.
This class is immutable.
Score
,
Serialized FormModifier and Type | Field and Description |
---|---|
static HardSoftDoubleScore |
ONE_HARD |
static HardSoftDoubleScore |
ONE_SOFT |
static HardSoftDoubleScore |
ZERO |
INIT_LABEL, initScore
Modifier and Type | Method and Description |
---|---|
HardSoftDoubleScore |
add(HardSoftDoubleScore addend)
Returns a Score whose value is (this + addend).
|
int |
compareTo(HardSoftDoubleScore other) |
HardSoftDoubleScore |
divide(double divisor)
Returns a Score whose value is (this / divisor).
|
boolean |
equals(Object o) |
double |
getHardScore()
The total of the broken negative hard constraints and fulfilled positive hard constraints.
|
double |
getSoftScore()
The total of the broken negative soft constraints and fulfilled positive soft constraints.
|
int |
hashCode() |
boolean |
isCompatibleArithmeticArgument(Score otherScore) |
boolean |
isFeasible()
A
PlanningSolution is feasible if it has no broken hard constraints
and Score.isSolutionInitialized() is true. |
HardSoftDoubleScore |
multiply(double multiplicand)
Returns a Score whose value is (this * multiplicand).
|
HardSoftDoubleScore |
negate()
Returns a Score whose value is (- this).
|
static HardSoftDoubleScore |
of(double hardScore,
double softScore) |
static HardSoftDoubleScore |
ofHard(double hardScore) |
static HardSoftDoubleScore |
ofSoft(double softScore) |
static HardSoftDoubleScore |
ofUninitialized(int initScore,
double hardScore,
double softScore) |
static HardSoftDoubleScore |
parseScore(String scoreString) |
HardSoftDoubleScore |
power(double exponent)
Returns a Score whose value is (this ^ exponent).
|
HardSoftDoubleScore |
subtract(HardSoftDoubleScore subtrahend)
Returns a Score whose value is (this - subtrahend).
|
HardSoftDoubleScore |
toInitializedScore()
For example
-7init/0hard/-8soft returns 0hard/-8soft . |
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() |
static HardSoftDoubleScore |
valueOf(double hardScore,
double softScore)
Deprecated.
in favor of
of(double, double) |
static HardSoftDoubleScore |
valueOfUninitialized(int initScore,
double hardScore,
double softScore)
Deprecated.
in favor of
ofUninitialized(int, double, double) |
HardSoftDoubleScore |
withInitScore(int newInitScore)
For example
0hard/-8soft with -7 returns -7init/0hard/-8soft . |
assertNoInitScore, buildScorePattern, buildShortString, getInitPrefix, getInitScore, isSolutionInitialized, parseInitScore, parseLevelAsBigDecimal, parseLevelAsDouble, parseLevelAsInt, parseLevelAsLong, parseScoreTokens
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
getInitScore, isSolutionInitialized
public static final HardSoftDoubleScore ZERO
public static final HardSoftDoubleScore ONE_HARD
public static final HardSoftDoubleScore ONE_SOFT
public static HardSoftDoubleScore parseScore(String scoreString)
public static HardSoftDoubleScore ofUninitialized(int initScore, double hardScore, double softScore)
@Deprecated public static HardSoftDoubleScore valueOfUninitialized(int initScore, double hardScore, double softScore)
ofUninitialized(int, double, double)
public static HardSoftDoubleScore of(double hardScore, double softScore)
@Deprecated public static HardSoftDoubleScore valueOf(double hardScore, double softScore)
of(double, double)
public static HardSoftDoubleScore ofHard(double hardScore)
public static HardSoftDoubleScore ofSoft(double softScore)
public double getHardScore()
public double getSoftScore()
In a normal score comparison, the soft score is irrelevant if the 2 scores don't have the same hard score.
public HardSoftDoubleScore toInitializedScore()
Score
-7init/0hard/-8soft
returns 0hard/-8soft
.toInitializedScore
in interface Score<HardSoftDoubleScore>
Score.getInitScore()
is 0
.public HardSoftDoubleScore withInitScore(int newInitScore)
Score
0hard/-8soft
with -7
returns -7init/0hard/-8soft
.withInitScore
in interface Score<HardSoftDoubleScore>
newInitScore
- always negative (except in statistical calculations), 0 if all planning variables are initializedScore.getInitScore()
is set to newInitScore
public boolean isFeasible()
FeasibilityScore
PlanningSolution
is feasible if it has no broken hard constraints
and Score.isSolutionInitialized()
is true.isFeasible
in interface FeasibilityScore<HardSoftDoubleScore>
Score.getInitScore()
is 0.public HardSoftDoubleScore add(HardSoftDoubleScore addend)
Score
add
in interface Score<HardSoftDoubleScore>
addend
- value to be added to this Scorepublic HardSoftDoubleScore subtract(HardSoftDoubleScore subtrahend)
Score
subtract
in interface Score<HardSoftDoubleScore>
subtrahend
- value to be subtracted from this Scorepublic HardSoftDoubleScore multiply(double multiplicand)
Score
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.
multiply
in interface Score<HardSoftDoubleScore>
multiplicand
- value to be multiplied by this Score.public HardSoftDoubleScore divide(double divisor)
Score
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.
divide
in interface Score<HardSoftDoubleScore>
divisor
- value by which this Score is to be dividedpublic HardSoftDoubleScore power(double exponent)
Score
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.
power
in interface Score<HardSoftDoubleScore>
exponent
- value by which this Score is to be poweredpublic HardSoftDoubleScore negate()
Score
negate
in interface Score<HardSoftDoubleScore>
public Number[] toLevelNumbers()
Score
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}
The level numbers do not contain the Score.getInitScore()
.
For example: -3init/-0hard/-7soft
also returns new int{-0, -7}
toLevelNumbers
in interface Score<HardSoftDoubleScore>
ScoreDefinition.fromLevelNumbers(int, Number[])
public int compareTo(HardSoftDoubleScore other)
compareTo
in interface Comparable<HardSoftDoubleScore>
public String toShortString()
Score
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.
toShortString
in interface Score<HardSoftDoubleScore>
public boolean isCompatibleArithmeticArgument(Score otherScore)
isCompatibleArithmeticArgument
in interface Score<HardSoftDoubleScore>
otherScore
- never nullScore.add(Score)
, Score.subtract(Score)
and Comparable.compareTo(Object)
.Copyright © 2006–2020 JBoss by Red Hat. All rights reserved.